Manual de usuario
La documentación oficial se encuentra en inglés en este enlace. Aunque contamos con una descripción mas detallada sobre el uso de Radioco tenga en cuenta que podría estar desactualizada, no obstante debería ser aun valida:
Guía de instalación del programa grabador
Esta guia describe el proceso de instalación en las distribuciones Debian y Ubuntu. Se requiere Python 2.7. Nos situamos en el directorio deseado y comenzamos la instalación:
Obtención del programa
Descargamos el programa de los repositorios y entramos en la carpeta:
|
1 2 3 |
sudo apt-get install git-core git clone https://github.com/iago1460/django-radio-recorder.git cd django-radio-recorder |
Creación del entorno virtual
La instalación de un entorno virtual es opcional, a continuación se proporcionan los comandos para instalar y crear el entorno virtual:
|
1 2 3 |
sudo apt-get install python-virtualenv virtualenv . source bin/activate |
Instalación de requisitos
Instalamos los requisitos:
|
1 2 3 4 |
sudo apt-get install python-dev python-pip pip install -r requirements.txt sudo apt-get install alsa-utils sudo apt-get install vorbis-tools |
Configuración del programa
Toda la configuración se realiza a través del archivo de configuración llamado “settings.ini”:
Configuración típica
Para realizar la conexión del programa con la aplicación web debe proporcionarle los siguientes datos:
- url: La dirección URL pública de la aplicación web y junto con la ruta del api, por ejemplo: “http://demo.radioco.org:80/api/1/”. Es necesario mantener el mismo formato que el ejemplo.
- token: El token de autentificación proporcionado por la aplicación web en la página de administración.
Con los pasos anteriores el programa ya es capaz de obtener la información a grabar y comunicarle cuando ha grabado el archivo.
Veamos ahora como configurar la subida del archivo mediante FTP:
- enable: Esta opción debemos establecerla a cierta escribiendo “True”
- server: La dirección del servidor FTP, respete el formato “servidorFTP.com”
- username: El nombre de usuario del servidor FTP
- password: La contraseña del servidor FTP
Si no se quieren conservar los archivos grabados una vez subidos al servidor se debe activar la opción “delete_files_after_upload”.
A continuación se muestra el archivo de configuración por defecto con el resto de opciones:
|
1 |
nano recorder/settings.ini |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
# # Units of measurement for time: seconds # Boolean values: 'True', 'False' # [SETTINGS] offline_mode:False url:http://localhost:8000/api/1/ token:8fdde6d703c05773084ea83e5ec2da62637666a0 # Name of files schedule_file:schedules.txt log_file:status.log # Folders recording_folder:recorders/incomplete/ complete_folder:recorders/complete/ uploaded_folder:recorders/uploaded/ # Recording metadata_language:en file_extension:ogg recorder_command:arecord --buffer-size=192000 -f S16_LE -c 2 -r 48000 -t raw recorder_command_2:oggenc - -r -B 16 -C 2 -R 48000 -q 3 --title [TITLE] --artist [AUTHOR] --album [ALBUM] --tracknum [TRACK] --genre [GENRE] -c comment=[COMMENT] -o [OUTPUT] # Time is represented in seconds update_time:3600 retry_time:120 upload_time:60 socket_timeout:300 # Upload configuration delete_files_after_upload:False [FTP] enable:False server:server.radioco.org username:username password:password |
Configuración avanzada del programa
Configuración de la grabación de audio
Por defecto el programa graba a 16 bits a una frecuencia de 48kHz en estéreo. Para cambiar esto es necesario consultar el manual del comando “arecord”
|
1 |
man arecord |
Si se modifican los parámetros de grabación del comando “arecord” es necesario cambiar la configuración de “oggenc” que comprime el fichero a OGG.
|
1 |
man oggenc |
Si quiere grabar en otro formato diferente de OGG como por ejemplo MP3 puede consultar la librería lame.
Configuración offline
El programa grabador puede funcionar sin conexión a internet, aunque esta configuración es algo atípica permite realizar la grabación de audio si se le proporcionan los horarios, esta información se puede obtener de la siguiente dirección:
http://demo.radioco.org:80/api/1/recording_schedules/?start=2014-09-01+00:00:00&next_hours=320
Debes sustituir “demo.radioco.org:80” por la dirección del servidor.
La fecha a partir de la que quieres la información start=2014-09-01+00:00:00, siendo en este ejemplo el uno de septiembre de 2014 a las 00:00:00.
Opcionalmente el parámetro “next_hours=320” sobrescribe la configuración del servidor para obtener los horarios a grabar en las próximas 320 horas.
Una vez introducida correctamente la dirección URL deberá autentificarse con las credenciales del programa grabador. La información obtenida debe ser guardada en el archivo definido en la configuración, por defecto “schedules.txt”, dentro de la carpeta del programa.
Ejecución del programa
Para ejecutar el programa:
|
1 |
python main.py |
Si lo queremos dejar en Segundo plano:
|
1 |
nohup python main.py & |
El programa intentará seguir en ejecución a pesar de que ocurran errores. En la carpeta se puede encontrar un archivo de log, por defecto llamado “status.log”, donde se registran los errores y avisos de la aplicación.
Para finalizar la ejecución del programa basta con pulsar “Control + C” o enviarle una señal de cierre al proceso.