MacTorn/wiki/Features.md

Features

MacTorn offers a comprehensive set of features for monitoring your Torn status. This page details all available features organized by tab.

Status Tab

The Status tab is your main dashboard showing vital information at a glance.

Progress Bars

Real-time display of your four main stats with color-coded progress:

Bar	Color	Description
Energy	Orange/Yellow	Your energy level and regeneration
Nerve	Red	Your nerve level
Happy	Pink	Your happiness level
Life	Blue	Your current health

Each bar shows:

• Current value / Maximum value
• Visual progress indicator
• Fill color changes as bar approaches full

Cooldown Timers

Live countdown timers for:

• Drug Cooldown - Time until you can use drugs again
• Medical Cooldown - Time until medical items are available
• Booster Cooldown - Time until boosters can be used

Timers count down in real-time and notify you when ready.

Status Badges

Visual indicators for special states:

• Hospital - Red badge when hospitalized
• Jail - Gray badge when in jail
• Messages - Badge showing unread message count

Chain Timer

When your faction has an active chain:

• Displays current chain count
• Shows timeout timer
• Warns when chain is about to expire

Events Feed

Recent events scroll showing:

• Incoming attacks
• Messages received
• Money transfers
• Other significant events

Quick Links

8 customizable quick-access buttons:

• Gym, Items, Properties
• Missions, Crimes, Jail
• Hospital, Casino

Travel Tab

Comprehensive travel management with live tracking.

Travel Status

Three possible states displayed:

In Torn City

• Home icon with "Ready to travel" message
• Access to destination picker

Flying

• Live countdown timer updating every second
• Destination with country flag
• Progress bar showing flight completion
• Menu bar displays: ✈️🇬🇧 5:32 (airplane + flag + time)

Abroad

• Globe icon showing current location
• "Return to Torn" button for quick return

Destination Picker

Quick travel buttons for all 11 Torn destinations:

Destination	Flag	Flight Time
Mexico	🇲🇽	~26 min
Cayman Islands	🇰🇾	~35 min
Canada	🇨🇦	~41 min
Hawaii	🇺🇸	~2h 14m
United Kingdom	🇬🇧	~2h 31m
Argentina	🇦🇷	~2h 45m
Switzerland	🇨🇭	~2h 50m
Japan	🇯🇵	~3h 30m
China	🇨🇳	~3h 52m
UAE	🇦🇪	~4h 22m
South Africa	🇿🇦	~4h 45m

Click any destination to open Torn's travel agency with that destination selected.

Pre-Arrival Alerts

Configurable notifications before landing:

• 2 minutes before arrival
• 1 minute before arrival
• 30 seconds before arrival
• 10 seconds before arrival

Enable/disable each interval independently.

Money Tab

Financial overview and quick actions.

Balance Display

• Cash on Hand - Your pocket money
• Vault - Bank vault balance
• Points - Current points
• Tokens - Job tokens

Quick Actions

• Send Money - Opens money transfer page
• Bazaar - Opens your bazaar
• Bank - Opens Torn bank

Attacks Tab

Combat statistics and history.

Battle Stats

Your four battle statistics:

• Strength
• Defense
• Speed
• Dexterity

Recent Attacks

List of recent attack results showing:

• Target name
• Win/Loss outcome
• Timestamp

Quick Actions

• Attack - Opens attack page
• Hospital - Opens hospital list
• Bounties - Opens bounty list

Faction Tab

Faction information and utilities.

Faction Info

• Faction name and ID
• Your position/rank
• Member count

Chain Status

When chain is active:

• Current chain count
• Time to timeout
• Visual warning when expiring

War Status

If faction is at war:

• War opponent
• War score
• Territory control

Armory Quick-Use

Buttons for common armory items (if available).

Watchlist Tab

Track item market prices in real-time using Torn API v2.

Price Tracking

For each watched item shows:

• Item name with market link
• Lowest price on Item Market
• Quantity at lowest price (e.g., "$4.2M x12")
• Price change indicator (if price increased)

Adding Items

Click the + button to add items from a preset list:

• Xanax
• FHC (Feathery Hotel Coupon)
• Donator Pack
• Drug Pack
• Energy Drink
• First Aid Kit

Market Links

Quick access to:

• Item Market
• Points Market

Settings Tab

Configure MacTorn to your preferences.

API Key Management

• Secure input field for API key
• "Save & Connect" to apply key
• Link to generate new key on Torn

Refresh Interval

Choose polling frequency:

• 15 seconds
• 30 seconds (default)
• 60 seconds
• 2 minutes

Appearance

• System - Follow macOS appearance
• Light - Always light mode
• Dark - Always dark mode

Accessibility

• Reduce Transparency - Use solid backgrounds for better readability

Launch at Login

Toggle to start MacTorn automatically when you log into your Mac.

Update Notifications

When a new version is available:

• Version number displayed
• "Download Update" button links to GitHub releases

---

Next: Configuration - Detailed configuration options