From AwkwardTV
Jump to: navigation, search
Links to illegal warez, etc. will be removed, and your access will be blocked. (Details)

atvTorrents for ATV V 1.0.2 Copyright © 2007 AK2007 and Nakko of AwkwardTV. All Rights Reserved. June 22, 2007

Download link: Click here to download

--- This Plugin has been updated to run with AppleTV Update 1.1 ---

atvTorrents plugin allows you to run and control rtorrent on AppleTV. It installs rTorrent to an AppleTV automatically as a LaunchAgent which will automatically start when the AppleTV boots. rTorrent is set to watch the directory "/Users/frontrow/Torrents" for new torrents. Whenever it finds a new torrent file it downloads its contents to "/Users/frontrow/Movies".

This is a follow-up to the earliear work by Nakko of researching and compiling rtorrent to run on AppleTV. Once we got rtorrent running we realized that there ought be a be a better way than ssh to manage it.

====IMPORTANT NOTE:==== If you already have a "/Users/frontrow/.rtorrent.rc" in your system please either remove it rectly. This page has a sample rtorrent.rc file with comments in it Also see How_To_Install_rTorrent page for additional information and resources Contents of .rtorrent.rc included with awkwardTV

 ## ATVrTorrent
 max_peers = 60
 max_peers_seed = 20
 max_uploads = 8
 # Don't touch max_open_files!! Do not use it!!
 # max_open_files = !DO NOT USE!
 # Not sure what a nice value is for sockets yet.. may not be becessary
 # max_open_sockets = 
 max_memory_usage = 128M
 directory = ~/Movies/Downloads
 session = ~/.inprogress
 # Do Not change session and watch_direcotory  
 # if using with atvTorrents
 schedule = watch_directory,15,15,load_start=~/Torrents/*.torrent
 # ##################
 schedule = tied_directory,15,15,start_tied=
 schedule = untied_directory,15,15,close_untied=
 schedule = low_diskspace,5,60,close_low_diskspace=100M
 on_start = link2,create_link=base_path,,.In_Progress
 on_finished = link2,delete_link=base_path,,.In_Progress
 on_erase = link2,delete_link=base_path,,.In_Progress
 on_finished = link3,"create_link=base_filename,~/Movies/,"
          • You DO NOT need to install rtorrent yourself, the plugin will do that for you ****

Here are some things you can't or shouldn't change: 1. Location of rtorrent watchfolder - Required /Users/frontrow/Torrrents 2. Location of rtorrent session folder - Required /Users/frontrow/.inprogress 3. Location of .rtorrent.rc file - Required /Users/frontrow/.rtorrent.rc

Controlling rtorrent from using atvTorrents

The Agent Status Menu shows the current status of the Launch Agent and lets you toggle it.

 The Running button lets you start and stop rTorrent.   
 The Schedule Torrents button allows you to browse the file system starting from 
 /Users/frontrow and select files.  Once you select a file it is automatically copied to 
 the ~/Torrents folder.
 The Stop Active Torrents button lets you view active torrents, if you select one it will delete 
 the torrent from ~/Torrents folder. This will force rtorrent to stop the download.  
 The download files will have to be deleted manually.
 The Clear Cache buttons clears the rtorrent caches. rtorrent keeps a cache of all torrents 
 that it processes over time this cache can grow, this button clears the cache.

Controlling rtorrent from ssh

rTorrent is launched using screen. When rTorrent is running you can attach to the running instance of screen by using the following command, You can either run it from the ...Plugins/ATVrtorrents.frappliance/Contents/Resources/screen or put a symlink to it to a friendly place as detailed further down:

 screen -r -S atvrtorrent

If you did a standard install of ATVTorrent - the command to create a symlink would likely be:

   ln -s /System/Library/CoreServices/ ./screen

Once that command line is run you can access the screen program using: ./screen -r -s atvrtorrent

Once the screen is loaded you can view the speed and download progress etc of your torrents.

To exit the screen and close it properly - CTRL-a-d

This will attach to the current running version of screen that is running rtorrent. The package includes the OpenDarwin version of screen since AppleTV doesn't have screen in it.

See How_To_Install_rTorrent page for additional details. Also visit rtorrent page for documentation.

If you try to run this on any machine other than an AppleTV you must modify the org.awkwardtv.atvrtorrent.plist in ~/Library/LaunchAgents and fix the appropriate paths in it. This file requires fully resolved paths. [image:awkwardTorrents.png]

Legal Information

Copyright © 2007 AK2007 and Nakko of awkwardTV. All Rights Reserved.

AppleTV is a registered trademark of Apple, Inc. AppleTV and BackRow are Copyright © 2006-2007 Apple, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, publish, and/or distribute copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. The authors are in no way affiliated with Apple, Inc.