Use SwiftMiner
Learn what each section of the app shows and when to use it.
Get Started
Install SwiftMiner, add Twitch accounts, and begin mining Drops.
Fix a Problem
Resolve auth, progress, notification, and account linking issues.
Discord & SwiftBot
Learn what SwiftBot is, when to use it, and how Discord notifications work.
Browse Help
Settings
Configure accounts, mining behavior, updates, notifications, and logs.
Best Practices
Keep Drops reliable and avoid common Twitch session conflicts.
Getting Started
Install SwiftMiner
- Download the latest release from GitHub Releases.
- Move
SwiftMiner.appto/Applications. - Open SwiftMiner.
First launch note
macOS may warn you about an app downloaded from the internet. This is expected for downloaded apps. Choose Open to continue.
Add your first Twitch account
- Choose Add Account in SwiftMiner.
- SwiftMiner shows a Twitch device-code login flow.
- Open twitch.tv/activate in your browser.
- Sign in to Twitch and enter the code shown in SwiftMiner.
- Wait for confirmation. The miner starts automatically.
You can add multiple accounts. Each account runs independently.
Main Window
SwiftMiner uses a sidebar to move between the app's main work areas.
OverviewActive campaigns, progress summaries, and what is currently being mined.
MinersStatus for each account, current stream, health, and start or stop controls.
DropsIn-progress, claimable, completed, and upcoming Drops across accounts.
Activity LogA timestamped feed of claims, errors, stream switches, and other events.
DiscordSwiftBot integration settings when Discord features are enabled.
Overview
The Overview tab is your dashboard. It shows active campaigns, time remaining, running miners, current streams, and quick campaign actions.
Miners
Each account appears as its own miner with status, current stream, Drop progress, and health. A badge on the Miners sidebar item shows how many miners need attention.
Drops
The Drops tab groups rewards by progress state, so you can quickly see what is active, ready to claim, complete, or upcoming.
Activity Log
Use the Activity Log to understand why a miner switched streams, when Drops were claimed, or why something stopped. You can filter the log and export it for troubleshooting.
Settings
Open Settings with ⌘, or from the app menu.
General
Choose whether SwiftMiner appears in the Dock, menu bar, or both. You can also run miners after closing the window, launch at login, start minimized, and configure Stable or Beta Sparkle updates.
App Management permission
On first update, macOS may ask for App Management permission. Allow it if you want Sparkle to install updates automatically.
Accounts
Add Twitch accounts, remove accounts you no longer want to mine, or reconnect accounts after Twitch sessions expire.
Mining
Configure auto-claiming, channel point bonuses, synced miner state, auto-start on launch, duplicate stream avoidance, followed streamer priority, badge and emote campaigns, and anti-stall recovery.
Integrations
When Discord integration is enabled, configure SwiftBot connection and notification preferences. See Discord Help for setup details.
Advanced
Adjust log level, show the live log console, show activity log icons, and choose whether SwiftMiner prefers Steam artwork.
SwiftMiner
SwiftBot
SwiftBot for Discord
What is SwiftBot?
SwiftMiner started because I wanted a reliable way to mine Drops for the friends I actually play games with. It grew from a personal setup into a small platform for keeping everyone's Twitch Drops moving without needing a pile of browser tabs or manual check-ins.
SwiftBot is the Discord companion built around that same idea. Our Discord server is just a group of friends, so SwiftBot is designed to let people set up or reconnect their own miners, check status, and get important Drop updates in the place we already hang out.
The integration means I no longer have to do all the background admin work for everyone by hand. Friends can use Discord slash commands and guided messages, while SwiftMiner keeps doing the actual mining work on the Mac.
Learn more at swiftbot.dev, or open the Discord setup guide for SwiftMiner-specific steps.
Why use it?
- Get notified when Drops are claimed or campaigns finish.
- Check miner status with Discord slash commands.
- Reconnect or set up accounts through a guided Discord flow.
- Let friends manage their own setup without handing every small task back to you.
Notifications
SwiftMiner can send macOS notifications when a Drop is claimed, a campaign completes, a miner encounters an error, or Twitch authentication expires.
If you do not receive alerts, check System Settings > Notifications > SwiftMiner and make sure Focus or Do Not Disturb is not blocking alerts.
Troubleshooting
A miner shows Needs Auth
- Open Settings > Accounts.
- Choose Reconnect on the affected account.
- Follow the Twitch activation steps again.
A miner appears stuck
Make sure Anti-stall recovery is enabled. Also confirm there are active Twitch Drops campaigns, the account is eligible, and the game does not require an external account link.
Drops are not progressing
- Only one stream session per Twitch account counts toward Drops. Watching Twitch elsewhere can take priority over SwiftMiner.
- Some campaigns require a publisher account link before Drops can be claimed.
- Not all games have active Drops at all times.
Export logs for support
- Choose Help > Export Diagnostic Logs....
- Save the file.
- Attach it when raising a GitHub issue or contacting support.
Diagnostic logs are automatically redacted to remove sensitive tokens and identifiers.
Best Practices
- Keep SwiftMiner updated. Twitch can change its systems without warning. Automatic updates help fixes arrive quickly.
- Avoid duplicate viewing sessions. If SwiftMiner is mining for an account, avoid watching Twitch with that same account in a browser or mobile app.
- Link publisher accounts early. Campaigns from EA, Ubisoft, Riot, and other publishers may require account linking before Drops can be claimed.
- Check the Activity Log. It usually explains stream switches, claims, stops, and errors.
- Use menu bar mode. For always-on mining, Menu Bar Only keeps the Dock clean while miners continue running.
Important Notes
- SwiftMiner is intended for personal use on your own machines and accounts.
- Each account runs independently. More accounts use more system resources and bandwidth.
- Twitch may change how Drops or automation behave at any time.
- Performance depends on network quality, system resources, and the number of active accounts.