Guide: Settings and other files

Files / Directory structure | Uninstall | Backup

Learn what directories and files Chatty creates/uses.

Files / Directory structure

Settings Directory

The settings directory by default is in your user home directory in a subdirectory called .chatty. You can enter the command /dir to display and /openDir to open the settings directory that Chatty currently uses.

If you want to replace, copy or delete setting files in any way, make sure to close Chatty before doing so (the files may be overwritten at any time while Chatty is running).

You can change the settings directory via different ways:

You can use launch options by adding them to a shortcut or (if you're using the standalone version) by adding it to the Chatty.cfg.

<settings directory>
|-- backup [Directory]
|   |- auto_* Automatic setting backups
|   |- manual_* Manual setting backups
|   |- session_* Session setting backups
|   |- backup_* Old backups (no longer used)
|-- cache [Directory] (customize)
|   |- <cache files> Cached emotes/image files
|-- debuglogs [Directory] (customize)
|   |- <debug files> See Debug Log
|-- exported [Directory] (customize)
|   |- stream_highlights.txt Recorded stream highlights
|   |- <exported text> /exportText command output
|-- logs [Directory] (customize)
|   |- <log files> Chat log files
|- login [Settings] Your login data (keep this secure)
|- settings [Settings] Main Settings File
|- addressbook [Settings] Addressbook entries [deprecated]
|- favoritesAndHistory [Settings] Channel History/Favorites [deprecated]
|- statusPresets [Settings] Stream Title/Game presets (Admin Dialog) [deprecated]

Note: favoritesAndHistory and statusPresets have been merged into settings as of v0.9.1. The addressbook has been merged into settings as of v0.12 (but may still be written to under some circumstances).

Working Directory

This directory is associated with Chatty when you start it. This is usually the directory the program is started from. When using the standalone (Chatty.exe) this is always set to the "app" directory of the standalone bundle. In some cases, depending on how Chatty is started, this may point to a different directory.

You can change the Working Directory by specifying it when you start Chatty, usually by creating a shortcut and changing what is defined under Run in in the shortcut settings. Make sure this points to the same folder the Chatty.jar is in (or something else if you want to customize it, just make sure the files you need are there).

Use the command /wdir to display and /openWdir to open the Working Directory.

<working directory>
|-- sounds [Folder] Sound files for Notifications (customize)
|   |- <sound>.wav .wav files
|-- img [Folder] Image files for Custom Badges (customize)
|   |- <various images> .png files

JAR Location

This is where the Chatty.jar is located and is used for loading libraries that Chatty uses.


Some folders can be changed:

Changing folders usually requires a restart of Chatty to be properly applied.


To remove Chatty from your computer:


Setting backups can provide a way to recover your settings if the setting weren't written or loaded properly or to reset your settings to a previous state.

Chatty can perform these types of backups:

Note: The login settings file is not backed up. For a safer backup, make your own backups on a different device.

To load an automatic backup go to "Main - Settings - Main - View Backups" and follow the instructions. If you want to restore a manual backup you made of the settings file, simply overwrite the current settings file while Chatty is not running.

You can view the backup directory directly by entering /openBackupDir or /showBackupDir into the Chatty inputbox. Note that files in the backup directory starting with auto_ may be automatically deleted.