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
167 lines
4.2 KiB
Markdown
167 lines
4.2 KiB
Markdown
# Configuration
|
|
|
|
MacTorn offers several configuration options to customize your experience. All settings are found in the **Settings** tab.
|
|
|
|
## Refresh Interval
|
|
|
|
Control how often MacTorn fetches data from Torn's API.
|
|
|
|
| Interval | Best For |
|
|
|----------|----------|
|
|
| **15 seconds** | Active players who need real-time updates |
|
|
| **30 seconds** | Balanced usage (default) |
|
|
| **60 seconds** | Casual monitoring |
|
|
| **2 minutes** | Minimal API usage, background monitoring |
|
|
|
|
**Note:** Shorter intervals use more API calls. If you use multiple Torn apps, consider longer intervals to avoid rate limits.
|
|
|
|
### Changing Refresh Interval
|
|
|
|
1. Open MacTorn (click menu bar icon)
|
|
2. Go to **Settings** tab
|
|
3. Click your preferred interval in the segmented control
|
|
|
|
The change takes effect immediately.
|
|
|
|
## Appearance Mode
|
|
|
|
Choose how MacTorn appears:
|
|
|
|
| Mode | Behavior |
|
|
|------|----------|
|
|
| **System** | Follows macOS appearance (Light/Dark) |
|
|
| **Light** | Always use light theme |
|
|
| **Dark** | Always use dark theme |
|
|
|
|
### Setting Appearance
|
|
|
|
1. Open MacTorn
|
|
2. Go to **Settings** tab
|
|
3. Select your preferred mode from the picker
|
|
|
|
## Accessibility Settings
|
|
|
|
### Reduce Transparency
|
|
|
|
When enabled, MacTorn uses solid backgrounds instead of translucent materials. This improves readability for users who prefer less visual complexity.
|
|
|
|
**To enable:**
|
|
1. Open MacTorn Settings
|
|
2. Toggle **Reduce Transparency** ON
|
|
|
|
**System-wide setting:** MacTorn also respects the macOS "Reduce Transparency" setting found in System Settings > Accessibility > Display.
|
|
|
|
## Launch at Login
|
|
|
|
Start MacTorn automatically when you log into your Mac.
|
|
|
|
**To enable:**
|
|
1. Open MacTorn Settings
|
|
2. Toggle **Launch at Login** ON
|
|
|
|
MacTorn will now appear in your menu bar after every restart/login.
|
|
|
|
## Notification Settings
|
|
|
|
MacTorn can send macOS notifications for various events.
|
|
|
|
### Available Notifications
|
|
|
|
| Notification | When Triggered |
|
|
|--------------|----------------|
|
|
| Energy threshold | Energy reaches a certain level |
|
|
| Nerve threshold | Nerve reaches a certain level |
|
|
| Cooldown ready | Drug/Medical/Booster cooldown completes |
|
|
| Travel landing | Arriving at destination |
|
|
| Chain expiring | Chain timer running low |
|
|
| Hospital release | Released from hospital |
|
|
| Jail release | Released from jail |
|
|
|
|
### Travel Pre-Arrival Alerts
|
|
|
|
Configure notifications before landing (found in Travel tab):
|
|
|
|
| Alert | When |
|
|
|-------|------|
|
|
| 2 minutes | 2 minutes before arrival |
|
|
| 1 minute | 1 minute before arrival |
|
|
| 30 seconds | 30 seconds before arrival |
|
|
| 10 seconds | 10 seconds before arrival |
|
|
|
|
Enable/disable each independently in the Travel tab under "Pre-Arrival Alerts".
|
|
|
|
### Enabling macOS Notifications
|
|
|
|
For MacTorn notifications to appear, ensure they're enabled in macOS:
|
|
|
|
1. Open **System Settings**
|
|
2. Go to **Notifications**
|
|
3. Find **MacTorn** in the list
|
|
4. Ensure **Allow Notifications** is ON
|
|
5. Configure banner style, sounds, etc. as desired
|
|
|
|
## Watchlist Configuration
|
|
|
|
The Watchlist tab tracks item prices from Torn's Item Market.
|
|
|
|
### Adding Items
|
|
|
|
1. Go to **Watchlist** tab
|
|
2. Click the **+** button
|
|
3. Select an item from the preset list:
|
|
- Xanax
|
|
- FHC (Feathery Hotel Coupon)
|
|
- Donator Pack
|
|
- Drug Pack
|
|
- Energy Drink
|
|
- First Aid Kit
|
|
|
|
### Removing Items
|
|
|
|
Click the **x** button next to any watched item to remove it.
|
|
|
|
### Manual Refresh
|
|
|
|
Click the refresh icon (circular arrow) in the Watchlist header to manually update prices.
|
|
|
|
## Quick Links
|
|
|
|
The Status tab includes 8 quick links. Currently these are preset to common Torn pages:
|
|
|
|
- Gym
|
|
- Items
|
|
- Properties
|
|
- Missions
|
|
- Crimes
|
|
- Jail
|
|
- Hospital
|
|
- Casino
|
|
|
|
## Data Storage
|
|
|
|
MacTorn stores configuration locally:
|
|
|
|
| Data | Storage Method |
|
|
|------|----------------|
|
|
| API Key | UserDefaults (local) |
|
|
| Refresh Interval | UserDefaults |
|
|
| Appearance Mode | UserDefaults |
|
|
| Reduce Transparency | UserDefaults |
|
|
| Launch at Login | macOS SMAppService |
|
|
| Notification Rules | UserDefaults |
|
|
| Watchlist Items | UserDefaults |
|
|
|
|
**Privacy:** No data is sent anywhere except to Torn's API servers.
|
|
|
|
## Resetting Configuration
|
|
|
|
To reset all settings to defaults:
|
|
|
|
1. Quit MacTorn
|
|
2. Open Terminal
|
|
3. Run: `defaults delete com.bombel.MacTorn`
|
|
4. Relaunch MacTorn
|
|
|
|
---
|
|
|
|
**Next:** [[Troubleshooting]] - Solutions to common issues
|