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
10 commits 1 branch 14 tags 24 MiB
Swift 98.7%
Makefile 1.3%
Find a file
Paweł Orzech 10a441e557
Add automatic update checker and UI integration 
Introduces an UpdateManager to check for new releases on GitHub and integrates update notifications into the app's state and SettingsView. Updates Info.plist to version 1.2, adds MacTorn-v1.2.zip, archives v1.0 zip, and revises README to document the new update checker and other improvements.
2026-01-17 21:17:57 +00:00
MacTorn Add automatic update checker and UI integration 2026-01-17 21:17:57 +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.2.zip Add automatic update checker and UI integration 2026-01-17 21:17:57 +00:00
README.md Add automatic update checker and UI integration 2026-01-17 21:17:57 +00:00

README.md

MacTorn

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

macOS Swift License

MacTorn Screenshot

Features

📊 Status Tab

  • Live Energy, Nerve, Happy, Life bars with color-coded progress
  • Cooldown timers (Drug, Medical, Booster)
  • Travel monitoring with arrival countdown
  • Chain timer with timeout warning
  • Hospital/Jail status badges
  • Unread messages badge
  • Events feed
  • 8 customizable quick links

💰 Money Tab

  • Cash, Vault, Points, Tokens display
  • Quick actions: Send Money, Bazaar, Bank

⚔️ Attacks Tab

  • Battle stats (Strength, Defense, Speed, Dexterity)
  • Recent attacks with W/L results
  • Quick actions: Attack, Hospital, Bounties

🏢 Faction Tab

  • Faction info and chain status
  • War status display
  • Armory quick-use buttons

📈 Watchlist Tab

  • Track item prices (Latest API v2 support)
  • Displays lowest market price AND quantity (e.g., $4.2M x12)
  • Price change indicators
  • Add/remove items from watchlist

⚙️ General

  • 🔄 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.

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 may 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, market

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.

Updates

The app checks for updates automatically on startup. If a new version is available, you'll see a notification in the Settings tab.

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