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 do | Desktop app | Web |
|---|---|---|
| Install | Linux AppImage, macOS .app, or Windows setup | Browser + Ethereum web wallet add-on |
| Wallet | In-app (create or import) | Ethereum web wallet add-on |
| Browse & search | Yes | Yes |
| Pay TTT and download | Yes | Yes |
| Free download (cooldown) | Yes | No |
| Pin / earn TTT | Yes — pin and earn | No |
| Comments, votes | Yes | Threads display; posting needs desktop |
| Upload | Yes | No |
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.
AppImage / .deb
Ubuntu 24.04+ (glibc 2.39). AppImage needs no install.
Prefer apt for upgrades, or download the .deb once.
Torrentech.app
Universal (Apple Silicon and Intel). Unzip, drag into Applications. macOS 14+ recommended. First open is blocked until you click Open Anyway.
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
- macOS — unzip
Torrentech-macos.zip, dragTorrentech.appinto/Applications, then open it. The first launch is blocked until you allow it — macOS first open. - Linux (AppImage) —
chmod +x Torrentech-linux-x86_64.AppImage ./Torrentech-linux-x86_64.AppImage - Linux (apt) — after the keyring is published under
/downloads/apt/:
Orcurl -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 torrentechsudo dpkg -i Torrentech-linux-amd64.debwithout apt. - Windows — run
Torrentech-windows-x86_64-setup.exe. If SmartScreen blocks it, use More info → Run anyway. Ceramic is not installed with this build. - 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.
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.
- Open
Torrentech.app. macOS will refuse and say the developer cannot be verified, or that Apple cannot check it for malicious software. - Open System Settings → Privacy & Security.
- Scroll to the message that Torrentech was blocked.
- Click Open Anyway. Authenticate, then confirm Open on the follow-up dialog.
- 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
- Create a new wallet or import an existing one. The app runs on
Arbitrum One (chain ID
42161). - 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.
- You need a little ETH on Arbitrum One for gas, and
TTT for paid downloads (default 2 TTT burned).
Contract:
0x52Ca05fF11c9b5c3c27A232066604ecE048F8334(Arbiscan). - 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
- Browse and search are always free.
- Open a release. Unlock a format with Pay TTT or Free download.
- 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.
- 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
- macOS “cannot be opened” / “developer cannot be verified.” Allow it once — macOS first open.
- Matrix public chat channel — #torrentech:matrix.org
- Staff contact — moderators may reach you via Matrix / email if you set those on your profile.