Latest revision as of 19:16, March 10, 2015

Rtorrent

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Rtorrent is a command line bittorrent client.

Installation

if you intend to use rtorrent with www-apps/rutorrent or another front end make sure you emerge with the xmlrpc flag. (for now we'll also throw in the daemon until proven its not needed. the daemon is strange as its implemented in screen? its probably so you can attach/detach anywhere infinite times.)

root # echo "net-p2p/rtorrent xmlrpc daemon" >> /etc/portage/package.use #xmlrpc use flag for web interface.
root # emerge rtorrent

Configuration

The $USER should be changed to the torrent user you wish to download as.

/etc/conf.d/rtorrentd - select user

USER="$USER"

Example

logged in as the torrent user:

root # cd
root # wget https://gist.githubusercontent.com/bryanjswift/1525912/raw/34fe28d70709e6b12840bcede3b82e5ed2abccce/.rtorrent.rc

~/.rtorrent.rc is now an example & running config.

xml rpc

~/.rtorrent.rc - turn on xml rpc

scgi_port = localhost:5000

service

to run:

root # rtorrent

Using rtorrent as a daemon

With screen

screen should be installed with the 'daemon' USE flag so just enable that if you want to use screen.

Start rtorrent detached

root # screen -S rtorrent -d -m rtorrent

Resume detached session

root # screen -S rtorrent -r

Quit detached rtorrent session

root # screen -S rtorrent -X xon

Detach current session from this terminal

Ctrl+a d

Quit current rtorrent session

Ctrl+a q

With tmux

tmux can be used instead of Screen

Start rtorrent session detached (session named 'torrents')

root # tmux new-session -s torrents -n rtorrent -d rtorrent

Resume detached session

root # tmux attach -t torrents

Quit detached rtorrent session

root # tmux send-keys -t torrents:rtorrent C-q

Detach current session from this terminal

Ctrl+b d

Quit current rtorrent session

Ctrl+q

@@ Line 4: / Line 4: @@
 |Homepage=http://libtorrent.rakshasa.no/
 }}
-{{warning|this page is untested, and a work in progress.}}
 {{PageNeedsUpdates}}
 Rtorrent is a command line bittorrent client.
@@ Line 29: / Line 28: @@
 scgi_port = localhost:5000
 }}
+===service===
+to run:
+{{console|body=###i## rtorrent}}
+===Using rtorrent as a daemon===
+====With screen====
+[[Package:Screen (Terminal Multiplexer)|screen]] should be installed with the 'daemon' USE flag so just enable that if you want to use screen.
+* Start rtorrent detached
+{{console|body=###i## screen -S rtorrent -d -m rtorrent}}
+* Resume detached session
+{{console|body=###i## screen -S rtorrent -r}}
+* Quit detached rtorrent session
+{{console|body=###i## screen -S rtorrent -X xon}}
+* Detach current session from this terminal
+<b><code>Ctrl+a d</code></b>
+* Quit current rtorrent session
+<b><code>Ctrl+a q</code></b>
+====With tmux====
+[[Package:Tmux (Terminal Multiplexer)|tmux]] can be used instead of Screen
+* Start rtorrent session detached (session named 'torrents')
+{{console|body=###i## tmux new-session -s torrents -n rtorrent -d rtorrent}}
+* Resume detached session
+{{console|body=###i## tmux attach -t torrents}}
+* Quit detached rtorrent session
+{{console|body=###i## tmux send-keys -t torrents:rtorrent C-q}}
+* Detach current session from this terminal
+<b><code>Ctrl+b d</code></b>
+* Quit current rtorrent session
+<b><code>Ctrl+q</code></b>
 {{EbuildFooter}}

Difference between revisions of "Package:Rtorrent"