Installation¶

Desktop App (macOS)¶

Option 1: Download Release (Recommended)¶

Download the latest release from GitHub Releases
Unzip and drag PlexusOne Desktop.app to your Applications folder
Open PlexusOne Desktop from Applications (you may need to right-click → Open the first time)

Option 2: Build from Source¶

Prerequisites¶

Xcode Command Line Tools
Swift 5.9+
tmux installed via Homebrew

Build Steps¶

# Clone the repository
git clone https://github.com/plexusone/plexusone-app.git
cd plexusone-app/apps/desktop

# Build the app
swift build -c release

# Copy to Applications (optional)
cp -r "PlexusOne Desktop.app" /Applications/

Run Without Installing¶

# Build and run directly
swift build
open "PlexusOne Desktop.app"

# Or run the binary
.build/debug/PlexusOneDesktop

TUI Parser (For Mobile Support)¶

The TUI Parser is a Go service that bridges tmux sessions to the mobile app over WebSocket.

Build¶

cd plexusone-app/services/tuiparser

# Build the binary
go build -o bin/tuiparser ./cmd/tuiparser

Run¶

# Start on default port 9600
./bin/tuiparser

# Or specify a different port
./bin/tuiparser --port 8080

Verify¶

Open http://localhost:9600 in your browser to see the debug console.

Mobile App¶

iOS¶

Coming Soon

iOS app will be available on TestFlight and the App Store.

For now, build from source:

cd plexusone-app/apps/mobile
flutter pub get
flutter run --device-id <your-iphone-id>

Android¶

Coming Soon

Android APK will be available on GitHub Releases.

For now, build from source:

cd plexusone-app/apps/mobile
flutter pub get
flutter build apk --release

Install the APK from build/app/outputs/flutter-apk/app-release.apk.

Verify Installation¶

Desktop App¶

Open PlexusOne Desktop
You should see the main window with "Loading..." then an empty 2×1 grid
Create a test tmux session:
```
tmux new-session -d -s test
```
Click the session dropdown in any pane and select "test"
You should see the terminal output

TUI Parser¶

Start the TUI Parser: ./bin/tuiparser
Open http://localhost:9600
Enter a session name and click "Subscribe"
You should see terminal output streaming

Troubleshooting¶

"tmux not found"¶

Ensure tmux is installed and in your PATH:

which tmux
# Should output: /opt/homebrew/bin/tmux or /usr/local/bin/tmux

If not found, install via Homebrew:

brew install tmux

"Cannot connect to WebSocket"¶

Ensure TUI Parser is running: ./bin/tuiparser
Check the port is not in use: lsof -i :9600
Verify firewall allows connections on port 9600

App Won't Open (macOS Security)¶

Right-click the app → Open → Open anyway. This is required for unsigned apps.