Profanity Illustration

User Guide

File Locations


Base Directories

The XDG base directory specification is used for base configuration and data directories.

The environment variables $XDG_CONFIG_HOME and $XDG_DATA_HOME will be used and a directory named profanity will be created in each.

As per the specification, if $XDG_CONFIG_HOME is not present or unset, $HOME/.config will be used. If $XDG_DATA_HOME is not present or unset, $HOME/.local/share will be used.

For the rest of this document the following names will be used:



Configuration File

The main configuration file for profanity is stored at:


Profanity Log File

The Profanity log is at:


Chat Logs Directory

If chat logging is enabled, chat logs will be stored in the following directory:


A directory exists per account, and within each of these directories is a directory per contact containing dated logs.

If chat room logging is also enabled, a rooms directory will also be within the account directory.

User Defined Themes Directory

User defined theme files are stored in the following directory:


Accounts file

User accounts are stored in the following file:



Assuming a user called eddie, and default values for $XDG_CONFIG_HOME and $XDG_DATA_HOME are used, the following example shows where files are stored:

/home/eddie/.config/profanity/profrc Configuration file
/home/eddie/.config/profanity/themes/ Theme files
/home/eddie/.local/share/profanity/logs/profanity.log Main log file
/home/eddie/.local/share/profanity/chatlogs/ Chat logs
/home/eddie/.local/share/profanity/accounts Accounts file