Guía de instalación del programa grabador

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:

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:

Instalación de requisitos

Instalamos los requisitos:

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:

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”

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.

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:

Si lo queremos dejar en Segundo plano:

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.