Getting started - adrian-bl/bitflu GitHub Wiki

Table of Contents

How to install Bitflu

  1. Download bitflu to /some/where
  2. cd /some/where
  3. tar -xzvf bitflu-$version.tgz
  4. mv bitflu-$version bitflu
  5. cd bitflu
  6. ./bitflu.pl
You can now connect to bitflu via telnet (telnet localhost 4001) or http (http://localhost:4081)

How to upgrade Bitflu

  1. Stop bitflu
  2. download the new version to /some/where
  3. tar -xzvf bitflu-$version.tgz
  4. rm -rf bitflu/bitflu.pl bitflu/plugins
  5. mv bitflu-$version/bitflu.pl bitflu-$version/plugins bitflu/ # move bitflu.pl and the plugins folder to your old bitflu directory
  6. rm -rf bitflu-$version*
  7. cd bitflu
  8. ./bitflu.pl

How to add a torrent file

Via autoload

Just drop the torrent into workdir/autoload . Bitflu will pickup new files each 5 minutes

Via the load command

Place the torrent on your disc and run 'load /path/to/torrent.torrent' Bitflu can also (sometimes) directly load torrent files via http. Just run:

 'load http://wwww.example.com/foo.torrent'

Bitflu also understands magnet URIs

 'load magnet:?xt=urn:btih:640fe84c613c17f663551d218689a64e8aebeabe&dn=slackware-12.2-dvd-iso'

Via webinterface

Just use the upload button

How do i view my download list (in telnet)

Just run the 'vd' (ViewDownloads) command and you'll get a list with all downloads:

 bitflu> vd
  *** Upload:   0.01 KiB/s | Download:   4.32 KiB/s | Peers:   3/ 10
 [Type] Name                     /================ Hash ================\  Peers  Pieces      Done (MB)       Done Ratio  Up   Down 
 [ bt ] Name of the Download    1237a496e9daaa6a286435aeb893871bb9987801   3/10   109/ 1930    13.6/  241.1    5% 1.57   4.0  6.3

The hash is also called the queue_id and is needed for certain commands. (FYI: The Hash is the same as the torrents info_hash)

How to remove a torrent

Just run:

 cancel queue_id

Completed (marked as yellow) torrents will just get removed from the queue: The data will remain on your disc. If the torrent was incomplete, bitflu will also remove the data. Note: You can also pause a torrent! See 'help pause' and 'help resume'

⚠️ **GitHub.com Fallback** ⚠️