Instructivo para automatizar Calibre en Mac y Linus (posible en Windows)

[herchu]

Tengo funcionando un archivo de lotes para automatizar la descarga y transferencia a la Kindle de periódicos usando Calibre. La diferencia en hacerlo por fuera es que no es necesario tener el Calibre siempre funcionando.

Lo he hecho para Mac y podría ser adaptado para Windows. No se si hay alguien que le pueda interesar ya que es sólo una tontería.

[solonete]

Buenas herchu,

Yo todavía no he trasteado mucho con calibre y con el K porque me ha llegado hoy y no he tenido tiempo, pero seguro que cuando me ponga me interesa que me pase los periódicos y RSS por la mañana.

¿Lo compartes?

[herchu]

Sí, por supuesto.

Aprovecharé este fin de semana que estoy sin coche para escribir el instructivo y publicarlo aquí. Será entre hoy y mañana.

[solonete]

Genial,

pues a la espera quedamos

[herchu]

Introducción

El programa Calibre además de la interfaz gráfica incluye una colección de utilidades de línea de comandos que son especialmente indicadas para la automatización de tareas. Dos de éstas utilidades son ebook-convert, para convertir las páginas web de los periódicos en formato epub o mobi y calibre-smtp para enviar lo convertido por correo electrónico a nuestra Kindle.

En Mac OSX, en Linux y Unix en general, la solución mas sencilla y portable para programar tareas a determinadas horas es usando el programa crontab, que también es de línea de comandos.

Combinando las utilidades de Calibre en un archivo de lotes y disparando la ejecución de éste desde el crontab, tendremos propio canillita electrónico sin necesidad de tener el Calibre siempre en memoria, sólo que el ordenador esté encendido.

Este instructivo da por sentado que ya tenéis instalado el Calibre y está orientado a usuarios de Mac --los de Linux no necesitan documentación -- .

El archivo de lotes

Es un archivo de textos interpretable por el sistema operativo e incluye unos parámetros de configuración para que sea mas sencillo de personalizar. Para invocarlo hay que especificar la receta de Calibre que nos dice qué periódico queremos descargar.

1. Abran un editor de textos e inserten el contenido que aquí se incluye.
   

   #!/bin/sh
   
   # personalizacion
   
   MAIL_HOST=smtp.gmail.com
   MAIL_PORT=587
   MAIL_USER=miemail@gmail.com
   MAIL_PASS=miclave
   MAIL_FROM=miemail@gmail.com
   MAIL_TO=miemailenkindle@kindle.com
   
   OUTPUT=mobi
   OTHERS=--output-profile=kindle
   
   # configuracion
   
   CALIBREDIR=/Applications/calibre.app/Contents
   CALIBREBIN=$CALIBREDIR/MacOS
   RECIPESDIR=$CALIBREDIR/Resources/resources/recipes
   
   enews=$1
   log=/tmp/ediario$$.log
   
   
   if [ "$1" = "" ]; then
   	echo Uso: ediario.sh nombre-receta-sin-extension
   	exit 1
   fi
   
   date >> $log
   echo >> $log
   
   $CALIBREBIN/ebook-convert $RECIPESDIR/$enews.recipe /tmp/$enews.$OUTPUT $OTHERS >> $log
   
   echo >> $log
   
   $CALIBREBIN/calibre-smtp -r $MAIL_HOST --port $MAIL_PORT --username $MAIL_USER --password $MAIL_PASS --a /tmp/$enews.$OUTPUT --s $enews $MAIL_FROM $MAIL_TO '' >> $log
   
   echo >> $log
   date >> $log
   

2. Modifiquen los parámetros para personalizarlo a gusto. Como mínimo será el MAIL_USER, MAIL_PASS, MAIL_FROM (cuenta, clave y dirección de remitente) y MAIL_TO (cuenta destino en @kindle.com). Si no tienen GMail, deberéis cambiar también MAIL_HOST y quizás MAIL_PORT. Si poseen otro lector deberán cambiar también OUTPUT y OTHERS.
3. Guarden el archivo en algún directorio del usuario, por ejemplo Documentos, y con algún nombre acorde, sugiero ediarios.sh
4. Denle permisos de ejecución, paso necesario para que el Sistema Operativo interprete el archivo de texto como un pograma. Para esto tienen que abrir el Terminal y tipear los siguiente:
   

   $ cd Documents
   $ chmod +x ediarios.sh
   $

5. Para probarlo sólo hay que decirle la receta que queremos usar.
   

   $ ./ediarios.sh el_pais
   $

Si todo ha ido bien en unos minutos deberíamos tener en el Kindle una copia de El Pais.
Si no fue así, deberán revisar la página Manage My Kindle para ver si la descarga está en espera y comprobar las direcciones de envío y recepción. También deben revisar los parámetros del correo electrónico (servidor, usuario y clave).
Otro posible error es que el nombre de la receta no esté bien escrito.

La programación horaria

Siguiendo con las utilidades del intérprete de comandos para programar los envíos usaremos el crontab.
Es poco amistoso y la programación se especifica mediante un archivo de texto que tendrá una línea para cada tarea programada y seis columnas separadas por espacios o tabuladores. Las cinco primeras indican cuándo se ejecuta la tarea (los minutos, la hora, la fecha del mes, el mes, y el día de la semana) y la última columna (hasta el fin de la línea) la tarea a ejecutar.

Un ejemplo de programación para envío de El País y el Guardian de UK sería:

# Minutos   Horas   Fecha Mes       Mes           Dia de Semana         Tarea
# (0-59)  (0-23)     (1-31)    (1-12 o Jan-Dec)  (0-6 o Sun-Sat)                
    55       7          *             *               *                 /Users/herchu/Documents/ediario.sh  el_pais > /dev/null 2>&1
    45       7          *             *               *                	/Users/herchu/Documents/ediario.sh  guardian > /dev/null 2>&1

1. Abran un editor de textos e inserten el contenido que aquí se incluye.
2. Modifiquen la programación a gusto.
3. Guarden el archivo en algún directorio del usuario, por ejemplo Documentos, y con algún nombre acorde, sugiero misdiarios.txt
4. Inicien o reinicien la programación. Dentro del Terminal, tipear lo siguiente:
   

   $ crontab misdiarios.txt
   $

5. Comprueben lo programado:
   

   $ crontab -l
   ... aqui deberia mostrarles el contenido de misdiarios.txt...
   $

Si queremos que una tarea se ejecute a las 8:15 de la mañana, las dos primeras columnas serán 15 y 8.
Un asterisco en cualquiera de las primeras cinco columnas indican que la tarea se ejecuta para cualquier valor de dicha columna. Si queremos que la prensa se nos envíe todos los días del año a las 7 y media las primeras cinco columnas serán:
30 7 * * *
Termina cada línea con el comando a ejecutar. En nuestro caso será
/Users/miusuario/Documents/ediario.sh el_pais > /dev/null 2>&1

Se especificar el PATH completo a ediario.sh para que el S.O. no tenga problemas en ubicarlo.
El " > /dev/null 2>&1 " final es para hacer nuestro programa "silencioso" aún cuando se hayan producido errores.

[solonete]

Woooow!!!

Gracias, que bueno... lo probaré y te cuento qué tal me ha ido.

[alf]

Hola. He hecho una ampliación del script de herchu, para poder descargar varias recetas a la vez.
La modificación consiste en añadir un fichero de texto que contiene el nombre de las recetas que nos queremos descargar, una receta por linea. Por ejemplo:
Recetas.txt

endgadget
slashdot
digital_arts
theonlinephotographer
smashing

El código del script quedaría así:

#!/bin/sh

# personalizacion

MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USER=email@gmail.com
MAIL_PASS=password
MAIL_FROM=email@gmail.com
MAIL_TO=emailkindle@kindle.com
FICHERO=ruta_hasta_el_fichero/Recetas.txt  (<--En el ejemplo el fichero se llamaba Recetas.txt)

OUTPUT=mobi
OTHERS=--output-profile=kindle

CALIBREDIR=/opt/calibre
CALIBREBIN=$CALIBREDIR
RECIPESDIR=$CALIBREDIR/resources/recipes

log=/tmp/DescargaRecetasCalibre$$.log

#Descargamos las recetas del fichero
for RECETA in $(cat $FICHERO);
do
    date >> $log
    echo >> $log

    $CALIBREBIN/ebook-convert $RECIPESDIR/$RECETA.recipe /tmp/$RECETA.$OUTPUT $OTHERS >> $log

    echo >> $log

    $CALIBREBIN/calibre-smtp -r $MAIL_HOST --port $MAIL_PORT --username $MAIL_USER --password  $MAIL_PASS --a /tmp/$RECETA.$OUTPUT --s $RECETA $MAIL_FROM $MAIL_TO '' >> $log

    echo >> $log
    date >> $log
done

De este modo, bien mediante la programación de crontab o mediante un botón en el escritorio que ejecute el script, tendremos descargadas todas las recetas a la vez.

Espero que os sirva

[Konisakae]

Muchas gracias herchu y alf


saludos