Transmissionic

Transmissionic is a free multi-platform remote for Transmission Daemon built with Ionic and Vue.js.
It can be used as Web Interface, Android/iOS app and Windows/Linux/macOS program.

About

Main features

Manage multiple servers
Add torrent from local file or magnet link
Drag & drop torrent file
Magnet protocol support
Start/stop/reannounce/verify/delete one or more torrents
Modify torrent's options
Set the location of a torrent
Select and rename torrent's files
Edit tracker list
View the list of peers with country flags
Sort torrents by trackers
Open files in explorer
Use presets when adding torrents

Screenshots

Translation

Available languages:

Czech (Cyril Veverka, Ti)
German (Alain Nussbaumer)
Austrian German (Alain Nussbaumer, Tobias W)
Greek (Dtheofilopoulos)
English
Chilean Spanish (Sebastian)
Costa Rican Spanish (Zenón Monge)
French
Swiss French (Alain Nussbaumer, ZertyCraft)
Hungarian (Daniel)
Italian (Emanuele Ruzza)
Korean (Mild_Coffee)
Dutch (John)
Polish (Matthew)
Portuguese (Humberto Faria)
Brazilian Portuguese (JFSilvaBr)
Russian (Alek Depler)
Slovak (Tomas)
Ukrainian (Oleksandr Popov, stanol)
Chinese (simplified) (Cuiweiqiang dlnu, xiatian)
Chinese (traditional) (Steven F)

You can help with the translation by joining the project on POEditor. If your language is not availaible, feel free to add it.

Thanks to all contributors.

Compatibility

Web UI

Browser	Chrome	Firefox	Safari	Edge	IE	Chrome for Android	Safari on iOS
Version	≥23 ✔	≥21 ✔	≥6 ✔	≥79 ✔	❌	≥90 ✔	≥6 ✔

Application

OS	Windows	Linux	macOS	Android	iOS
Version	≥10 ✔	✔	≥10.11 ✔	≥5.0 ✔	≥12 ✔

Motivations

Provide a unified interface for all platforms
Improve myself on Vue.js and Ionic
Get familiar with GitHub

Inspirations

Interface and features inspired by Transmission Remote and Transmission Remote GUI.

Installation

You must first enable remote access in Transmission settings.

Web UI

Download Transmissionic-webui-[version].zip from the latest release page and unzip it.

Method 1

Set an environment variable named TRANSMISSION_WEB_HOME with the path of the extracted folder as value.

Example:

export TRANSMISSION_WEB_HOME=/path/to/transmissionic/folder

Method 2

Note: On older versions of Transmission, the public_html folder is named web

Copy the content of the extracted folder to the public_html folder of Transmission, whose location varies depending on your operating system:

Windows

C:\Program Files\Transmission\public_html

Linux

/usr/share/transmission/public_html

macOS

/Applications/Transmission.app/Contents/Resources/public_html

Don't forget to save your current public_html folder if you want to switch back.

Linux

Download the AppImage from the latest release page.

It's recommended to use AppImageLauncher to take advantage of the torrent file assosiation and magnet link handling.

macOS

Download the DMG from the latest release page.

When you try to install it, you will get an error. After getting the error, go to System Preferences > Security & Privacy and click on Open Anyway.

iOS

Download the IPA from the latest release page.

Use a tool like AltStore to sideload the app on your device.

Other

Simply download the installer for the desired platform from the latest release page and install it.

Configuration

Web UI

You don't need to specify the server details as they will be automatically detected from the URL of the Web UI.

Default settings

The settings are stored on the client side, but you can overwrite the default settings by creating a file named default.json in the root folder of the Web UI.

The file can contain the following key/value pairs:

Key	Type	Description	Default
colorScheme	`string`	Possible values: `light` or `dark`	System default
language	`string`	An ISO 639-1 language code, example: `en-US`	System default
orderBy	`string`	Possible values: `name`, `addedDate`, `sizeWhenDone`, `uploadRatio`, `uploadedEver`, `rateUpload`, `activityDate`, `queuePosition`	`addedDate`
reverse	`boolean`	Reversed ordering	`true`
useBits	`boolean`	Display speed in bit/s	`true`
expandMenu	`boolean`	Expand side menu on large screen	`true`
searchByName	`boolean`	Search torrents by name	`true`
searchByDirectory	`boolean`	Search torrents by download directory	`true`
ipFlags	`boolean`	Display peer flag	`false`
openMagnetLinks	`boolean`	Open magnet links with Transmissionic	`false`
rememberSelectedPreset	`boolean`	Remember selected preset when adding torrents	`false`
compactMode	`boolean`	Compact torrent list	`false`
showTrackerList	`boolean`	Always show the list of trackers in the side menu	`false`
refreshInterval	`number`	Refresh interval in seconds	`5`
timeout	`number`	Connection timeout in seconds	`10`
servers	`array`	Default servers	`[]`

Server object:

Key	Type	Description
name	`string`	Name to display
host	`string`	Hostname or IP address of Transmission RPC
path	`string`	Path of Transmission RPC
port	`number`	Port of Transmission RPC
https	`boolean`	Use HTTPS

Configuration file example:

{
  "colorScheme":"dark",
  "language":"en",
  "orderBy":"name",
  "reverse":false,
  "ipFlags":true,
  "refreshInterval":10,
  "timeout":20,
  "servers":[
    {
      "name":"My server",
      "host":"transmission.myserver.com",
      "path":"/my/transmission/rpc",
      "https":true
    }
  ]
}

Magnet protocol

You can handle magnet links directly with the Web UI, but this feature is only available in secure contexts (HTTPS) or from localhost.

To use the Web UI in HTTPS, you must set up a reverse proxy: [GUIDE] Transmission web in SSL (https) - using nginx as a reverse proxy

List of supported browsers: Browser compatibility

Bookmarklet

When using the Web UI, you can import magnet and torrent links using a bookmarklet. To set up the bookmarklet, open the Web UI settings and simply drag and drop the corresponding button into your bookmarks bar.

You can use the text selection to highlight a magnet link or a hash before cliking on the bookmarklet, otherwise the script will look for a clickable magnet or torrent link in the page.

For mobile users:

Long-press the bookmarklet button and select "Copy link address".
Add the current page to your favorites and edit the bookmark.
Replace the address with the one you previously copied and change the name to "Download with Transmissionic".
Go on a torrent page.
Tap on the address bar, search for "Download with Transmissionic" and select the bookmark. (Screenshot)

Electron

Magnet protocol

To handle magnet links in Windows, you need to set Transmissionic as the default program.

To do so, go to "Choose default apps by protocol" in the Windows settings, scroll down to "MAGNET" then select Transmissionic.

Path mapping

You can configure path mapping on computer, this allow you to match remote paths with local paths to open the file explorer. This parameter works exactly the same way as Transmission Remote GUI.

Example:

/mnt/ssd = \\192.168.1.1\ssd

/mnt/ssd = Remote path on the server where Transmission daemon is running.

\\192.168.1.1\ssd = Local path to access the shared folder.

In this case, the remote server IP is 192.168.1.1, and the folder /mnt/ssd must be shared on the network as ssd.

Keyboard shortcuts

Keys	Action
`Alt` `T`	Open torrent
`Alt` `M`	Open magnet
`Alt` `U`	Open URL
`Alt` `S`	Settings
`Alt` `N`	New server
`Alt` `I`	Server information
`Alt` `C`	Server configuration
`Alt` `A`	About
`Alt` `1`-`9`	Select filter
`Cmd/Ctrl` `Alt` `S`	Search
`Cmd/Ctrl` `Alt` `T`	Toggle side menu
`Cmd/Ctrl` `RightArrow`	Next tab
`Cmd/Ctrl` `LeftArrow`	Previous tab
`Shift` `Click`	Select torrent
`Ctrl` `A`	Select all
`Esc`	Cancel selection

Build

Requirements

You must have Node.js installed, then you can clone this repo and install dependencies by running this in the root folder of the project:

npm install

If you want to build the APK, you must install Android Studio or JDK.

If you want to build the IPA, you must install Xcode.

Web UI

Simply run the following command:

npm run build:webui

This will build the Web UI inside the dist folder.

Electron

First, synchronize Electron content by running this in the root folder of the project:

npm run sync:electron

Then place your terminal in the electron folder and run this:

npm install

Windows

npm run electron:build-windows

Linux

npm run electron:build-linux

macOS

npm run electron:build-mac

The installer will be located in the electron/dist folder.

Android

Start by running this in the root folder of the project:

npm run sync:android

With Android Studio

Open Android Studio by running:

npx cap open android

Once Android Studio has loaded the project, build the app from Build > Make Project

Without Android Studio

Place your terminal in the android folder and run this:

./gradlew build

The APK will be located in the android/app/build/outputs/apk folder.

iOS

Start by running this in the root folder of the project:

npm run sync:ios

Then open Xcode by running:

npx cap open ios

Development

You can start a local dev server using Ionic, but you need to disable same origin policy in your browser to connect to Transmission RPC from a different host. For example, run a new instance of chrome with these flags : --disable-web-security --disable-gpu --user-data-dir=~/chromeTemp

Then start the dev server by running this in the root folder of the project:

npm run serve

If you want to contribute and pull your changes to this project, please work on the dev branch as it contains all the latest changes.

TODO

Add iOS/macOS support
Add server configurations modal
Add magnet url handling on Windows
~~Use ion-virtual-scroll when availaible for Vue.js~~

6c65726f79/Transmissionic

Transmissionic

About

Main features

Screenshots

Translation

Compatibility

Web UI

Application

Motivations

Inspirations

Installation

Web UI

Method 1

Method 2

Linux

macOS

iOS

Other

Configuration

Web UI

Default settings

Magnet protocol

Bookmarklet

Electron

Magnet protocol

Path mapping

Keyboard shortcuts

Build

Requirements

Web UI

Electron

Windows

Linux

macOS

Android

With Android Studio

Without Android Studio

iOS

Development

TODO