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
6 commits 1 branch 14 tags 24 MiB
Swift 98.7%
Makefile 1.3%
Find a file
Paweł Orzech 53a234afcd
Add notification rules, status badges, and chain support 
Introduces customizable notification rules with sound options and a UI for managing them in SettingsView. Adds support for displaying chain status, hospital/jail badges, unread messages, and recent events in StatusView. Makes the refresh interval configurable. Updates README with new features and installation instructions. Updates Xcode project to include new components and utilities.
2026-01-17 19:43:07 +00:00
MacTorn Add notification rules, status badges, and chain support 2026-01-17 19:43:07 +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
LICENSE Initial commit 2026-01-17 17:57:45 +00:00
MacTorn-v1.0.zip Add notification rules, status badges, and chain support 2026-01-17 19:43:07 +00:00
README.md Add notification rules, status badges, and chain support 2026-01-17 19:43:07 +00:00

README.md

MacTorn

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

macOS Swift License

Features

  • 📊 Live Status Bars - Energy, Nerve, Happy, Life with color-coded progress
  • ⏱️ Cooldown Timers - Drug, Medical, Booster countdowns
  • ✈️ Travel Monitoring - Destination tracking with arrival countdown
  • 🔗 Chain Timer - Active chain counter with timeout warning
  • 🏥 Hospital/Jail Status - Countdown to release
  • 📨 Unread Messages - Quick access to inbox
  • 🔔 Events Feed - Recent activity at a glance
  • 🔔 Smart Notifications - Custom threshold alerts with sound options
  • ⚡ Quick Links - 8 configurable shortcuts to Torn pages
  • 🚀 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

: On first launch, macOS may show a security warning. Right-click the app and select "Open" to bypass.

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

Notification Rules

Customize when to receive alerts:

  • Energy/Nerve/Happy/Life at specific thresholds
  • Sound selection per notification type

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