MacTorn/wiki/FAQ.md

Frequently Asked Questions

General

What is MacTorn?

MacTorn is a native macOS menu bar application that monitors your Torn game status. It displays energy bars, travel timers, chain status, and more without requiring a browser tab.

Is MacTorn free?

Yes, MacTorn is free and open source under the MIT License.

Does MacTorn work on Windows/Linux?

No, MacTorn is a native macOS application and only works on Macs running macOS 13.0 or later.

Does MacTorn work on Intel Macs?

Yes! MacTorn is a Universal Binary that runs natively on both Intel (x86_64) and Apple Silicon (arm64) Macs.

Installation

Why can't I open the app?

macOS Gatekeeper blocks unsigned apps. Right-click the app and select "Open", or go to System Settings > Privacy & Security and click "Open Anyway".

See Troubleshooting for detailed steps.

Where do I download MacTorn?

Download from the GitHub Releases page.

How do I update MacTorn?

When a new version is available, you'll see a notification in the Settings tab. Click "Download Update" to get the latest version from GitHub, then replace your old app with the new one.

API & Security

Is my API key safe?

Yes. Your API key is:

• Stored locally on your Mac only
• Never transmitted anywhere except to Torn's official API
• Not synced to iCloud or any cloud service

What API permissions does MacTorn need?

For full functionality: basic, bars, cooldowns, travel, profile, events, messages, money, battlestats, attacks, properties, and market access.

You can use "Full Access" or select specific permissions. See API-Setup for details.

Can MacTorn perform actions on my account?

No. MacTorn is read-only. It can only view your data - it cannot attack, travel, buy items, or perform any actions on your behalf.

Does MacTorn violate Torn's rules?

No. MacTorn uses Torn's official public API as intended. It follows all API terms of service.

Features

How often does MacTorn update data?

By default, every 30 seconds. You can change this to 15s, 60s, or 2m in Settings.

How do I get notifications?

MacTorn sends notifications through macOS. Ensure notifications are enabled in System Settings > Notifications > MacTorn.

Why is the travel countdown in my menu bar?

When you're traveling, MacTorn shows a live countdown (e.g., "✈️🇬🇧 5:32") so you can always see when you'll land without opening the app.

Can I track custom items in the watchlist?

Currently, the watchlist offers preset popular items. Custom item IDs may be added in future versions.

Does MacTorn show chain alerts?

Yes. When your faction has an active chain, MacTorn displays the chain count and timeout timer in the Status tab.

Troubleshooting

Why do I see a warning triangle icon?

The triangle icon indicates an error, usually an API issue. Open MacTorn and check the Settings tab for error messages.

Notifications aren't working. Why?

1. Check macOS notification settings (System Settings > Notifications > MacTorn)
2. Ensure notifications are allowed
3. For travel alerts, enable them in the Travel tab

The app is using a lot of battery/CPU. Is this normal?

No. MacTorn should use minimal resources. Try quitting and relaunching. If the issue persists, please file a bug report.

How do I completely remove MacTorn?

1. Quit MacTorn
2. Delete MacTorn.app from Applications
3. (Optional) Clear preferences: defaults delete com.bombel.MacTorn in Terminal

Support

How do I report a bug?

File an issue on GitHub with:

• Your macOS version
• MacTorn version
• Steps to reproduce
• Screenshots if helpful

How can I support the developer?

Send some Xanax or cash to bombel [2362436] in-game!

Is there a Discord or community?

Currently, support is through GitHub issues. Join the Torn Discord if you want to discuss with other players.

---

See Also: Troubleshooting for detailed solutions