{{>toc}}

h1. Logging Options

_See also [[/log]]._

h2. Log Channels

When enabled, logs all channel windows.

h2. Log Privatechat

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. Make separate folder for each server

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

h2. Separate logs by date

When enabled, will save the logfile in a subfolder named YYYY-MM-DD.

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 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 session start/close

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

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.

_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 logs 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. Split logs 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.

h2. Show 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. Show 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. Disable logging for channels/users

Channels and users in this list will not be logged.

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

h2. Always log channels/users

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._

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.