Skip to content
Toss

Installation

Installation

Section titled “Installation”

Install Toss on your platform.

Desktop Platforms

Section titled “Desktop Platforms”

macOS

Section titled “macOS”
  1. Download the latest release from GitHub Releases
  2. Open the downloaded .dmg file
  3. Drag Toss.app to Applications folder
  4. Open Toss from Applications
  5. Grant accessibility permissions when prompted

Windows

Section titled “Windows”
  1. Download the latest release from GitHub Releases
  2. Run the installer or extract the portable version
  3. Launch toss.exe
  4. Windows may prompt for firewall permissions - allow access

Linux

Section titled “Linux”
  1. Download the AppImage from GitHub Releases
  2. Make it executable:
    Terminal window
    chmod +x toss-*.AppImage
  3. Run the AppImage:
    Terminal window
    ./toss-*.AppImage

Build from Source

Section titled “Build from Source”

Prerequisites

Section titled “Prerequisites”

All Platforms:

macOS:

  • Xcode (from App Store)
  • Xcode Command Line Tools: xcode-select --install
  • CocoaPods: brew install cocoapods

Linux (Debian/Ubuntu):

Terminal window
sudo apt-get update
sudo apt-get install -y clang cmake ninja-build pkg-config \
    libgtk-3-dev liblzma-dev libstdc++-12-dev

Windows:

  • Visual Studio 2022 with “Desktop development with C++” workload
  • Windows 10 SDK

Build Steps

Section titled “Build Steps”
Terminal window
# Clone the repository
git clone https://github.com/rennerdo30/toss-share.git
cd toss-share


# Run setup script (recommended)
./scripts/setup.sh


# Or manually build:
make build              # Build Rust components
make release-macos      # Build macOS app
make release-linux      # Build Linux app
make release-windows    # Build Windows app

Build outputs are placed in the dist/ directory.

Troubleshooting

Section titled “Troubleshooting”

macOS: “CocoaPods not installed”

Section titled “macOS: “CocoaPods not installed””
Terminal window
brew install cocoapods
cd flutter_app/macos && pod install

macOS: Xcode errors

Section titled “macOS: Xcode errors”
Terminal window
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

Flutter: Platform not enabled

Section titled “Flutter: Platform not enabled”
Terminal window
flutter config --enable-macos-desktop
flutter config --enable-linux-desktop
flutter config --enable-windows-desktop

General: Dependency issues

Section titled “General: Dependency issues”
Terminal window
cd flutter_app
flutter clean
flutter pub get

Next Steps

Section titled “Next Steps”