Accueil > calibre technique >

<< Accéder au serveur web calibre depuis internet  | |   Calibre et SQL >>

L'interface en ligne de commande calibre

Par Rémy

Tout le monde connait calibre par son interface graphique et ses menus qui permettent de gérer sa bibliothèque, convertir des livres ou les visualiser. Mais calibre est aussi accessible par une interface en ligne de commande avec laquelle nous allons faire plus ample connaissance.

Préambule

Calibre est installé sur votre ordinateur avec sa traditionnele interface graphique mais aussi avec plusieurs exécutables à utiliser en ligne de commande et ce, pour tous les systèmes d'exploitations. Exception : sous Mac OS X il faut aller dans Préférences (Avancé) / Divers puis cliquer sur Installer les outils en ligne de commande pour que ceux-ci soient disponibles.

La suite de ce tuto est basée sur Windows, il sera très facile de le transposer pour un autre OS.

Les outils en ligne de commande

Ils sont au nombre de 17 :

Chacun peut être utilisé avec de nombreuses options. Vous trouverez une description complète de ces options dans le manuel utilisateur de calibre (EN). Certains de ces outils prennent en plus un ou des arguments (en général le nom d'un fichier).

IMPORTANT : placez toujours les noms de fichiers entre guillemets doubles pour éviter les problèmes avec les noms comportant des espaces !

Utilisation classique en ligne de commande

Ouvrir la ligne de commande

Sous Windows il vous faudra ouvrir une fenêtre de commande ou console aussi appelée Invite de commandes. Pour cela cliquer sur Démarrer puis Programmes (ou Tous les programmes), Accessoires puis Invite de commandes. Avec Win 7 vous pouvez aussi taper cmd.exe dans la barre de recherche du menu Démarrer.

Avec Mac OS ou Linux ouvrez un terminal.

Elle s'ouvre par défaut dans le répertoire C:\User\[votre_nom]\.

Lancer calibre

Tout simplement pour lancer calibre, tapez : calibre

Visualiser (lire) un livre

Supposons que vous vouliez visualiser le livre monlivre.epub qui se trouve dans le dossier Mes Documents\chemin\vers\.

La commande sera : ebook-viewer [options] fichier. Vous avez alors 2 solutions pour y parvenir :

Si vous voulez le visualiser en plein écran tapez ebook-viewer --full-screen "monfichier.epub" ou ebook-viewer -f "monfichier.epub", ces 2 commandes sont équivalentes.

Convertir un livre

Un autre exemple : vous voulez convertir ce livre au format mobi.

Vous pourrez taper par exemple :
ebook-convert "c:\Mes Documents\chemin\vers\monfichier.epub" "c:\Mes Documents\chemin\vers\monfichier.mobi" --chapter-mark pagebreak

Haut de page

Utilisation avancée par script

Le grand intérêt des outils en ligne de commande est de pouvoir être lancés par des applications externes (là je n'apprend rien aux développeurs) mais aussi par des scripts. Sous Windows le langage de script le plus connu est le Batch. Un script Batch est un fichier texte portant l'extension .bat et qui est donc éxecutable par un double clic.

Pour créer un fichier batch il vous suffit donc d'un bloc-note... et de connaître le langage. Comme ce tuto n'a pas vocation à vous apprendre le batch, je me bornerai à vous donner quelques exemples d'utilisation de fichiers batch avec les outils de calibre. Libre à vous de les adapter à votre goût.

La principale utilisation que l'on peut en faire est le traitement récursif de tous les fichiers d'un certain type dans un répertoire et ses sous-répertoires.

La structure du fichier sera celle-ci :

@echo off
@MODE CON: CP SELECT=863
FOR /R %%i IN (*.epub) DO (
# note : cette ligne parcourt tous les fichiers .epub du répertoire courant ainsi
# que les sous-répertoires. Pour traiter des fichiers mobi remplacez simplement *.epub par *.mobi
<commande> "%%i" <options>
)
exit

Exemples

Pour utiliser ces codes, faites un copier/coller dans le bloc-note et enregistrer le fichier en exemple.bat)

Convertir tous les epub en mobi

@echo off
@MODE CON: CP SELECT=863
title Conversion epub/mobi
FOR /R %%i IN (*.epub) DO (
ebook-convert "%%i" "%%~ni.mobi" --chapter-mark "pagebreak"
)
exit

Pour peaufiner la conversion vous pouvez utiliser une des 256 options de la commande ebook-convert (A voir ici)

Récupérer la couverture des epub dans un fichier jpg du même nom

@echo off
@MODE CON: CP SELECT=863
title Enregitrement de la couverture
FOR /R %%i IN (*.epub) DO (
ebook-meta "%%i" --get-cover "%%~ni.jpg"
)
exit

Les images de couverture au format png seront nommées avec l'extension jpg mais votre visualiseur d'images devrait vous le signaler. Il suffira de les renommer avec la bonne extension.

Utiliser ebook-polish

Ebook-polish est la version en ligne de commande de la fonction Polir les livres de calibre

@echo off
@MODE CON: CP SELECT=863
title Polir les livres
FOR /R %%i IN (*.epub) DO (
ebook-polish [option] "%%i" "%%i"
)
exit

Voici une liste des options les plus intéressantes :

Bonus : Modify Epub en ligne de commande

Modify epub n'est pas partie intégrante de calibre mais c'est une extension téléchargeable. Pour la suite nous aurons besoin du fichier Modify epub.zip que vous pouvez récupérer de 2 manières :

Intégration à calibre
  1. Cliquer sur la petite flèche à droite de Préférences (Avancés) puis Obtenir des modules d'extension pour améliorer calibre.
  2. Sélectionner l'option non installés puis Modify Epub
  3. Cliquer sur Installer. Le module sera utilisable avec calibre.
  4. L'archive de l'extension se trouve ici : C:\Users\[votre nom]\AppData\Roaming\calibre\plugins\Modify ePub.zip
Téléchargement du fichier
  1. Télécharger directement le fichier à partir de cette page
  2. Ouvrir l'archive puis le dossier commandline et décompresser le fichier me.py dans votre répertoire de travail.
  3. Dans ce même répertoire créer un fichier .bat (par exemple me.bat) dont voici le modèle :
    @echo off
    title Modify Epub
    FOR /R %%i IN (*.epub) DO (
    calibre-debug -e me.py -- "%%i" [option]
    )
    pause
Haut de page

Liste des options disponibles

FILE_OPTIONS
MANIFEST_OPTIONS
ADOBE_OPTIONS
TOC_OPTIONS
STYLE_OPTIONS
JACKET_OPTIONS
COVER_OPTIONS
METADATA_OPTIONS

Vous voyez que quasiment toutes les options disponibles via calibre le sont ici aussi à l'exception de 'add_replace_jacket' et 'update_metadata'. Pour plus d'informations sur ces options reportez-vous à l'aide de Modify Epub qui se trouve dans le fichier Modify ePub Help.htm du zip.

Haut de page

Conclusion

Ce bref tour d'horizon vous aura donné un aperçu des possibilités offertes par les outils en ligne de commande de calibre. Mais elles sont quasiment infinies, maintenant à vous de jouer !

Pour aller plus loin :

Haut de page

Dernière modification de la page : 13/10/2013

La plupart des textes se trouvant ici ont été gracieusement mis à ma disposition par leur auteur ou traduits à partir de textes publiés en ligne par ceux qui en détiennent les droits. Vous pouvez les citer mais vous devez impérativement indiquer l'auteur d'origine et/ou, le cas échéant, reprendre le lien que j'ai mis vers le texte original.
Dans la mesure du possible, merci de mettre un lien vers l'article plutôt que le recopier intégralement. Conformément à la législation, vous avez le droit de résumer ou de citer brièvement tout texte qui vous intéresse.
Toute utilisation des textes se fera selon les termes de la Licence Creative Commons Paternité - Pas d'Utilisation Commerciale - Partage à l'Identique 2.0 France.
Contrat Creative Commons

Accueil - Plan du site - Contact