pawel/MacTorn
1
0
Fork 0
mirror of https://github.com/pawelorzech/MacTorn.git synced 2026-01-29 19:54:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Native macOS menu bar app for monitoring your Torn game status - energy, nerve, travel, attacks, faction, and market watchlist
8 commits 1 branch 14 tags 24 MiB
Swift 98.7%
Makefile 1.3%
Find a file
Paweł Orzech 7f947b635c
Add app screenshot to README 
Added app.png and updated README.md to include a screenshot of the MacTorn app for better visual context.
2026-01-17 19:57:24 +00:00
MacTorn Make Torn models more robust to missing API data 2026-01-17 19:53:28 +00:00
.DS_Store Initial commit 2026-01-17 17:57:45 +00:00
.gitattributes Initial commit 2026-01-17 17:57:45 +00:00
.gitignore Initial commit 2026-01-17 17:57:45 +00:00
app.png Add app screenshot to README 2026-01-17 19:57:24 +00:00
LICENSE Initial commit 2026-01-17 17:57:45 +00:00
MacTorn-v1.0.zip Make Torn models more robust to missing API data 2026-01-17 19:53:28 +00:00
README.md Add app screenshot to README 2026-01-17 19:57:24 +00:00

README.md

MacTorn

A native macOS menu bar app for monitoring your Torn game status.

macOS Swift License

MacTorn Screenshot

Features

  • 📊 Live Status Bars - Energy, Nerve, Happy, Life with color-coded progress
  • ⏱️ Cooldown Timers - Drug, Medical, Booster countdowns with ready state
  • ✈️ Travel Monitoring - Destination tracking with arrival countdown and abroad state
  • 🔗 Chain Timer - Active chain counter with timeout warning + cooldown state
  • 🏥 Hospital/Jail Status - Countdown to release
  • 📨 Unread Messages - Inbox badge with one-click open
  • 🔔 Events Feed - Recent activity at a glance
  • 🔔 Notifications - Bars thresholds, cooldown ready, landing, chain expiring, and release
  • ⚡ Quick Links - Grid of customizable Torn shortcuts (8 defaults)
  • 🕒 Refresh Control - 15s/30s/60s/2m polling + manual refresh + last updated
  • 🚀 Launch at Login - Start automatically with macOS

Installation

  1. Download the latest release from Releases
  2. Unzip and drag MacTorn.app to your Applications folder
  3. Open MacTorn from Applications
  4. Enter your Torn API Key

Note

: If you download an unsigned build, macOS Gatekeeper will block it. Right-click the app and select "Open", or go to System Settings → Privacy & Security → Open Anyway.

Requirements

  • macOS 13.0 (Ventura) or later
  • Torn API Key with access to: basic, bars, cooldowns, travel, profile, events, messages

Configuration

Refresh Interval

Choose polling frequency: 15s, 30s, 60s, or 120s

Notifications

MacTorn sends notifications for bar thresholds, cooldown ready, landing, chain expiring, and release. Notification defaults are stored locally.

Quick Links

8 preset shortcuts to common Torn pages (fully editable)

Building from Source

git clone https://github.com/pawelorzech/MacTorn.git
cd MacTorn/MacTorn
open MacTorn.xcodeproj

Press Cmd + R to build and run.

Support the Developer

If you find MacTorn useful, send some Xanax or cash to bombel [2362436]!

License

MIT License - see LICENSE for details.

Made with ⚡ for the Torn community