Desktop · Full client

Get the app

The Linux AppImage, universal macOS .app, and Windows setup are the full Torrentech client: in-app wallet, pin, free download, comments, and upload. Ceramic is bundled on Linux and macOS. It is not a sidecar in the Windows installer.

Unsigned

Builds are not Apple-notarized or Authenticode-signed. macOS blocks the first open until you click Open Anyway. Windows SmartScreen may warn on the first setup run; choose More info → Run anyway.

What you can doDesktop appWeb
InstallLinux AppImage, macOS .app, or Windows setupBrowser + Ethereum web wallet add-on
WalletIn-app (create or import)Ethereum web wallet add-on
Browse & searchYesYes
Pay TTT and downloadYesYes
Free download (cooldown)YesNo
Pin / earn TTTYes — pin and earnNo
Comments, votesYesThreads display; posting needs desktop
UploadYesNo

1. Linux, macOS, and Windows

Linux AppImage and .deb (plus apt under /downloads/apt/), universal macOS zip, and Windows setup are the published desktop builds. Ceramic is bundled on Linux and macOS only; the Windows installer ships Kubo alone.

Linux

AppImage / .deb

Ubuntu 24.04+ (glibc 2.39). AppImage needs no install. Prefer apt for upgrades, or download the .deb once.

macOS

Torrentech.app

Universal (Apple Silicon and Intel). Unzip, drag into Applications. macOS 14+ recommended. First open is blocked until you click Open Anyway.

Windows

Setup

Windows 11, 64-bit. Run the installer. Kubo is bundled. Ceramic is not — catalog reads come from the fileserv replica, and writes stay on ceramic.torrentech.org.

2. Install and run

  1. macOS — unzip Torrentech-macos.zip, drag Torrentech.app into /Applications, then open it. The first launch is blocked until you allow it — macOS first open.
  2. Linux (AppImage) —
    chmod +x Torrentech-linux-x86_64.AppImage
    ./Torrentech-linux-x86_64.AppImage
  3. Linux (apt) — after the keyring is published under /downloads/apt/:
    curl -fsSL -o torrentech-archive-keyring.deb \
      https://www.torrentech.org/downloads/apt/torrentech-archive-keyring.deb
    sudo dpkg -i torrentech-archive-keyring.deb
    sudo apt update
    sudo apt install torrentech
    Or sudo dpkg -i Torrentech-linux-amd64.deb without apt.
  4. Windows — run Torrentech-windows-x86_64-setup.exe. If SmartScreen blocks it, use More info → Run anyway. Ceramic is not installed with this build.
  5. Quit from the tray menu so the bundled nodes stop cleanly.

3. macOS — allow the first open

The Mac build is not Apple-notarized. After a browser download, macOS Gatekeeper treats it as an unidentified developer. That is expected. The app still runs once you allow it.

First open

Double-click once so Settings shows the block. Then System Settings → Privacy & Security → Open Anyway. Enter your password or use Touch ID, then confirm the second dialog.

  1. Open Torrentech.app. macOS will refuse and say the developer cannot be verified, or that Apple cannot check it for malicious software.
  2. Open System Settings → Privacy & Security.
  3. Scroll to the message that Torrentech was blocked.
  4. Click Open Anyway. Authenticate, then confirm Open on the follow-up dialog.
  5. The app should launch. Later opens on this Mac do not need this again unless you download a new copy.

A managed or work Mac may hide Open Anyway. Right-click → Open is not enough on recent macOS.

4. First launch — in-app wallet

  1. Create a new wallet or import an existing one. The app runs on Arbitrum One (chain ID 42161).
  2. If you created the wallet in the app, back up the recovery phrase offline. If you imported one, keep using the backup you already have.
  3. You need a little ETH on Arbitrum One for gas, and TTT for paid downloads (default 2 TTT burned). Contract: 0x52Ca05fF11c9b5c3c27A232066604ecE048F8334 (Arbiscan).
  4. Free download unlocks one format per cooldown (default 7 days) without burning TTT — still needs gas. Web has no free download.

5. Browse, pay, pin

  1. Browse and search are always free.
  2. Open a release. Unlock a format with Pay TTT or Free download.
  3. Save with Download .tar / .zip, or Download and Pin to keep a durable copy on the bundled IPFS node. Album audio on the mesh is encrypted; the app decrypts it after unlock.
  4. Profile editing, comments, votes, and upload live in the desktop app. Upload and pin: Pinner guide.

6. Ceramic and IPFS

You do not install an Ethereum web wallet add-on or IPFS Desktop. Linux and macOS start a local Ceramic replica and a Kubo node. Windows does not ship Ceramic. That build bundles Kubo only. Catalog reads use the fileserv replica; Ceramic writes still go to ceramic.torrentech.org. Kubo joins the public IPFS mesh. Status lines in the UI show Ceramic and IPFS state.

Wait until the IPFS This machine cell shows a peer count before relying on local pins of gated releases. If local IPFS is down, gateway downloads still work; only pinning is skipped.

GUIBo (optional)

Want a separate Kubo window? GUIBo is a third-party Qt GUI. Not required — this app already bundles Kubo. Trial is limited; lifetime US $5 in USDT / USDC / DAI on Ethereum mainnet (not Arbitrum). Details: Pinner → GUIBo.

Getting help