A native macOS menu bar app for monitoring your Torn game status.
For detailed documentation, visit the MacTorn Wiki. For community discussion and feedback, see the Torn forums thread.
- Live Energy, Nerve, Happy, Life bars with color-coded progress
- Cooldown timers (Drug, Medical, Booster) with quick action buttons when ready
- Travel monitoring with arrival countdown
- Chain timer with timeout warning
- Hospital/Jail status badges
- Unread messages badge
- Events feed
- 8 quick links
- Live countdown timer in menu bar during flight (
✈️ 🏠 5:32) - Flight status with progress bar
- Quick travel destination picker (all 11 Torn destinations)
- Pre-arrival notifications (configurable: 2min, 1min, 30sec, 10sec)
- Country flags for all destinations
- Net worth dashboard: Cash, Vault, Cayman, Properties, Stocks at a glance
- Property vault breakdown (per-property)
- Stock holdings with cost basis
- Total tracked net worth
- Quick actions: Send Money, Bazaar, Bank
- Battle stats (Strength, Defense, Speed, Dexterity)
- Recent attacks with W/L results
- Quick actions: Attack, Hospital, Bounties
- Faction info and chain status
- Organized Crime timer with live countdown and READY notifications
- War status display
- Armory quick-use buttons
- Track item prices (Latest API v2 support)
- Price alerts: Set a threshold and get notified when price drops below it
- Displays lowest market price AND quantity (e.g.,
$4.2M x12) - Price change indicators
- Add/remove items from watchlist
- Watch specific forum threads for new posts (including faction forum threads)
- Add threads by URL or thread ID
- Per-thread notification toggle (alerts or bookmark-only mode)
- Configurable polling interval (2m / 3m / 5m)
- 🔄 Update Checker: Automatically notifies you when a new version is available on GitHub.
- 🔔 Smart Notifications: Alerts for bar thresholds, cooldown ready, landing, chain expiring.
- 🕒 Configurable Refresh: Intervals (15s/30s/60s/2m).
- 🚀 Launch at Login: Start seamlessly with macOS.
- ⚡️ Optimized Startup: Non-blocking data fetching for instant UI responsiveness.
MacTorn respects macOS accessibility settings:
- Reduce Transparency: When enabled in System Settings → Accessibility → Display, the app uses solid backgrounds instead of translucent materials for better readability
- Light & Dark Mode: Full support for both appearance modes with optimized contrast
- Color-coded indicators: Status bars and badges use distinct colors that work well in both modes
- Download the latest release from Releases
- Unzip and drag
MacTorn.appto your Applications folder - Open MacTorn from Applications
- Enter your Torn API Key
Note: If you download an unsigned build, macOS Gatekeeper may block it. Right-click the app and select "Open", or go to System Settings → Privacy & Security → Open Anyway.
- macOS 14.0 (Sonoma) or later
- Universal Binary: Supports both Intel (x86_64) and Apple Silicon (arm64) Macs
- Torn API Key with access to: basic, bars, cooldowns, travel, profile, events, messages, market
In compliance with the Torn API Terms of Service, the following table shows which API selections MacTorn uses and why:
| Selection | Purpose |
|---|---|
basic |
Player name, ID, basic info |
bars |
Energy, Nerve, Happy, Life bars |
cooldowns |
Drug, Medical, Booster cooldowns |
travel |
Travel status and destination |
profile |
Battle stats, faction info |
events |
Recent events feed |
messages |
Unread message count |
money |
Cash, vault, points, tokens |
stocks |
Stock holdings and transactions |
properties |
Property vaults and upkeep |
attacks |
Recent attack results |
market |
Item watchlist prices |
faction |
Faction info, chain, organized crimes |
Choose polling frequency: 15s, 30s, 60s, or 120s
MacTorn sends notifications for bar thresholds, cooldown ready, landing, chain expiring, and release. Notification defaults are stored locally.
The app checks for updates automatically on startup. If a new version is available, you'll see a notification in the Settings tab.
git clone https://github.com/pawelorzech/MacTorn.git
cd MacTorn/MacTorn
open MacTorn.xcodeprojPress Cmd + R to build and run.
If you find MacTorn useful, send some Xanax or cash to bombel [2362436]!
MIT License - see LICENSE for details.
Made with ⚡ for the Torn community