AdiIRC

{{>toc}}

h1. Config files

Config files are stored in the AdiIRC folder if the user running AdiIRC.exe have write access to that folder, otherwise, they are stored in <notextile>%LOCALAPPDATA%\AdiIRC</notextile> (C:\Users\USERNAME\AppData\Local\AdiIRC).

AdiIRC.exe -ConfigFolder <path> command line argument can be used to set a custom config folder on startup.

Typing [[/echo|//echo]] -ag [[$adiircdir]] will print the path to the config folder.

Typing [[/paths]] -o will open the config folder.

Menubar -> Tools -> Config files - will also open the config folder.

config.ini - Most AdiIRC [[Options Dialog|options]].

commands.ini - Default custom [[/alias|aliases]].

menus.ini - Custom [[Scripting_Menus|menu items]].

networks.ini - New [[Serverlist]] options.

servers.ini - Old Serverlist options.

vars.ini - [[/set|Global scripting variables]] which are saved across sessions.

nicklistbuttons.ini - Custom Nicklist buttons. 

users.ini - Custom user access levels.

addrbk.ini - [[/abook|Address book users]].

control.ini - Auto-op/Auto-voice settings.

nowplaying.txt - Random now playing items.

quits.txt - Random quit messages.

slaps.txt - Random slaps.

AdiIRCAPI.dll - The "plugin API":/boards/4/topics/146 file.

AdiIRCAPIv2.dll - The "plugin API":/boards/4/topics/14 API version 2 file.

h1. Deprecated files

These are automatically added to config.ini and removed when upgrading from an older to newer version of AdiIRC.

positions.ini - Was used to store windows positions.

away.ini - Was used to store away options.

ignore.ini - Was used to store ignore options.

h1. Config folders

Various folders are created for storing data, most of these can be changed in the options dialog.

\Cache\Favicons - Stores favicons if [[Options_Dialog|Options]] -> [[Icons_Options|Icons]] -> [[Icons_Options#Get-favicons-from-server-website|Get favicons from server website]] is enabled.

\Cache\History - Stores [[Editbox Control|Editbox]] history if [[Options_Dialog|Options]] -> [[Messages_Options|Messages]] -> [[Messages_Options#Save-and-restore-history|Save and restore history]] is enabled.

\Cache\Monitor - Stores [[Monitor Panels]] data if any [[Options_Dialog|Options]] -> [[Monitor_Options|Monitor]] -> Save and restore option 

is enabled.

\Cache\Preview - Stores Inline Images preview if enabled in [[Options_Dialog|Options]] -> [[Inline Images Options|Inline Images]].

\Dict - Store any installed [[Spellcheck|spellcheck dictionaries]].

\Download - Stores incoming DCC downloads set in [[Options_Dialog|Options]] -> [[DCC_Options|DCC]] -> [[DCC_Options#Default-download-dir|Default download dir]].  (See also [[$getdir]])

\Logs - Stores all log files set in [[Options_Dialog|Options]] -> [[Logging_Options|Logging]] -> [[Logging_Options#LogFolder|Log Folder]]. (See also [[$logdir]])

\Scripts - Stores all scripts. (See also [[$scriptdir]])

\Themes - Stores all installed [[Themes_Dialog|themes]].

\Plugins - Stores all installed [[Plugins_Dialog|plugins]].

h2. Manually editing Config Files

Most config files can be manually edited using a text editor but the files must always be opened and saved using "UTF-8":https://en.wikipedia.org/wiki/UTF-8 encoding.

When editing config.ini while AdiIRC is running, it can be reloaded by typing the [[/setoption]] command with no parameters, other config files usually requires a AdiIRC restart.