btpd-cgi

This is an attempt to create a fast web interface for the BitTorrent Protocol Daemon, using the C language and the CGI interface.

1. Dependencies

   • ClearSilver
   • libz
   • btpd sources in the btpd/ directory with its Makefile generated
   • libm
   • libcrypto (OpenSSL)
   • libfetch (FreeBSD)

2. Build and install First, ensure that you have all dependencies as described in 1.

   To get the btpd sources you can :

   • use git submodules if you have cloned the btpdcgi repository
   • download the latest tarball from the btpd website and extract it

   The build is configured by the config.mk file. You can edit it to fit your system or leave defaults. Then, it is the same old machinery:

   $ make

   make install

3. Configuration The btpdcgi configuration file is located in ${PREFIX}/etc/btpdcgi.conf The mandatories options are :

   • btpd_dir : path to the directory where the btpd socket live (the socket must be read/writable by the btpdcgi user)

   • content_dir : path to the directory where the downloaded files are saved (must by writable by the btpd user)

   Additionaly you can set :

   • refresh_interval (default=15) : time in seconds between refresh (list page)

   Usually, the btpdcgi user is the same as httpd, say www. It is recommanded that btpd run with its own user.

   To restrict your btpdcgi installation, you can configure a HTTP authentication with your httpd server.

   The btpd.cgi file is located in ${PREFIX}/bin/ and the style.css file in ${PREFIX}/share/btpdcgi/static. You might want to add aliases rules so that your httpd can serve them.