Enabling Debug Logging

To enable debug logging:

1. Quit Adium
2. Relaunch it while holding down the Option (⌥) key
3. Check the "Start in debug mode" box
4. Click Okay

Beta and nightly builds, when available, have debug logging enabled by default.

Getting a Debug Log

If the problem occurs without a crash, do the following:

1. Launch Adium. If you are having a problem while connecting, hold Shift (⇧) as Adium launches to prevent your accounts from automatically connecting.
2. Open the Adium Debug Window from the Adium menu. Once the window is open, it logs information which may be use in tracking down a problem.
3. Click "Clear" in the window.
4. Perform the action which generates the problem. If it is a problem signing on with a specific account, only connect the account with which you have a problem.
5. Depending on whether you are composing a bug report (ticket) or a forum post

• (ticket) Copy the contents of the debug window to a new plain text file and attach that file to your ticket. Please enclose your pasted debug output with the ` character so it will be formatted and spaced correctly by Trac.
• (forum post) Copy the contents of the debug window to your forum post. Make sure you wrap the log in [code][/code] tags.

Crashes

If the problem causes a crash, your actions will be similar, but you should check the "Log to ~/Library/Logs/Adium Debug" checkbox in the window before starting. This will send output to a file named by the current date in <Home>/Library/Logs/Adium Debug. You can then browse to and attach this file to your ticket.

Private information

Please note that debug logs often contain the user names of your contacts, and if you send or receive messages this information may be included in the log.

If you are concerned about keeping this information private, just comment in the ticket that you have submitted your debug log via email. Then, email the log to feedback at adium dot im and include the ticket number and your Trac user name in your subject line.

---

Be sure to read ReportingBugs to learn about the information which can help track down problems.

Thanks for helping make Adium even better!