pawel/MacTorn
1
0
Fork 0
mirror of https://github.com/pawelorzech/MacTorn.git synced 2026-01-30 04:04:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
MacTorn/wiki/Installation.md
Paweł Orzech 715f0877ff
docs: Add comprehensive GitHub wiki documentation 
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
2026-01-20 13:24:55 +00:00

2.2 KiB
Raw Blame History

Installation

This guide covers how to install MacTorn on your Mac.

System Requirements

Requirement Details
macOS Version 13.0 (Ventura) or later
Architecture Universal Binary - Intel (x86_64) and Apple Silicon (arm64)
Storage ~10 MB
Network Internet connection for Torn API

Download

  1. Visit the Releases page
  2. Download the latest MacTorn.zip file
  3. Unzip the downloaded file

Install

  1. Drag MacTorn.app to your Applications folder
  2. Open MacTorn from Applications (or Spotlight search)

Gatekeeper Warning (Unsigned App)

Since MacTorn is not signed with an Apple Developer certificate, macOS Gatekeeper will block it on first launch. Here's how to bypass this:

Method 1: Right-Click Open

  1. Right-click (or Control-click) on MacTorn.app
  2. Select Open from the context menu
  3. Click Open in the dialog that appears

Method 2: System Settings

  1. Try to open MacTorn normally (it will be blocked)
  2. Open System Settings (or System Preferences on older macOS)
  3. Go to Privacy & Security
  4. Scroll down to the Security section
  5. You'll see a message about MacTorn being blocked
  6. Click Open Anyway
  7. Enter your password if prompted
  8. Click Open in the confirmation dialog

First Launch

After successfully opening MacTorn:

  1. The app will appear as a bolt icon in your menu bar
  2. Click the icon to open the MacTorn window
  3. Navigate to the Settings tab
  4. Enter your Torn API Key (see API-Setup)
  5. Click Save & Connect

Updating MacTorn

MacTorn automatically checks for updates. When a new version is available:

  1. A notification appears in the Settings tab
  2. Click Download Update to open the releases page
  3. Download and replace the old version with the new one

Alternatively, manually check GitHub Releases for new versions.

Uninstalling

To remove MacTorn:

  1. Quit MacTorn if running (right-click menu bar icon)
  2. Delete MacTorn.app from Applications
  3. (Optional) Remove preferences: delete ~/Library/Preferences/com.bombel.MacTorn.plist

Next: Getting-Started - Configure your API key