mirror of
https://github.com/pawelorzech/MacTorn.git
synced 2026-03-31 20:25:43 +00:00
715f0877ff
Create wiki/ directory with 11 markdown pages covering: - Home, Installation, Getting Started guides - Features documentation for all tabs - API Setup with permissions and security - Configuration options and settings - Troubleshooting and FAQ - Development guide with architecture overview - Changelog with version history - Sidebar navigation
124 lines
4 KiB
Markdown
124 lines
4 KiB
Markdown
# 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](https://github.com/pawelorzech/MacTorn/releases).
|
|
|
|
### 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](https://github.com/pawelorzech/MacTorn/issues) 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](https://www.torn.com/profiles.php?XID=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
|