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
20 commits 1 branch 14 tags 24 MiB
Swift 98.7%
Makefile 1.3%
Find a file
Paweł Orzech 8d4645c2a2
feat: Update application version to 1.2.5, add new release archive, and update gitignore to include build artifacts and archive folder.
2026-01-18 00:32:21 +00:00
.github/workflows feat: Implement comprehensive unit and UI tests for models and view models, including a new network session, mocks, fixtures, and a CI workflow. 2026-01-17 23:19:29 +00:00
MacTorn feat: Update application version to 1.2.5, add new release archive, and update gitignore to include build artifacts and archive folder. 2026-01-18 00:32:21 +00:00
.DS_Store refactor: Enhance API error handling with logging, introduce minimum loading time, update app version to 1.2.1, and ignore .DS_Store. 2026-01-17 21:34:47 +00:00
.gitattributes Initial commit 2026-01-17 17:57:45 +00:00
.gitignore feat: Update application version to 1.2.5, add new release archive, and update gitignore to include build artifacts and archive folder. 2026-01-18 00:32:21 +00:00
app.png Update app.png 2026-01-17 21:23:55 +00:00
LICENSE Initial commit 2026-01-17 17:57:45 +00:00
MacTorn-1.2.5.zip feat: Update application version to 1.2.5, add new release archive, and update gitignore to include build artifacts and archive folder. 2026-01-18 00:32:21 +00:00
Makefile feat: Implement comprehensive unit and UI tests for models and view models, including a new network session, mocks, fixtures, and a CI workflow. 2026-01-17 23:19:29 +00:00
README.md Update README.md 2026-01-17 21:26:07 +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