{"id":39807337,"url":"https://github.com/pawelorzech/mactorn","last_synced_at":"2026-04-18T13:07:01.764Z","repository":{"id":333180724,"uuid":"1136449679","full_name":"pawelorzech/MacTorn","owner":"pawelorzech","description":"Native macOS menu bar app for monitoring your Torn game status - energy, nerve, travel, attacks, faction, and market watchlist","archived":false,"fork":false,"pushed_at":"2026-04-11T22:53:35.000Z","size":28733,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T00:20:52.033Z","etag":null,"topics":["api-client","game-companion","macos","macos-app","menu-bar","menubar-app","swift","swiftui","torn","torn-city"],"latest_commit_sha":null,"homepage":"https://www.torn.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pawelorzech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-17T17:57:54.000Z","updated_at":"2026-04-11T22:53:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pawelorzech/MacTorn","commit_stats":null,"previous_names":["pawelorzech/mactorn"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/pawelorzech/MacTorn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawelorzech%2FMacTorn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawelorzech%2FMacTorn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawelorzech%2FMacTorn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawelorzech%2FMacTorn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pawelorzech","download_url":"https://codeload.github.com/pawelorzech/MacTorn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawelorzech%2FMacTorn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31969835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","game-companion","macos","macos-app","menu-bar","menubar-app","swift","swiftui","torn","torn-city"],"created_at":"2026-01-18T12:39:49.269Z","updated_at":"2026-04-18T13:07:01.758Z","avatar_url":"https://github.com/pawelorzech.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MacTorn\n\nA native macOS menu bar app for monitoring your **Torn** game status.\n\n![macOS](https://img.shields.io/badge/macOS-14.0+-blue)\n![Swift](https://img.shields.io/badge/Swift-5.0-orange)\n![Universal](https://img.shields.io/badge/Universal-Intel%20%2B%20Apple%20Silicon-purple)\n![License](https://img.shields.io/badge/License-MIT-green)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"app_light_1.png\" alt=\"MacTorn Light Mode\" width=\"320\"\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"app_dark_1.png\" alt=\"MacTorn Dark Mode\" width=\"320\"\u003e\n\u003c/p\u003e\n\n## Documentation\n\nFor detailed documentation, visit the [MacTorn Wiki](https://github.com/pawelorzech/MacTorn/wiki).\nFor community discussion and feedback, see the [Torn forums thread](https://www.torn.com/forums.php#/p=threads\u0026f=67\u0026t=16532308).\n\n## Features\n\n### 📊 Status Tab\n- Live Energy, Nerve, Happy, Life bars with color-coded progress\n- Cooldown timers (Drug, Medical, Booster) with quick action buttons when ready\n- Travel monitoring with arrival countdown\n- Chain timer with timeout warning\n- Hospital/Jail status badges\n- Unread messages badge\n- Events feed\n- 8 quick links\n\n### ✈️ Travel Tab\n- **Live countdown timer** in menu bar during flight (✈️🏠 5:32)\n- Flight status with progress bar\n- Quick travel destination picker (all 11 Torn destinations)\n- Pre-arrival notifications (configurable: 2min, 1min, 30sec, 10sec)\n- Country flags for all destinations\n\n### 💰 Money / Net Worth Tab\n- **Net worth dashboard**: Cash, Vault, Cayman, Properties, Stocks at a glance\n- Property vault breakdown (per-property)\n- Stock holdings with cost basis\n- Total tracked net worth\n- Quick actions: Send Money, Bazaar, Bank\n\n### ⚔️ Attacks Tab\n- Battle stats (Strength, Defense, Speed, Dexterity)\n- Recent attacks with W/L results\n- Quick actions: Attack, Hospital, Bounties\n\n### 🏢 Faction Tab\n- Faction info and chain status\n- **Organized Crime timer** with live countdown and READY notifications\n- War status display\n- Armory quick-use buttons\n\n### 📈 Watchlist Tab\n- Track item prices (Latest API v2 support)\n- **Price alerts**: Set a threshold and get notified when price drops below it\n- Displays lowest market price AND quantity (e.g., `$4.2M x12`)\n- Price change indicators\n- Add/remove items from watchlist\n\n### 💬 Forum Watch Tab\n- Watch specific forum threads for new posts (including faction forum threads)\n- Add threads by URL or thread ID\n- Per-thread notification toggle (alerts or bookmark-only mode)\n- Configurable polling interval (2m / 3m / 5m)\n\n### ⚙️ General\n- **🔄 Update Checker**: Automatically notifies you when a new version is available on GitHub.\n- **🔔 Smart Notifications**: Alerts for bar thresholds, cooldown ready, landing, chain expiring.\n- **🕒 Configurable Refresh**: Intervals (15s/30s/60s/2m).\n- **🚀 Launch at Login**: Start seamlessly with macOS.\n- **⚡️ Optimized Startup**: Non-blocking data fetching for instant UI responsiveness.\n\n## Accessibility\n\nMacTorn respects macOS accessibility settings:\n\n- **Reduce Transparency**: When enabled in System Settings → Accessibility → Display, the app uses solid backgrounds instead of translucent materials for better readability\n- **Light \u0026 Dark Mode**: Full support for both appearance modes with optimized contrast\n- **Color-coded indicators**: Status bars and badges use distinct colors that work well in both modes\n\n## Installation\n\n1. Download the latest release from [Releases](https://github.com/pawelorzech/MacTorn/releases)\n2. Unzip and drag `MacTorn.app` to your Applications folder\n3. Open MacTorn from Applications\n4. Enter your [Torn API Key](https://www.torn.com/preferences.php#tab=api)\n\n\u003e **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 \u0026 Security → Open Anyway.\n\n## Requirements\n\n- macOS 14.0 (Sonoma) or later\n- **Universal Binary**: Supports both Intel (x86_64) and Apple Silicon (arm64) Macs\n- Torn API Key with access to: basic, bars, cooldowns, travel, profile, events, messages, market\n\n## API Data Usage\n\nIn compliance with the [Torn API Terms of Service](https://www.torn.com/api.html), the following table shows which API selections MacTorn uses and why:\n\n| Selection | Purpose |\n|-----------|---------|\n| `basic` | Player name, ID, basic info |\n| `bars` | Energy, Nerve, Happy, Life bars |\n| `cooldowns` | Drug, Medical, Booster cooldowns |\n| `travel` | Travel status and destination |\n| `profile` | Battle stats, faction info |\n| `events` | Recent events feed |\n| `messages` | Unread message count |\n| `money` | Cash, vault, points, tokens |\n| `stocks` | Stock holdings and transactions |\n| `properties` | Property vaults and upkeep |\n| `attacks` | Recent attack results |\n| `market` | Item watchlist prices |\n| `faction` | Faction info, chain, organized crimes |\n\n## Configuration\n\n### Refresh Interval\nChoose polling frequency: 15s, 30s, 60s, or 120s\n\n### Notifications\nMacTorn sends notifications for bar thresholds, cooldown ready, landing, chain expiring, and release. Notification defaults are stored locally.\n\n### Updates\nThe app checks for updates automatically on startup. If a new version is available, you'll see a notification in the **Settings** tab.\n\n## Building from Source\n\n```bash\ngit clone https://github.com/pawelorzech/MacTorn.git\ncd MacTorn/MacTorn\nopen MacTorn.xcodeproj\n```\n\nPress `Cmd + R` to build and run.\n\n## Support the Developer\n\nIf you find MacTorn useful, send some Xanax or cash to **bombel** [[2362436](https://www.torn.com/profiles.php?XID=2362436)]!\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\nMade with ⚡ for the Torn community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawelorzech%2Fmactorn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpawelorzech%2Fmactorn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawelorzech%2Fmactorn/lists"}