Difference between revisions of "How To Install rTorrent"

From AwkwardTV
Jump to: navigation, search
(New page: ==rTorrent== What you will need: # Copy of rTorrent compiled for Intel OS X. # Copies of <code>tar</code>, <code>bzip2</code> and <code>bunzip2</code> from [http://www.opensource.apple.com...)
 
Line 1: Line 1:
==rTorrent==
+
==rTorrent - What you will need:==
What you will need:
+
# [http://code.google.com/p/rtorrent-appletv/ Copy of rTorrent] compiled for Intel OS X.
# Copy of rTorrent compiled for Intel OS X.
 
# Copies of <code>tar</code>, <code>bzip2</code> and <code>bunzip2</code> from [http://www.opensource.apple.com/darwinsource/images/darwinx86-801.iso.gz Darwin x86 ISO]. (Located in <code>/usr/bin</code>&nbsp;)
 
#* Having <code>nano</code> and <code>screen</code> helps a lot, too.
 
 
# An AppleTV set up with SSH access.
 
# An AppleTV set up with SSH access.
 +
# Patience, padawan.
  
 
==Here is how to install!==
 
==Here is how to install!==
First, gather the necessary files together in a single folder for ease of organization (not necessary though), and use scp (or your favorite ftp or sftp client, such as [http://cyberduck.ch/ Cyberduck] on OS X or [http://filezilla.sourceforge.net/ FileZilla] on Windows - see their instructions) to transfer them to your AppleTV. In the following examples, replace <code>192.168.0.5</code> with whatever your AppleTV's address is. Open up Terminal.app and do:
+
As with anything in Unix, there's usually a few ways to do things. Clearly things will differ if you have your own username set up on the AppleTV, if you set up a different sshd, if you used a pre-authorized key, and so on. I will center this on how-to from a relatively stock OS X perspective. First, unarchive the file on your local machine, and use scp (or your favorite ftp or sftp client, such as [http://cyberduck.ch/ Cyberduck] on OS X, or [http://filezilla.sourceforge.net/ FileZilla] on Windows - see their instructions) to transfer them to your AppleTV. In the following examples, replace <code>192.168.0.5</code> with whatever your AppleTV's address is. On OS X, open up Terminal.app and do:
<pre>scp tar frontrow@192.168.0.5:
+
<pre>scp -1r rtorrent-0.7.4-osx frontrow@192.168.0.5:</pre>
scp bunzip2 frontrow@192.168.0.5:</pre>
 
Or, if all your files are in the same folder, open up Terminal.app, go to that folder, and do:
 
<pre>cd myfoldername
 
scp * frontrow@192.168.0.5:</pre>
 
 
 
 
Now, log in to your AppleTV with SSH:
 
Now, log in to your AppleTV with SSH:
 
<pre>ssh frontrow@192.168.0.5</pre>
 
<pre>ssh frontrow@192.168.0.5</pre>
  
 
Once you're in, do:
 
Once you're in, do:
<pre>./bunzip2 rtorrent-0.7.4-osx.tar.bz2
+
<pre>cd rtorrent-0.7.4-osx
./tar xvf rtorrent-0.7.4-osx.tar</pre>
+
sudo ./installme</pre>
Alternately, you can copy <code>tar</code>, <code>bzip2</code> and <code>bunzip2</code> to your <code>/usr/bin</code> directory (see next step!) This will make your root filesystem writable, so be careful.
 
<pre>sudo mount -uw /</pre>
 
(The next step is optional!)
 
<pre>sudo cp -n tar /usr/bin
 
sudo cp -n bzip2 /usr/bin
 
sudo cp -n bunzip2 /usr/bin
 
sudo cp -n nano /usr/bin
 
sudo cp -n screen /usr/bin</pre>
 
Note that these must be correctly chmodded, if they are not already, with<br><code>chmod +x &lt;filename&gt;</code><br>before you copy or<br><code>sudo chmod +x /usr/bin/&lt;filename&gt;</code><br>afterward. They may not need this, but I don't think it hurts to do it again if you're in doubt. Anyway, then you don't need to type "./" in front of executing these commands anymore. If you do this before extracting the rTorrent archive, you can use<br><code>tar xjvf rtorent-0.7.4-0sx.tar.bz2</code> - all one step.<br>
 
Since the root filesystem is still writable, we need to &mdash; if they do not already exist &mdash; create the following directories:
 
<pre>sudo mkdir -p /usr/local/bin
 
sudo mkdir /usr/local/lib</pre>
 
Then move our files into place!
 
<pre>sudo cp rtorrent-0.7.4-osx/rtorrent /usr/local/bin
 
sudo cp rtorrent-0.7.4-osx/libtorrent.* /usr/local/lib
 
sudo mount -ur /</pre>
 
  
 
==Environment==
 
==Environment==
 
Now you may create a file called <code>.profile</code> in your home directory, either by using <code>nano</code> and pasting the following, or just do:
 
Now you may create a file called <code>.profile</code> in your home directory, either by using <code>nano</code> and pasting the following, or just do:
 
<pre>echo export PATH="/bin:/sbin:/usr/local/bin:/usr/bin:/usr/sbin" > ~/.profile</pre>
 
<pre>echo export PATH="/bin:/sbin:/usr/local/bin:/usr/bin:/usr/sbin" > ~/.profile</pre>
 +
''CAUTION!  This will erase the previous contents of your ~/.profile file, if one already existed!''
 
There is also a more global way of doing this, if you set up your path in the file <code>/etc/profile</code>
 
There is also a more global way of doing this, if you set up your path in the file <code>/etc/profile</code>
  
 
Now just run <code>rtorrent</code>, or better yet, <code>screen rtorrent</code> and you have a text-mode BitTorrent client on your AppleTV! What's more convenient than that! The basics of using screen is to type Ctrl+A then Ctrl+D and you can exit out of things, but leave rTorrent running. Next time you need to access it, SSH back in to your AppleTV and type <code>screen -rd</code> and boom!
 
Now just run <code>rtorrent</code>, or better yet, <code>screen rtorrent</code> and you have a text-mode BitTorrent client on your AppleTV! What's more convenient than that! The basics of using screen is to type Ctrl+A then Ctrl+D and you can exit out of things, but leave rTorrent running. Next time you need to access it, SSH back in to your AppleTV and type <code>screen -rd</code> and boom!
 +
 +
==Resources==
 +
[http://libtorrent.rakshasa.no/ rTorrent site] - Read the man page and the common tasks!<br>
 +
[http://code.google.com/p/rtorrent-appletv/ Where to get rTorrent for AppleTV] - I think this will work on MacBook (Pro) and Mac Minis as well. Someone please let me know if you have tried.

Revision as of 13:01, 1 June 2007

rTorrent - What you will need:

  1. Copy of rTorrent compiled for Intel OS X.
  2. An AppleTV set up with SSH access.
  3. Patience, padawan.

Here is how to install!

As with anything in Unix, there's usually a few ways to do things. Clearly things will differ if you have your own username set up on the AppleTV, if you set up a different sshd, if you used a pre-authorized key, and so on. I will center this on how-to from a relatively stock OS X perspective. First, unarchive the file on your local machine, and use scp (or your favorite ftp or sftp client, such as Cyberduck on OS X, or FileZilla on Windows - see their instructions) to transfer them to your AppleTV. In the following examples, replace 192.168.0.5 with whatever your AppleTV's address is. On OS X, open up Terminal.app and do:

scp -1r rtorrent-0.7.4-osx frontrow@192.168.0.5:

Now, log in to your AppleTV with SSH:

ssh frontrow@192.168.0.5

Once you're in, do:

cd rtorrent-0.7.4-osx
sudo ./installme

Environment

Now you may create a file called .profile in your home directory, either by using nano and pasting the following, or just do:

echo export PATH="/bin:/sbin:/usr/local/bin:/usr/bin:/usr/sbin" > ~/.profile

CAUTION! This will erase the previous contents of your ~/.profile file, if one already existed! There is also a more global way of doing this, if you set up your path in the file /etc/profile

Now just run rtorrent, or better yet, screen rtorrent and you have a text-mode BitTorrent client on your AppleTV! What's more convenient than that! The basics of using screen is to type Ctrl+A then Ctrl+D and you can exit out of things, but leave rTorrent running. Next time you need to access it, SSH back in to your AppleTV and type screen -rd and boom!

Resources

rTorrent site - Read the man page and the common tasks!
Where to get rTorrent for AppleTV - I think this will work on MacBook (Pro) and Mac Minis as well. Someone please let me know if you have tried.