NAME¶

calibredb - calibredb

calibredb orden [opciones] [argumentos]

calibredb es la interfaz de línea de órdenes para la base de datos de calibre. Tiene varias subórdenes que se documentan a continuación.

calibredb puede usarse para manipular una base de datos de calibre especificada por una ruta de acceso o un servidor de contenidos de calibre que esté ejecutándose en el equipo local o a través de internet. Puede iniciar un servidor de contenidos de calibre mediante el programa calibre-server o, en el programa principal de calibre, pulsando Conectar y compartir > Iniciar servidor de contenidos. Puesto que calibredb puede realizar cambios en las bibliotecas de calibre, debe configurar la autenticación en el servidor previamente. Hay dos maneras de hacerlo:

Para conectar con un servidor de contenidos en ejecución, pase el URL del servidor con la opción --with-library, vea la documentación de esta opción para más detalles y ejemplos.

OPCIONES GLOBALES¶

LIST¶

calibredb list [opciones]

Lista de los libros disponibles en la base de datos de calibre.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

ADD¶

calibredb add [opciones] archivo1 archivo2 archivo3 ...

Añadir los archivos especificados a la base de datos. También pueden especificarse carpetas, ver las opciones relativas a carpetas más abajo.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

REMOVE¶

calibredb remove ID

Eliminar los libros identificados por ID de la base de datos. ID debe ser una lista separada por comas de números de identificación (se pueden obtener números de identificación usando la orden «search»). Por ejemplo, 23,34,57-85 (al especificar un intervalo, el último número del intervalo no está incluido).

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

ADD_FORMAT¶

calibredb add_format [opciones] ID archivo_libro

Añadir el libro electrónico archivo_libro a los formatos disponibles para el libro identificado por ID. Se puede obtener el ID usando la orden «search». Si el formato ya existe, será sustituido por el nuevo, a no ser que se use la opción de no sustituir.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

REMOVE_FORMAT¶

calibredb remove_format [options] ID fmt

Eliminar el formato fmt del libro identificado por ID. Se puede obtener el ID usando la orden «search». fmt debe ser una extensión de archivo como LRF, TXT o EPUB. Si el libro no tiene el formato fmt disponible, no hace nada.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

SHOW_METADATA¶

calibredb show_metadata [opciones] ID

Muestra los metadatos almacenados en la base de datos de calibre para el libro identificado por ID. ID es un identificador de la orden «search».

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

SET_METADATA¶

calibredb set_metadata [opciones] id_de_libro [/ruta/a/metadatos.opf]

Asignar los metadatos del libro identificado por id_de_libro a partir del archivo OPF metadatos.opf. El id_de_libro es un identificador dado por la orden «search». Puede ver en qué consiste el formato OPF usando la opción --as-opf en la orden «show_metadata». También puede asignar metadatos a campos individuales con la opción --field.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

EXPORT¶

calibredb export [opciones] ID

Exportar los libros especificados por ID (una lista de identificadores separada por comas) al sistema de archivos. La operación de exportación guarda todos los formatos del libro, su portada y metadatos (en un archivo OPF). También se guardan todos los archivos de datos adicionales asociados con el libro. Se pueden obtener identificación con la orden «search».

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

CATALOG¶

calibredb catalog /ruta/a/destino.(csv|epub|mobi|xml...) [opciones]

Exportar un catálogo en el formato especificado por la extensión de /ruta/a/destino. Las opciones controlan cómo se muestran las entradas en la salida del catálogo generado. Tenga en cuenta que los diferentes formatos de catálogo admiten diferentes opciones. Para ver las distintas opciones, especifique el nombre del archivo de salida y después la opción --help.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

SAVED_SEARCHES¶

calibredb saved_searches [opciones] [list|add|remove]

Administrar las búsquedas guardadas en la base de datos. Si intenta añadir una búsqueda con un nombre que ya existe, será reemplazada.

Sintaxis para mostrar, la acción predeterminada:

calibredb saved_searches list

Sintaxis para añadir:

calibredb saved_searches add nombre_de_búsqueda expresión_de_búsqueda

Sintaxis para eliminar:

calibredb saved_searches remove nombre_de_búsqueda

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

ADD_CUSTOM_COLUMN¶

calibredb add_custom_column [opciones] etiqueta nombre tipo_de_dato

Crea una columna personalizada. «etiqueta» es un nombre interno para la columna. No debe contener espacios ni dos puntos. «nombre» es el nombre visible de la columna. «tipo_de_dato» es uno de: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

CUSTOM_COLUMNS¶

calibredb custom_columns [opciones]

Da una lista de las columnas personalizadas disponibles. Muestra las etiquetas de columna e ID.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [opciones] etiqueta

Elimina la columna personalizada identificada por «etiqueta». Puede ver las columnas disponibles con la orden «custom_columns»

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

SET_CUSTOM¶

calibredb set_custom [opciones] columna ID valor

Establecer el valor de una columna personalizada para el libro identificado por ID. Puede obtener una lista de ID con la orden «search». Puede obtener una lista de nombres de columnas personalizadas usando la orden «custom_columns»

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

RESTORE_DATABASE¶

calibredb restore_database [options]

Recupera la base de datos a partir de los metadatos almacenados en los archivos OPF en cada carpeta de la biblioteca de calibre. Esto resulta útil si su archivo metadata.db se ha dañado.

ADVERTENCIA: Esta orden regenera completamente la base de datos. Se perderán todas las búsquedas guardadas, categorías de usuario, controles, configuración de conversión guardada por libro y fórmulas personalizadas. Los metadatos recuperados serán tan precisos como lo sean los archivos OPF.

El código de salida es 0 si la restauración tiene éxito, 1 si falla completamente y 2 si la base de datos se restaura pero no algunos libros u otros datos.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

CHECK_LIBRARY¶

calibredb check_library [opciones]

Realiza algunas comprobaciones en el sistema de archivos que contiene la biblioteca. El resultado es invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

LIST_CATEGORIES¶

calibredb list_categories [opciones]

Genera un informe de la información de la categoría en la base de datos. La información es el equivalente a lo que se muestra en el explorador de etiquetas.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

BACKUP_METADATA¶

calibredb backup_metadata [opciones]

Hace una copia de respaldo de los metadatos almacenados en la base de datos en ficheros OPF individuales en cada carpeta de libro. Esto se lleva a cabo normalmente de manera automática, pero puede ejecutar esta orden para forzar la regeneración de los ficheros OPF, con la opción --all.

Tenga en cuenta que normalmente no hay necesidad de hacer esto, pues los ficheros OPF se actualizan cada vez que se modifican los metadatos.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

CLONE¶

calibredb clone ruta/a/nueva/biblioteca

Crea un clon de la biblioteca actual. Esto crea una nueva biblioteca vacía que tiene las mismas columnas personalizadas, bibliotecas virtuales y otras configuraciones que la biblioteca actual.

La biblioteca clonada no contendrá ningún libro. Si quiere crear un duplicado completo, incluyendo todos los libros, use simplemente las utilidades del sistema operativo para copiar la carpeta de la biblioteca.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

EMBED_METADATA¶

calibredb embed_metadata [opciones] ID

Actualizar los metadatos en los archivos de libro almacenados en la biblioteca de calibre a partir de los metadatos en la base de datos de calibre. Normalmente, los metadatos se actualizan únicamente cuando se exportan los libros de calibre, esta orden es útil si quiere actualizar los archivos de origen. Tenga en cuenta que los distintos formatos admiten diferentes tipos de metadatos. Puede usar el valor especial 'all' para ID, para actualizar los metadatos de todos los libros. También puede usar varios ID separados por espacios y gamas de ID separados por guiones. Por ejemplo: calibredb embed_metadata 1 2 10-15 23

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

SEARCH¶

calibredb search [opciones] expresión de búsqueda

Busca la expresión de búsqueda especificada en la biblioteca y devuelve una lista separada por comas de ID de libros que coinciden con la expresión. El formato de la salida puede usarse como entrada par otras órdenes que admiten una lista de ID.

La expresión de búsqueda puede ser cualquiera aceptada por el potente lenguaje de búsquedas de calibre, por ejemplo: calibredb search author:asimov 'title:"i robot"'

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

FTS_INDEX¶

calibredb fts_index [opciones] enable/disable/status/reindex

Controlar el proceso de indexado de búsqueda de texto completo.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

FTS_SEARCH¶

calibredb fts_search [opciones] expresión de búsqueda

Realizar una búsqueda de texto completo en toda la biblioteca o en un subconjunto de ella.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

NOTES¶

calibredb notes [opciones] [list|search|show|set|remove]

Administrar las notas adjuntas a elementos como autores, series, etiquetas y editoriales. CAMPO es el nombre de búsqueda del campo, por ejemplo: authors, series, tags, publisher o #micolumna. ELEMENTO es el nombre del elemento, por ejemplo el nombre de un autor. Los elementos no distinguen entre mayúsculas y minúsculas.

Lista de los elementos que tienen notas, de manera opcional sólo en el campo especificado. Ésta es la acción predeterminada:

calibredb notes list [CAMPO]

Buscar en el texto de las notas usando la misma sintaxis SQLite de búsqueda de texto completo que la herramienta de explorar notas en calibre. Se escribe el campo, nombre de elemento, y un fragmento para cada coincidencia. Usar --field para buscar sólo en las notas de un campo en particular:

calibredb notes search "expresión de búsqueda" calibredb notes search --field authors "expresión de búsqueda"

Escribir la nota de un elemento como texto en formato Markdown, o con --as-html como un documento HTML con imágenes incrustadas, adecuado para su uso con set:

calibredb notes show CAMPO ELEMENTO

Sustituir la nota de un elemento por el contenido de un archivo HTML. Usar - para leer el HTML de la entrada estándar. Las imágenes incrustadas como URL de tipo data: codificados con base64 se añaden a la nota tanto para bibliotecas locales como remotas. Si se usa una biblioteca local y se lee de un archivo, las imágenes referenciadas con rutas relativas al archivo también se añaden:

calibredb notes set CAMPO ELEMENTO ARCHIVO

Eliminar la nota de un elemento:

calibredb notes remove CAMPO ELEMENTO

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

ITEMS¶

calibredb items [opciones] (rename|remove) CAMPO ELEMENTO ...

Cambiar el nombre o eliminar elementos como autores, etiquetas, series y editoriales en todos los libros, igual que las acciones de administrar autores, etiquetas, etc. en la interfaz de calibre. CAMPO es el nombre de búsqueda del campo, por ejemplo: authors, tags, series, publisher o #micolumna. Los elementos no distinguen entre mayúsculas y minúsculas.

Cambiar el nombre de un elemento. Si ya existe un elemento llamado NOMBRE_NUEVO, los dos elementos se combinan. Para campos que contienen varios valores, NOMBRE_NUEVO puede contener más de un valor, separados por el separador del campo, por ejemplo una coma para etiquetas. El elemento se sustituye por todos los valores:

calibredb items rename CAMPO ELEMENTO NOMBRE_NUEVO

Eliminar uno o más elementos de todos los libros. Los autores no se pueden eliminar:

calibredb items remove CAMPO ELEMENTO [ELEMENTO ...]

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

VIRTUAL_LIBRARIES¶

calibredb virtual_libraries [opciones] [list|add|rename|remove]

Administrar las bibliotecas virtuales de esta biblioteca. Una biblioteca virtual es una búsqueda que se comporta como si la biblioteca contuviera sólo los libros que coinciden. Para mostrar o buscar los libros de una biblioteca virtual, use: calibredb search 'vl:"nombre"'

Mostrar las bibliotecas virtuales, con sus búsquedas y número de libros. Ésta es la acción predeterminada:

calibredb virtual_libraries list

Crear una biblioteca virtual a partir de una búsqueda:

calibredb virtual_libraries add nombre expresión_búsqueda

Cambiar el nombre de una biblioteca virtual:

calibredb virtual_libraries rename nombre nuevo_nombre

Eliminar bibliotecas virtuales, los libros en ellas no se modifican:

calibredb virtual_libraries remove nombre ...

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

ANNOTATIONS¶

calibredb annotations [opciones] [list|search|export|import|remove]

Administrar las anotaciones, es decir los resaltados y marcadores, de los libros, creadas en el lector de libros electrónicos de calibre o sincronizadas con otras aplicaciones.

Mostrar las anotaciones, con sus identificadores. Ésta es la acción predeterminada:

calibredb annotations list

Buscar en textos resaltados, notas de anotaciones y títulos de marcadores usando la misma sintaxis de búsqueda de texto completo SQLite que en la herramienta de exploración de anotaciones. Los resultados se ordenan por relevancia e incluyen identificadores de anotación, títulos de libros y fragmentos coincidentes. Usar --search para restringir los libros, --type para restringir los tipos de anotación, --user-type y --annotation-user para restringir el usuario, --no-stemming para buscar coincidencias de palabras completas o --format json para obtener una lista de resultados JSON incluyendo los datos de anotación y fragmentos:

calibredb annotations search "expresión de búsqueda"

Exportar las anotaciones como texto plano, Markdown o JSON, agrupadas por libro. El formato JSON es el mismo formato de colección de anotaciones de calibre creado por el botón exportar en la herramienta de exploración de anotaciones:

calibredb annotations export

Importar una colección de anotaciones de calibre exportada como JSON por esta orden o la herramienta de exploración de anotaciones. La colección debe contener anotaciones de un único libro. ID_LIBRO es el identificador de libro de destino, no el identificador almacenado en el archivo. Sólo se importan las anotaciones del formato FORMATO, las anotaciones de otros formatos se omiten. FORMATO debe existir en el libro de destino. Use la misma edición del libro para que las posiciones coincidan:

calibredb annotations import ID_LIBRO FORMATO ARCHIVO

Use - como ARCHIVO para leer de la entrada estándar. Se validará la colección completa antes de importar. Las anotaciones se combinan con las existentes usando las reglas del visor: los resaltados se hacen corresponder por UUID y los marcadores por título, y la marca temporal más reciente gana. Si se importa varias veces no se crean duplicados. Las anotaciones y posiciones de lectura no relacionadas se mantienen.

De manera predeterminada, las anotaciones se importan en las del visor de libros electrónicos de calibre. Usar --user-type web --annotation-user USUARIO para importarlas en las del servidor de contenidos. Las colecciones exportadas registran el usuario al que pertenecen las anotaciones, y si una colección contiene anotaciones de más de un usuario, se rechaza. Usar las opciones --user-type y --annotation-user al exportar para exportar las anotaciones de un solo usuario.

Eliminar permanentemente las anotaciones con los identificadores especificados, según se muestran con list:

calibredb annotations remove ID ...

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

TRASH¶

calibredb trash [opciones] (list|restore|delete|empty) [ids]

Administrar los libros y formatos que han sido eliminados y enviados a la papelera. Las entradas en la papelera se borran permanentemente de manera automática al cabo de algunos días. ids es una lista separada por comas de identificadores de libro, como para la orden remove, por ejemplo: 23,34,57-85 (al especificar un intervalo, el último número del intervalo no se incluye).

Mostrar los libros y formatos eliminados, primero los eliminados más recientemente, con la hora en que se eliminaron en horario local. Los formatos eliminados de libros que ya no existen se marcan como no restaurables, sólo pueden ser borrados. Con --for-machine, las horas están en UTC.

calibredb trash list

Restaurar los libros eliminados o, con --formats, los formatos eliminados de libros:

calibredb trash restore ids

Borrar permanentemente entradas de la papelera:

calibredb trash delete ids

Borrar permanentemente todo en la papelera:

calibredb trash empty

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

DATA_FILES¶

calibredb data_files [opciones] (list|add|get|rename|remove) ID_LIBRO ...

Administrar los archivos de datos adicionales asociados con un libro, en bibliotecas locales o remotas. Los nombres son relativos al directorio de datos del libro. Usar / para subdirectorios, también se acepta. Los archivos que contienen se muestran, pero no pueden administrarse. Con esta orden no puede accederse a los formatos de libro, portadas o metadata.opf. Las bibliotecas remotas requieren una cuenta con permiso de escritura, como para otras órdenes de administración, y no admiten cuentas con restricciones de búsqueda por biblioteca.

Mostrar nombres de archivo, tamaños en bytes y foras de modificación (segundos desde el inicio de la época Unix). Usar --for-machine para salida JSON:

calibredb data_files list ID_LIBRO

Añadir un archivo, usando su nombre de base, o --name para especificar un nombre o subdirectorio. Los archivos existentes no se sustituyen a no ser que se especifique --replace. Esto también está disponible mediante add_format --as-extra-data-file:

calibredb data_files add ID_LIBRO ARCHIVO

Guardar un archivo de datos como --output en la máquina local. Los archivos existentes no se sustituyen a no ser que se especifique --replace:

calibredb data_files get ID_LIBRO NOMBRE --output ARCHIVO

Cambiar el nombre de un archivo. Los destinos existentes no se sustituyen a no ser que se use --replace:

calibredb data_files rename ID_LIBRO NOMBRE NUEVO_NOMBRE

Eliminar un archivo moviéndolo a la papelera del sistema operativo. Con --permanent, se borra permanentemente. Para bibliotecas remotas, esto ocurre en el servidor:

calibredb data_files remove ID_LIBRO NOMBRE.

Los directorios que quedan vacíos al eliminar o cambiar el nombre se borran. Con bibliotecas remotas, cada archivo se transfiere en una sola solicitud, por lo que los archivos muy grandes requieren memoria suficiente tanto en el cliente como en el servidor, y las subidas están limitadas por el tamaño máximo de solicitud del servidor.

Cuando alguno de los argumentos de calibredb contenga espacios, póngalo entre comillas. Por ejemplo: "/some path/with spaces"

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal