AdiIRC

{{>toc}}

h1. Logging Options

_See also [[/log]]._

h2. Log Channels

When enabled, logs all channel windows.

h2. Log Private Chat

When enabled, logs all private windows.

h2. Log Servers

When enabled, logs all server windows.

h2. Log hidden events

When enabled, logs all events hidden by [[Events Options]].

h2. Edit logs in Default Editor

Opens log files for editing in the default editor.

h2. Edit logs in Custom Editor

Opens log files for editing in the specified custom editor.

h2. Make separate folder for each server

When enabled, will create a sub folder with the network name and save the logfile there.

h2. Strip mIRC tags

When enabled, Removes all [[Formatting_Text|control codes]] from the message before logging.

h2. Use Timestamp

When enabled, adds a timestamp with the specified Timeformat to the message before logging.

h2. Use server-time when available

If enabled, the logged line will be logged with the timestamp retrieved from the server when the "IRCv3 server-time":https://ircv3.net/specs/extensions/server-time-3.2.html cap is used, otherwise the current localtime is used.

h2. Use line colors

When enabled, the line colors used for the message will be added to the log.

h2. Log Nickcolumn character

When enabled, the Nickcolumn character used to separate timestamp/nick from the message will be saved and correctly restored.

h2. Log link character

When enabled, the link character used to style links in a message will be saved and correctly restored.

h2. Log session start/close

When enabled, session start and close date will be logged to the logfile.

h2. Lock files

When enabled, all logfiles in use are locked until the associated window is closed.

h2. LogFolder

The Folder to save the log files.

h2. Timeformat

The time format to use when Use Timestamp is enabled.

Click the Show date/time variables link to see available variables, these variables ONLY work for the timestamp, not for the filename.

h2. FileName

The filename to use for logs,

Variables available:

$network - The network name associated with the log window.

$channel - The channel/query name associated with the log window.

$date - Current date in the yyyymmdd format.

$mdate - Current date in the yyyymm format.

_Date/time/other variables are not available to keep the filenames predictable for restore logs._

h2. Rotated filename

The filename to use for logs when *Split log files at [X]* is enabled and the log is to be rotated,

Variables available:

$network - The network name associated with the log window.

$channel - The channel/query name associated with the log window.

$date - Current date in the yyyymmdd format.

$count - A incremental number based on number of files with the same filename minus the $count number.

_Date/time/other variables are not available to keep the filenames predictable for restore logs._

h2. Restore last [X] messages in private windows

If enabled, the last [X] messages from the log files will be restored when a private window is opened.

h2. Restore last [X] messages in channel windows

If enabled, the last [X] messages from the log files will be restored when a channel window is opened.

h2. Separate logs

When enabled, save the logfiles in a subfolder based on the selected interval.

Daily = YYYY-MM-DD.

Weekly = YYYY-WW.

Monthly = YYYY-MM.

Yearly = YYYY.

h2. Trim logs at [X] kb

When enabled and a log file becomes bigger than [X] kilobytes, it will be trimmed to fit the specified size.

_Cannot be used with split log files._

h2. Split log files at [X] kb

When enabled and a log file becomes bigger than [X] kilobytes, it will be renamed to *Rotated filename* and a new log created.

_Cannot be used with trim log files._

h2. Remove log files older than [x] days

When enabled, all log files not modified since [x] days ago will be removed when AdiIRC exits.

h2. Disable logging for channel/private windows

Channels and users in this list will not be logged.

_Per server settings can be added using network:#channel syntax._

_These windows ignores/overrides the "Log channels/servers/Log privatechat" option._

_Can also be toggled by right-clicking the window in [[Switchbar Control|Switchbar]]/[[Treebar Control|Treebar]] -> Logging._

h2. Always log channel/private windows

Channels and users in this list will always be logged, regardless of the *Log Channels* and *Log Privatechat* options.

_Per server settings can be added using network:#channel syntax._

_These windows ignores/overrides the "Log channels/servers/Log privatechat" option._

_Can also be toggled by right-clicking the window in [[Switchbar Control|Switchbar]]/[[Treebar Control|Treebar]] -> Logging._

h1. Log Events

_If Log hidden events is enabled, these options are ignored._

Default = Log event if logging is enabled for the channel.

On = Log event in channels even if logging for the channel is disabled.

Off = Never log event in channels even if logging for the channel is enabled.

h2. Messages

Log regular messages.

h2. Joins

Log when a user joins a channel.

h2. Modes

Log when a user changes channel modes.

h2. Parts

Log when a user leaves a channel.

h2. Topics

Log when a user changes a channel topic.

h2. Quits

Log when a user quits irc.

h2. Ctcps

Log when a user sends a ctcp request.

h2. Kicks

Log when a user is kicked from a channel.

h2. Nicks

Log when a user changes nick.