mirror of https://github.com/pawelorzech/MacTorn.git synced 2026-01-29 19:54:27 +00:00

Make Torn models more robust to missing API data

Updated TornModels.swift to make many properties optional, improving resilience to missing or incomplete API responses. Adjusted ChainView and StatusView to handle optional values safely. Refactored SettingsView for a cleaner layout and removed notification rules UI. Updated README to reflect notification changes and clarify features.

2026-01-17 19:53:28 +00:00

2.4 KiB

Raw Blame History

MacTorn

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

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

Download the latest release from Releases
Unzip and drag MacTorn.app to your Applications folder
Open MacTorn from Applications
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

2.4 KiB Raw Blame History