Logs and Troubleshooting
Use TG-Downloader logs to troubleshoot downloads, monitors, Auto Forward, the browser extension and sign-in problems, with INFO, WARN and ERROR guidance.
When a download fails, a monitor or forwarding rule stays quiet, the browser extension disconnects or sign-in misbehaves, open Logs first.
Filter and refresh
- Use the top-left filter for All Levels / INFO / WARN / ERROR. Start with ERROR when troubleshooting.
- Click Refresh to reload recent entries.
- Each line contains time + level + message.
Normal log lines
| Log | Meaning |
|---|---|
| Read latest message ID / Init latest message ID | A monitor is polling |
| No new messages: Latest ID unchanged | Nothing new in this poll |
| Auto Forward service started / Auto Forward queued | A forwarding rule is running or found new messages |
| Auto Forward could not check for new messages | A source account, permission or network error occurred |
| Received download items from the browser extension | The desktop app accepted a browser task; continue in Downloads |
| Download started / Download completed | A task started or ended |
| No proxy configured | The app uses a direct connection |
Log levels
| Level | Meaning |
|---|---|
| INFO | Normal workflow |
| WARN | A recoverable problem, retry or invalid session |
| ERROR | A real failure and the first place to look |
What to include when asking for help
- The ERROR lines as text or a screenshot.
- The feature involved (download, Auto Monitor, Auto Forward or browser extension) and the chat.
- The Device ID from Settings → General.
- Your operating-system version.
See the FAQ for common problems.