Troubleshooting & FAQs

SwiftMiner is designed to recover from connection problems and API shifts automatically. If a miner stops or rewards do not appear in your Twitch inventory, use these steps to identify and resolve the issue.

Fix "Needs Auth" Error

Twitch authentication sessions are stored as secure tokens in your macOS Keychain. These sessions expire periodically for security, especially after password changes, security updates, or if you revoke app permissions on Twitch.

When a session expires, SwiftMiner reports a Needs Auth status on that account, and a red indicator appears in the sidebar.

1. Open SwiftMiner Settings (⌘,) and navigate to the Accounts tab.
2. Locate the account displaying the warning, and click its Reconnect button.
3. SwiftMiner will display the Twitch device-code activation dialog.
4. Open twitch.tv/activate in your browser, enter the activation code, and approve.
5. SwiftMiner will detect the connection and resume mining automatically.

Resolve Stuck Miners

If a miner reports it is running but no progress is accumulating, or if it appears stalled on a single stream:

1. Verify Anti-stall Recovery:

   Ensure that Anti-stall recovery is enabled in Settings > Mining. When enabled, SwiftMiner will automatically restart the miner session or switch channels if watch progress is stagnant for more than 5 minutes.

2. Check Campaign Schedules:

   Verify that there is an active Drops campaign for the game being watched. Go to the Drops tab and check the active lists. If a campaign has ended, the miner will stop accumulating watch time.

3. Manually Restart the Miner:

   Go to the Miners tab, click Stop on the affected account, wait 5 seconds, and click Start. This forces the engine to query Twitch for new streams and rebuild the watch session.

Drops Not Progressing

If you see a miner watching a stream but the progress percentage on Twitch or in SwiftMiner does not increase, the most common causes are stream viewing conflicts or missing account links.

1. Duplicate viewing sessions

Twitch only allows one active watch stream per account to count toward Drops progress. If you watch Twitch in a browser tab, on your phone, or on a TV utilizing the same Twitch account, Twitch will prioritize that browser/app session and pause SwiftMiner's progress.
Solution: Avoid watching Twitch streams using the same accounts that SwiftMiner is currently farming on.

2. Missing publisher account links

Many game developers (e.g. Electronic Arts, Ubisoft, Riot Games, Bungie) require you to link your Twitch account to their specific game developer account before watch time can count toward in-game rewards.
Solution: Go to the campaign page in your Twitch Drops Inventory, look for a Link Account or Connect button next to the game description, and complete the connection flow. Once linked, resume mining in SwiftMiner.

Export Diagnostic Logs

If you encounter an issue that you cannot resolve, you can export a log report to attach to a GitHub issue. SwiftMiner logs contain API logs, switches, and system errors.

1. Go to the macOS menu bar and choose Help > Export Diagnostic Logs....
2. Select a location on your Mac to save the file (e.g., your Desktop) and click Save.
3. Open a GitHub Issue, and attach the saved log file.