1
- # Transmission Remote TUI (trt)
2
- > A TUI for BitTorrent client transmission
1
+ # Transmission Remote TUI (` trt ` )
3
2
3
+ > A TUI for BitTorrent client transmission
4
4
5
- ![ torrent list] ( assets/torrents.png )
5
+ ![ torrent list] ( ./look/torrents.jpg )
6
+ ![ files] ( ./look/details.jpg )
6
7
7
- ![ peers ] ( assets/peers.png )
8
+ ## Installation
8
9
9
- ![ overview] ( assets/overview.png )
10
- <figcaption align = " center " ><b ><sup >**</sup >Yes! I am torrenting linux/bsd iso to evade legal issues</b ></figcaption >
10
+ ### Arch Linux
11
11
12
- ## Installation
12
+ * ` trt ` is available in the ` AUR ` (packaged by the developer himself)
13
13
14
- #### Arch Linux
15
- - ` trt ` is available in the AUR(packaged by the developer himself)
16
14
``` bash
17
- $ yay -S transmission-remote-tui-git
15
+ yay -S transmission-remote-tui-git
18
16
```
19
17
20
- #### From source
21
- - Build dependencies: ` go `
18
+ ### From source
19
+
20
+ * Build dependencies: ` go `
22
21
23
22
``` bash
24
- $ git clone https://github.com/Murtaza-Udaipurwala/transmission-remote-tui
25
- $ cd transmission-remote-tui
26
- $ make
27
- $ sudo make clean install
23
+ make && sudo make install clean
28
24
```
29
25
30
26
## Usage
31
- - The actual binary is called ` trt `
32
27
33
- - Transmission daemon must be running
28
+ * The actual binary is called ` trt `
29
+ * Transmission daemon must be running
30
+
34
31
``` bash
35
- $ transmission-daemon &
32
+ transmission-daemon &
36
33
```
37
34
38
- - In case you have changed the default transmission rpc port(9091), specify the new port
35
+ * Remote ` RPC ` URL
36
+
39
37
``` bash
40
- $ trt --port < new port >
38
+ trt --url http://203.12.65.10:9091/transmission/rpc
41
39
```
42
40
43
- - In case you enabled authentication, specify the username and password
41
+ * Authenticate, if required
42
+
44
43
``` bash
45
- $ trt --username < username> --password < password>
44
+ trt --username < username> --password < password>
46
45
```
47
46
48
- - Navigation
47
+ * Version
49
48
50
- | keybinding | Action |
51
- | ------------| ---------------------------------------------|
52
- | h, j, k, l | move around |
53
- | g | scroll the to top of the page |
54
- | G | scroll the to bottom of the page |
55
- | q | quit / go back |
56
- | Q | kill the transmission daemon |
57
- | l, enter | show more details about a torrent |
58
- | K | move torrent up the queue |
59
- | J | move torrent down the queue |
60
- | U | move torrent at the top of the queue |
61
- | D | move torrent at the bottom of the queue |
62
- | p | pause/start torrent |
63
- | r | remove torrent |
64
- | R | remove torrent and delete all the files |
65
- | v | verify torrent |
66
- | t | ask trackers for more peers |
67
- | m | copy magnet link to clipboard |
68
-
69
- - Changing file's priority
49
+ ``` bash
50
+ trt --version
51
+ ```
52
+
53
+ * Navigation
54
+
55
+ | keybinding | Action |
56
+ | ------------| ----------------------------------------------------|
57
+ | h, j, k, l | move around |
58
+ | g | scroll to the top of the page |
59
+ | G | scroll to the bottom of the page |
60
+ | q | quit / go back |
61
+ | Q | kill the transmission daemon |
62
+ | l, enter | show more details about a torrent |
63
+ | K | move torrent up the queue |
64
+ | J | move torrent down the queue |
65
+ | U | move torrent at the top of the queue |
66
+ | D | move torrent at the bottom of the queue |
67
+ | p | pause/start torrent |
68
+ | r | remove torrent |
69
+ | R | remove torrent and delete corresponding local data |
70
+ | v | verify torrent |
71
+ | t | ask trackers for more peers |
72
+ | m | copy magnet link to clipboard |
73
+
74
+ * Changing file's priority
70
75
71
76
| keybinding | Action |
72
77
| ------------| ---------------------------------------------|
@@ -80,57 +85,33 @@ $ trt --username <username> --password <password>
80
85
| N | change priority of all files to 'normal' |
81
86
| H | change priority of all files to 'high' |
82
87
83
- ## Uninstalling
88
+ ## Uninstall
89
+
84
90
``` bash
85
- $ sudo make uninstall
91
+ sudo make uninstall
86
92
```
87
93
88
94
## Further reading
89
95
90
- ### Setting up mimeapp entry
91
- - ` trt ` does not have the ability to read/add torrent files/magnet
92
- links(however, it can be added rather easily). This is because you don't
93
- really need this feature.
94
-
95
- - Simply create a mimeapp entry, telling it what to do when it finds a torrent file/magnet link
96
- ``` bash
97
- # File: ~/.config/mimeapps.list
98
- # xdg-open will use these settings to determine how to open filetypes.
99
-
100
- [Default Applications]
96
+ * ` trt ` does not have the ability to read new torrent files/magnet links.
97
+ Use [ transmission-remote] ( https://linux.die.net/man/1/transmission-remote )
98
+ for that.
101
99
102
- # These .desktop entries can also be seen and changed in ~/.local/share/applications/
103
- x-scheme-handler/magnet=torrent.desktop;
104
- application/x-bittorrent=torrent.desktop;
105
- ```
100
+ * Adding ` mimeapp ` entry
106
101
107
- - Now we must create torrent.desktop file under ` ~/.local/share/applications/ `
108
102
``` bash
109
103
# File: ~/.local/share/applications/torrent.desktop
110
104
111
105
[Desktop Entry]
112
106
Type=Application
113
107
Name=Torrent
114
- Exec=/usr/bin/env transadd %U
108
+ Exec=/usr/bin/env transmission-remote -a %U
115
109
```
116
110
117
- - ` transadd ` is a shell script in my ` PATH ` . This is the script that tells
118
- ` transmission daemon ` to add our torrent
119
111
``` bash
120
- #! /bin/sh
121
-
122
- # Mimeapp script for adding torrent to transmission-daemon, but will also start
123
- # the daemon first if not running. transmission-daemon sometimes fails to take
124
- # remote requests in its first moments, hence the sleep.
112
+ # File: ~/.config/mimeapps.list
125
113
126
- pidof transmission-daemon > /dev/null || transmission-daemon &
127
- sleep 3
128
- # notify-send "🔽 Adding Torrent"
129
- exec transmission-remote -a " $@ "
114
+ [Default Applications]
115
+ x-scheme-handler/magnet=torrent.desktop;
116
+ application/x-bittorrent=torrent.desktop;
130
117
```
131
-
132
- [ Video tutorial on setting up mimeapp entry] ( https://odysee.com/@Luke:7/torrenting-setup-with-transmission:1 ) (the TUI program used is ` transmission-remote-cli ` instead of ` trt ` )
133
-
134
-
135
- #### All pull requests are welcomed
136
- #### Open issues for discussion/bug report
0 commit comments