MacTorn/wiki/Configuration.md

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