MacTorn/README.md
Paweł Orzech e75131aa67
Add new views and models for money, attacks, faction, properties, and watchlist
Introduces MoneyView, AttacksView, FactionView, PropertiesView, and WatchlistView with corresponding models and state in AppState. Updates ContentView to use a tabbed interface for navigation between new sections. Extends TornModels.swift with new data structures for money, battle stats, attacks, faction, properties, and watchlist items. Adds logic in AppState for fetching, parsing, and managing new data, including watchlist price fetching. Updates project file to include new views.
2026-01-17 21:10:57 +00:00

2.6 KiB

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
  • Price change indicators
  • Add/remove items from watchlist

🏠 Properties Tab

  • Property info and vault contents
  • Upkeep status and countdown

⚙️ General

  • 🔔 Smart notifications for bars, cooldowns, landing, chain
  • 🕒 Configurable refresh intervals (15s/30s/60s/2m)
  • 🚀 Launch at Login

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.

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