Skip to content

d4rken-org/octi-desktop

Repository files navigation

Octi Desktop

GitHub release Code tests & eval Gradle wrapper License Discord

Desktop companion for Octi — view your phone's modules and share files between your devices from your laptop. Talks to the existing Octi Server over the same end-to-end-encrypted protocol the Android app uses. No Google account, no separate backend.

Install

Two release channels are published as GitHub Releases:

  • Stable — the build to use unless you have a reason not to.
  • Canary — bleeding-edge build, rebuilt on every merge to main. Installs as a separate "Octi Canary" app that coexists with your stable install. Expect breakage.

Each release publishes installers for Linux, macOS (Apple Silicon + Intel), and Windows, plus a checksums.txt with SHA-256 hashes.

Linux

# Debian/Ubuntu
sudo apt install ./octi_<version>_amd64.deb
sudo apt install libsecret-tools     # required for OS keystore credential storage

# Fedora/RHEL
sudo dnf install ./octi-<version>.x86_64.rpm
sudo dnf install libsecret           # provides secret-tool

# Portable
chmod +x Octi-<version>-linux-x86_64.AppImage && ./Octi-<version>-linux-x86_64.AppImage
# or
tar xzf Octi-<version>-linux.tar.gz && ./Octi/bin/Octi

libsecret-tools is required for credential storage on Linux. Without it the app falls back to a per-launch passphrase prompt.

macOS

The current releases are unsigned — Gatekeeper will refuse to launch them on first try. To open:

  1. Open the .dmg and drag Octi to /Applications
  2. Right-click /Applications/Octi.appOpen → confirm in the warning dialog (once per machine)

Code-signing + notarization require a paid Apple Developer membership; until then, this is the workaround.

Windows

The MSI is unsigned — SmartScreen will warn on first launch. To install:

  1. Double-click the .msi. SmartScreen pops up: click More infoRun anyway
  2. Follow the installer prompts

Code-signing on Windows requires an Authenticode certificate; planned for a later release.

From source

Requires JDK 21 (the Gradle toolchain provisions it automatically; system Java just needs to be 17+).

./gradlew run                  # run from source

Link to your phone

  1. On your Android phone, open Octi → Sync servicesOcti ServerGenerate linking code
  2. On the desktop, paste the code into the welcome screen
  3. Your devices appear in the dashboard within a few seconds

Screenshots

Community

Join the Octi Discord.

Octi ecosystem

  • Octi — the Android app.
  • Octi Server — the end-to-end encrypted sync-server.
  • Octi Web — browser client for the same sync-server.
  • Octi Desktop — this Compose Multiplatform desktop client (Linux / macOS / Windows).

License

Octi Desktop's code is available under a GPL v3 license, this excludes:

  • Octi icons, logos, mascots, marketing materials and assets.
  • Octi animations and videos.
  • Octi documentation.
  • Translations.

About

A desktop client for Octi: A multi-device manager.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages