O esquema de URL calibre://

O calibre se registra como programa padrão para abrir URLs calibre://. Assim você pode usar isto para executar ações, como abrir livros, pesquisar por livros, etc. a partir de outros programas/documentos ou por linha de comando. Por exemplo: executar o seguinte na linha de comando:

calibre calibre://switch-library/Some_Library

Irá abrir o calibre com a biblioteca nomeada «Some Library». Os nomes das bibliotecas são o nome da pasta da biblioteca com espaços substituídos por sublinhados. O valor especial «_» significa a biblioteca atual. Os vários tipos de URLs estão documentados abaixo.

Você pode inserir estes links dentro de arquivos HTML ou documentos do Word ou similares e o sistema operacional irá automaticamente abrir o calibre para executar a ação especificada.

Trocar para uma biblioteca específica

A sintaxe do URL é:

calibre://switch-library/Library_Name

Os nomes das bibliotecas são o nome da pasta da biblioteca com espaços substituídos por sublinhado. O valor especial «_» significa a biblioteca atual. Você também pode usar :ref:`hex encoding <hex_encoding>`para nomes das bibliotecas, útil se os nomes das bibliotecas possuem caracteres especiais que, de alguma forma, exigiria codificação de URL. Os nomes de biblioteca codificados em hexadecimal se parecem com:

_hex_-AD23F4BC

Parte onde após o prefixo `` _hex_-`` é o nome da biblioteca codificado como UTF-8 e cada byte representado por dois caracteres hexadecimais.

Mostrar um livro específico no Calibre

A sintaxe do URL é:

calibre://show-book/Library_Name/book_id

This will show the book with book_id (a number) in calibre. The ids for books can be seen in the calibre interface by hovering over the Click to open link in the Book details panel, it is the number in brackets at the end of the path to the book folder.

You can copy a link to the current book displayed in calibre by right clicking the Book details panel and choosing Copy link to book.

If a search is active and the book is not matched by the search then the search is cleared.

If a Virtual library is selected, calibre will use it when showing the book. If the book isn’t found in that virtual library then the virtual library is cleared.

If you want to switch to a particular Virtual library when showing the book, use:

calibre://show-book/Library_Name/book_id?virtual_library=Library%20Name
or
calibre://show-book/Library_Name/book_id?encoded_virtual_library=hex_encoded_virtual_library_name

replacing spaces in the Virtual library name by %20. If the book isn’t found in that virtual library then the virtual library is ignored.

Open a specific book in the E-book viewer at a specific position

A sintaxe do URL é:

calibre://view-book/Library_Name/book_id/book_format?open_at=location

Aqui, `` book_format`` é o formato do livro, por exemplo, ʻEPUB` ou MOBI e location é um local opcional dentro do livro. A maneira mais fácil de obter esses links é abrir um livro no visualizador, em seguida, nos controles do visualizador, selecione Go to → Location e lá será fornecido um link que você poderá copiar/colar em outro lugar.

À procura de livros

A sintaxe do URL é:

calibre://search/Library_Name?q=query
calibre://search/Library_Name?eq=hex_encoded_query

Aqui a consulta e qualquer search expresion válida. Se a expressão de busca for complicada, :ref:èncode it as a hex string <hex_encoding>` e use eq em vez disso. Deixar de fora a consulta fará com que a pesquisa atual seja apagada.

By default, if a Virtual library is selected, calibre will clear it before doing the search to ensure all books are found. If you want to preserve the Virtual library, use:

calibre://search/Library_Name?q=query&virtual_library=_

If you want to switch to a particular Virtual library, use:

calibre://search/Library_Name?virtual_library=Library%20Name
or
calibre://search/Library_Name?encoded_virtual_library=hex_encoded_virtual_library_name

replacing spaces in the Virtual library name by %20.

If you perform a search in calibre and want to generate a link for it you can do so by right clicking the search bar and choosing Copy search as URL.

Abrir uma janela de detalhes de um livro numa biblioteca

A sintaxe do URL é:

calibre://book-details/Library_Name/book_id

Isto abre uma janela de detalhes do livro sobre o livro especificado e da biblioteca especificada sem alterar a biblioteca atual ou o livro selecionado.

Open the notes associated with an author/series/etc.

A sintaxe do URL é:

calibre://book-details/Library_Name/Field_Name/id_Item_Id

This opens a window showing the notes of the specified item. The easiest way to create such URLs is to show the notes you want in calibre and click the Copy URL button to copy the URL to the clipboard and paste it wherever you need.

Here Field_Name is the name of the columns such as authors or tags. For user created columns, replace the leading # in the field name with an underscore, so #mytags becomes _mytags.

In addition to specifying items by id using Item_Id you can also specify them by name using either val_Item_Name or hex_Hex_Encoded_Item_Name. For example:

calibre://book-details/Library_Name/authors/val_John%20Doe

Codificação Hex dos parâmetros do URL

A codificação hex dos parâmetros do URL é feita, primeiro codificando os parâmetros como bytes UTF-8, e depois substituindo cada byte por dois caracteres hexadecimais representando cada byte. Por exemplo: a string abc é composta pelos bytes 0x61 0x62 e 0x63 em UTF-8, pelo que a versão codificada é a string: 616263.