# Logs

Directory
  All logs generated by DC++ will be put in this subdirectory.
  Default: The "Logs" subdirectory under where you've installed the application.
Log main chat
  Enables logging of the main chat of any hubs you're in.
Main chat log format
  %[message] - Main chat message
  Default format: [%Y-%m-%d %H:%M] %[message]
Log private chat
  Enables logging of Private Messages.
Private chat log format
  %[message] - Private chat message
  Default format: [%Y-%m-%d %H:%M] %[message]
Log downloads
  Enables logging of completed downloads. File list downloads may not be logged if you've disabled them.
Log uploads
  Enables logging of completed uploads. File list uploads may not be logged if you've disabled them.
Download and upload log format
  %[userNI] - User's nickname
  %[userCID] - User's CID
  %[userI4] - User's IP address
  %[hubNI] - Hub name
  %[hubURL] - Hub's IP address
  %[fileSI] - File Size
  %[fileSIshort] - File size, shortened and including units
  %[fileSIchunk] - Size uploaded this session
  %[fileSIchunkshort] - Size uploaded this session, short and including units
  %[fileSIactual] - Actual uploaded bytes, affected by compression
  %[fileSIactualshort] - Actual uploaded bytes, short and including units
  %[speed] - Speed of the transfer
  %[time] - Elapsed time of the transfer
  %[sfv] - Whether the file was checked against a SFV file (0 = no, 1 = yes).
  %[tth] - Base32 representation of the tiger tree root hash
  Only for Download log: %[target] - Local path and filename
  Only for Upload log: %[source] - Local path for the upload.
  Default download log format: %Y-%m-%d %H:%M: %[target] downloaded from %[userNI] (%[userCID]), %[fileSI] (%[fileSIchunk]), %[speed], %[time]
  Default upload log format: %Y-%m-%d %H:%M: %[source] uploaded to %[userNI] (%[userCID]), %[fileSI] (%[fileSIchunk]), %[speed], %[time]
Log system messages
  Enables logging of system-level messages. Examples of such messages are: notifications of files that have finished hashing, share refreshes, discovery of duplicate files, and disconnections of users who leave the hub (if enabled).
System log format
  %[message] - System log message
  Default: [%Y-%m-%d %H:%M] %[message]
Log status messages
  Enables the logging of status messages. Examples of such messages are: Connected to (and disconnected from ) hub, kicked, and banned messages. In short all messages that would appear below the chat input in the hub windows.
Hub status log format
  %[message] - Hub status message
  Default: [%Y-%m-%d %H:%M] %[message]
Log filelist transfers
  Add successful file list transfers to your upload and download logs. If this option is disabled, file list transfers do not appear in the Finished downloads and Finished uploads windows. Disabled by default.
General time format variables
  The following time variables can be used in any of the log formats.
  %a - Abbreviated weekday name
  %A - Full weekday name
  %b - Abbreviated month name
  %B - Full month name
  %c - Date and time representation appropriate for locale
  %d - Day of month as decimal number (01 - 31)
  %H - Hour in 24-hour format (00 - 23)
  %I - Hour in 12-hour format (01 - 12)
  %j - Day of year as decimal number (001 - 366)
  %m - Month as decimal number (01 - 12)
  %M - Minute as decimal number (00 - 59)
  %p - Current locale's A.M./P.M. indicator for 12-hour clock
  %S - Second as decimal number (00 - 59)
  %U - Week of year as decimal number, with Sunday as first day of week (00 - 53)
  %w - Weekday as decimal number (0 - 6; Sunday is 0)
  %W - Week of year as decimal number, with Monday as first day of week (00 - 53)
  %x - Date representation for current locale
  %X - Time representation for current locale
  %y - Year without century, as decimal number (00 - 99)
  %Y - Year with century, as decimal number
  %z, %Z - Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown
Filename format
  This enables you to name and rotate your logs. The following parameters can be used for Main / Private chat:
  %[hubNI] - Name of hub (not known until connected)
  %[hubURL] - Address (and port if non standard) of hub
  %[userNI] - User's nick (only Private chat)
  %[userCID] - User's CID
  %[myCID] - Your own CID
  %[myNI] - Your nick

  The general time format variables can be used in all file name formats.

  If there are illegal characters in the filename, such as colons, they will be replaced with underscores.
  Ex: Main chat: %[hubaddr]\%Y-%m.log - would result in this: example.no-ip.org\2004-12.log (if you are in the hub example.no-ip.org and it is december 2004)

  Default:

  - Hub chat: %[hubURL].log
  - Hub status: %[hubURL]_status.log
  - Private message: %[userNI].%[userCID].log
  - Download: Downloads.log
  - Upload: Uploads.log
  - System: system.log