Konductor

A Tauri application with system tray functionality for Linux.

Features

• System Tray Integration: The application runs in the system tray on Linux
• Tray Menu: Right-click the tray icon to access menu options:
  • Show Konductor: Shows the main application window
  • Hide Konductor: Hides the main application window
  • Quit: Exits the application
• Click to Toggle: Left-click the tray icon to show/hide the main window

Development

Prerequisites

• Node.js and npm
• Rust and Cargo
• Tauri CLI

Running the Application

1. Install dependencies:

   npm install

2. Start the development server:

   npm run tauri dev

Building for Production

npm run tauri build

Release Workflow

This project uses automated GitHub Actions for building and releasing:

Automatic Releases

When you merge code to the main branch, the pipeline automatically:

• Builds the application for Linux and Windows
• Creates a new release with an incremented patch version
• Uploads the built binaries to GitHub Releases

Manual Releases

For major/minor releases or manual builds:

# Create a manual release with specific version
./scripts/release.sh manual-release v2.0.0

# Check current release status
./scripts/release.sh check-status

Release Script

Use the included release script for easy release management:

# Show help
./scripts/release.sh help

# Check current status
./scripts/release.sh check-status

# Create automatic release (from main branch)
./scripts/release.sh auto-release

# Create manual release with specific version
./scripts/release.sh manual-release v2.0.0

For detailed information about the release workflow, see RELEASE_WORKFLOW.md.

System Tray Implementation

The system tray functionality is implemented using the tray-icon crate and includes:

• Tray Icon: Uses the application's 32x32 icon
• Context Menu: Provides show/hide/quit options
• Event Handling: Responds to left-click and menu item clicks
• Window Management: Controls the main application window visibility

Files

• src-tauri/src/tray_linux.rs: System tray implementation
• src-tauri/src/main.rs: Main application with tray integration
• src-tauri/tauri.conf.json: Tauri configuration with window settings

Platform Support

Currently tested and working on:

• Linux (Ubuntu 22.04+)
• Windows (with automated builds)

License

[Add your license here]