Skip to content

About

Transmission remote control for macOS — a native SwiftUI client for the Transmission BitTorrent daemon.

Topics

Resources

Stars

30 stars

Watchers

0 watching

Forks

Repository files navigation

TransmissionSwift

A native Transmission remote control for macOS. A lightweight, SwiftUI-based alternative to Transmission Remote GUI (transgui) for managing a remote Transmission BitTorrent daemon.

Release Build Stars macOS Swift

TransmissionSwift app icon

Transmission remote control for macOS

TransmissionSwift is a native macOS Transmission remote client. It connects to a remote Transmission BitTorrent daemon over RPC, so you can manage your torrents from your Mac without a browser or a web UI — a modern replacement for Transmission Remote GUI (transgui).

There's a remote setup guide, an FAQ and a comparison with Transmission Remote GUI on the project site.

Features
  • Manage active torrents
    • Start/pause
    • Delete, with or without data
    • Verify
    • Update tracker
    • Set priority, set files as unwanted
    • Change download location
  • Add new torrents
    • via .torrent files (drag+drop, or register handler for .torrent files)
    • magnet links or torrent URLs via UI
  • Change server settings
    • Enable slow mode
    • Networking config
    • Seeding config
  • Combining filters in the sidebar
  • Managing torrent labels and assigning colour coding to them
  • Path mapping via custom URI patterns
    • Open your files with whatever app you want
    • A few ready presets to open in Cyberduck, reveal in Finder (mounted or not), Open in default app, View in Swizzin web
  • App self-updating via Sparkle
  • Automatable via Shortcuts.app, Spotlight and Siri
    • Get servers and torrents, and open a torrent from Spotlight
    • Add torrents from files, magnet links or URLs (start paused, choose destination, labels, priority)
    • Pause/resume torrents, remove (with or without data), verify, re-announce
    • Get server and torrent stats, and free space
    • Toggle slow (turtle) mode; set server and per-torrent speed limits

It is written in Swift and SwiftUI, compiling down to a ~4MB app with minimal resource use.

TransmissionSwift main window showing a list of torrents

How to open it

  1. Download latest unsigned release

  2. Find in your downloads, and unzip

  3. Try to open the unsigned app (it will fail). Do not move to trash, just select "Done"

    Screenshot macOS Gatekeeper blocking the unsigned TransmissionSwift app on first launch
  4. Follow instructions here to bypass the verification (duplicated below for the lazy)

    Screenshot + Instructions macOS Privacy & Security settings with Open Anyway button
    1. On your Mac, choose Apple menu > System Settings, then click Privacy & Security in the sidebar. (You may need to scroll down.)
    2. Go to Security, then click Open.
    3. Click Open Anyway. This button is available for about an hour after you try to open the app.
    4. Enter your login password, then click OK.
  5. Open again

Alternatively, you can open the project in Xcode and build it from there.

What's being planned

  1. iCloud Sync for settings (Not until I get a Dev license)
  2. Desktop Widgets (Not until I get a dev license)
  3. iPhone Version

Contributing

I will prioritise reviewing any contributions that help overall stability, performance, and the above mentioned plans.

Please familiarise yourself with the architecture and then feel free to do your thing.

License

TransmissionSwift is licensed under the Mozilla Public License 2.0.

MPL is file-level copyleft: you may fork, modify and redistribute it, including as a Mac App Store build, but any file that already carries the license notice and that you change has to be published under MPL-2.0 with its source. Files you add yourself are yours to license however you like.

Forking is welcome. If the change is useful upstream, send it as a pull request here instead, so it does not have to be reconciled later and the release keeps it. No CLA is required; sign off your commits (git commit -s).

About

Transmission remote control for macOS — a native SwiftUI client for the Transmission BitTorrent daemon.

Topics

Resources

Stars

30 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages