Compilar rTorrent desde SVN en Ubuntu Gutsy

Autor: Stephan Jau
Revisión: v1.0
Último cambio: 19 de octubre de 2007

Introducción

Torrent es una forma eficiente de transferir archivos grandes. La mayoría de los clientes BitTorrent tienen interfaz gráfica y consumen bastantes recursos (por ejemplo, Azureus). rTorrent es un cliente ligero que se ejecuta en la terminal. Funciona bien dentro de una sesión de screen y puede ejecutarse al arrancar, lo que lo hace práctico para control remoto.

Definición breve: rTorrent es un cliente BitTorrent basado en texto; libtorrent es la biblioteca C++ que rTorrent utiliza.

Cómo usar, soporte y ayuda

La página principal de rTorrent se puede encontrar aquí.
Una guía básica de uso de rTorrent está disponible aquí.
Canal IRC de soporte: irc.freenode.org #rtorrent.
Canal oficial de soporte de libtorrent: irc.worldforgenet.org #libtorrent.

Supuestos y buenas prácticas

Este tutorial asume que usarás la carpeta por defecto en tu home para descargar los archivos SVN. Concretamente se usa ~/rtorrent para los archivos SVN. Debes estar logueado como un usuario normal (no root). Si necesitas permisos de superusuario, se usarán sudo en los pasos necesarios.

Importante: ejecutar compilaciones y cambios en /usr/local/lib requiere sudo. Mantén los comandos de compilación dentro de tu carpeta de usuario.

Requisitos previos (paquetes necesarios)

Ejecuta lo siguiente antes de compilar:

sudo apt-get install subversion build-essential libtool automake1.9 openssl libcurl3 libcurl3-dev libsigc++-2.0-0c2a libsigc++-2.0-dev libncurses5 libncurses5-dev

Nota: Automake debe ser una versión más nueva que 1.4. Otras versiones de automake también funcionan; en este ejemplo se usa 1.9 porque era necesaria para otro software.

Resumen rápido del método

Crear carpeta de trabajo (~/rtorrent).
Descargar el trunk de libtorrent/rtorrent desde SVN.
Compilar e instalar libtorrent.
Actualizar /etc/ld.so.conf y reconstruir la caché de librerías.
Compilar e instalar rTorrent.
Ejecutar rtorrent.

1. Crear la carpeta de descarga

mkdir ~/rtorrent

2. Ir a la carpeta de descarga

cd ~/rtorrent

Ubicación actual: /home/USER/rtorrent

3. Obtener la versión más reciente del trunk

svn co svn://rakshasa.no/libtorrent/trunk

4. Entrar en la carpeta trunk

cd trunk

Ubicación actual: /home/USER/rtorrent/trunk

5. Actualizar rTorrent a la última versión del SVN

svn up

Esto sincroniza tu copia con el repositorio y trae las últimas correcciones.

6. Ir a la carpeta libtorrent

cd libtorrent

Ubicación actual: /home/USER/rtorrent/trunk/libtorrent

7. Ejecutar el script autogen

./autogen.sh

Este script genera los archivos de configuración necesarios (configure, Makefile.in, etc.).

8. Configurar la compilación de libtorrent

./configure

Si faltan dependencias, el script mostrará errores. Instala los paquetes que indique y vuelve a ejecutar.

9. Compilar libtorrent

make

Compilar puede tardar unos minutos según la máquina.

10. Instalar libtorrent en el sistema

sudo make install

11. Añadir /usr/local/lib a ld.so.conf

echo "include /usr/local/lib" | sudo tee -a /etc/ld.so.conf

Esto asegura que las librerías instaladas en /usr/local/lib se busquen dinámicamente.

12. Reconstruir la caché de librerías

sudo ldconfig

13. Ir a la carpeta de rTorrent

cd ../rtorrent

Ubicación actual: /home/USER/rtorrent/trunk/rtorrent

14. Ejecutar el autogen para rTorrent

./autogen.sh

15. Configurar rTorrent

./configure

16. Compilar rTorrent

make

17. Instalar rTorrent

sudo make install

18. Ejecutar rTorrent

rtorrent

¡Eso es todo! Disfruta de rTorrent.

Cómo actualizar a la versión más reciente

Para actualizar rTorrent en el futuro, comienza en el paso de actualización (svn up) dentro de la carpeta trunk (paso 5 en esta guía) y repite el proceso de compilación e instalación: primero libtorrent, luego rTorrent.

Lista de verificación por rol

Usuario normal (antes de compilar):
- Crear ~/rtorrent.
- Asegurarse de tener sudo para instalar.
- Instalar dependencias con apt-get.
Administrador (al instalar librerías en el sistema):
- Ejecutar sudo make install para libtorrent y rTorrent.
- Modificar /etc/ld.so.conf y ejecutar ldconfig.

Alternativas y enfoque cuando falla

Alternativas a compilar desde SVN:

Instalar la versión empaquetada de rTorrent con apt: sudo apt-get install rtorrent. (Más sencillo, pero puede no ser la última versión).
Usar una PPA con binarios más recientes.
Ejecutar rTorrent dentro de un contenedor Docker si prefieres aislamiento.

Problemas comunes y soluciones rápidas:

Error: falta header o paquete -dev.
Solución: instala el paquete correspondiente, por ejemplo libcurl3-dev.
Error: comando ./autogen.sh no encontrado o fallo en aclocal/automake.
Solución: instala automake y libtool (revisa la versión de automake).
rTorrent no se inicia por falta de librerías compartidas.
Solución: confirma que /usr/local/lib está incluido en /etc/ld.so.conf y ejecuta sudo ldconfig.
Permisos insuficientes al instalar.
Solución: usa sudo para make install; evita compilar directamente como root para no crear archivos con permisos inseguros en tu home.

Mini-metodología (heurística rápida)

Preparar entorno → Descargar código → Compilar librería dependiente (libtorrent) → Instalar y actualizar caché de librerías → Compilar y instalar binario (rTorrent) → Verificar ejecución.

Glosario de 1 línea

rTorrent: cliente BitTorrent basado en texto, optimizado para consumo bajo de recursos.
libtorrent: biblioteca C++ que implementa la lógica BitTorrent usada por rTorrent.
SVN: sistema de control de versiones Subversion.
ldconfig: utilidad para actualizar la caché del enlazador dinámico.

Consejos de seguridad y permisos

No compiles ni ejecutes como root salvo para las instalaciones que lo requieran (make install).
Revisa archivos de configuración antes de ejecutar rTorrent en un entorno de producción.

Resumen

Compilar rTorrent desde SVN te da la versión más reciente y control total.
Sigue el orden: dependencias → libtorrent → actualizar librerías del sistema → rTorrent.
Usa alternativas empaquetadas si prefieres facilidad sobre frescura de la versión.

Notas: si necesitas que rTorrent arranque automáticamente, considera crear un servicio systemd o un script init que lance rtorrent dentro de una sesión de screen o tmux.

Cómo compilar rTorrent desde SVN en Ubuntu Gutsy Gibbon