NAME¶

calibredb - calibredb

calibredb command [options] [arguments]

calibredb is the command line interface to the calibre database. It has several sub-commands, documented below.

calibredb can be used to manipulate either a calibre database specified by path or a calibre Content server running either on the local machine or over the internet. You can start a calibre Content server using either the calibre-server program or in the main calibre program click Connect/share  →  Start Content server. Since calibredb can make changes to your calibre libraries, you must setup authentication on the server first. There are two ways to do that:

To connect to a running Content server, pass the URL of the server to the --with-library option, see the documentation of that option for details and examples.

전역 옵션¶

LIST¶

calibredb list [options]

calibre 데이터베이스에 등록되어 있는 책들의 목록을 표시합니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

ADD¶

calibredb add [옵션] 파일1 파일2 파일3 ...

지정된 파일을 데이터베이스에 책으로 추가합니다. 폴더를 지정할 수도 있습니다. 아래의 폴더 관련 옵션을 참조하십시오.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

REMOVE¶

calibredb remove ids

ids로 식별되는 책을 데이터베이스에서 제거합니다. ids는 ID 번호의 쉼표 구분 목록이어야 합니다(ID 번호는 search 명령으로 확인할 수 있습니다). 예: 23,34,57-85(범위를 지정할 때 범위의 마지막 숫자는 포함되지 않습니다).

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

ADD_FORMAT¶

calibredb add_format [options] id ebook_file

ebook_file의 전자책을 id로 식별되는 논리적 책의 사용 가능한 형식에 추가합니다. id는 search 명령으로 확인할 수 있습니다. 형식이 이미 존재하면 바꾸지 않기 옵션이 지정된 경우를 제외하고 대체됩니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

REMOVE_FORMAT¶

calibredb remove_format [options] id fmt

id로 식별되는 논리적 책에서 fmt 형식을 제거합니다. id는 search 명령으로 확인할 수 있습니다. fmt는 LRF, TXT, EPUB 같은 파일 확장자여야 합니다. 논리적 책에 fmt 형식이 없으면 아무 작업도 하지 않습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

SHOW_METADATA¶

calibredb show_metadata [options] id

id로 식별되는 책의 calibre 데이터베이스에 저장된 메타데이터를 표시합니다. id는 search 명령에서 얻는 ID 번호입니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

SET_METADATA¶

calibredb set_metadata [options] book_id [/path/to/metadata.opf]

book_id로 식별되는 책의 calibre 데이터베이스 메타데이터를 OPF 파일 metadata.opf의 내용으로 설정합니다. book_id는 search 명령에서 얻는 책 ID 번호입니다. OPF 형식은 show_metadata 명령에 --as-opf 스위치를 사용해 빠르게 확인할 수 있습니다. --field 옵션을 사용해 개별 필드의 메타데이터를 설정할 수도 있습니다. --field 옵션을 사용하면 OPF 파일을 지정할 필요가 없습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

EXPORT¶

calibredb export [options] ids

ids(쉼표로 구분된 목록)로 지정한 책을 파일 시스템으로 내보냅니다. 내보내기 작업은 책의 모든 형식, 표지, 메타데이터(OPF 파일)를 저장합니다. 책에 연결된 추가 데이터 파일도 함께 저장됩니다. id 번호는 search 명령으로 확인할 수 있습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

CATALOG¶

calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [옵션]

경로/대상 확장으로 지정된 형식으로 범주를 내보냅니다. 옵션은 생성된 범주 출력에 항목이 표시되는 방식을 제어합니다. 서로 다른 범주 형식은 서로 다른 옵션 집합을 지원합니다. 다른 옵션을 보려면 출력 파일 이름을 지정한 다음 --help 옵션을 지정하십시오.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

SAVED_SEARCHES¶

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

Manage the saved searches stored in this database. If you try to add a query with a name that already exists, it will be replaced.

Syntax for listing, the default action:

calibredb saved_searches list

Syntax for adding:

calibredb saved_searches add search_name search_expression

Syntax for removing:

calibredb saved_searches remove search_name

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

ADD_CUSTOM_COLUMN¶

calibredb add_custom_column [options] label name datatype

사용자 지정 열을 만듭니다. label은 열의 내부용 이름입니다. 공백이나 콜론을 포함하면 안 됩니다. name은 사용자가 보는 열 이름입니다. datatype은 다음 중 하나입니다: bool, comments, composite, datetime, enumeration, float, int, rating, series, text

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

CUSTOM_COLUMNS¶

calibredb custom_columns [옵션]

사용 가능한 사용자 지정 열을 나열합니다. 열 레이블과 ID를 표시합니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [options] label

label로 식별되는 사용자 지정 열을 제거합니다. 사용 가능한 열은 custom_columns 명령으로 확인할 수 있습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

SET_CUSTOM¶

calibredb set_custom [options] column id value

id로 식별되는 책의 사용자 지정 열 값 설정. ID 목록은 search 명령으로 확인할 수 있습니다. 사용자 지정 열 이름 목록은 custom_columns 명령으로 확인할 수 있습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

RESTORE_DATABASE¶

calibredb restore_database [options]

Restore this database from the metadata stored in OPF files in each folder of the calibre library. This is useful if your metadata.db file has been corrupted.

WARNING: This command completely regenerates your database. You will lose all saved searches, user categories, plugboards, stored per-book conversion settings, and custom recipes. Restored metadata will only be as accurate as what is found in the OPF files.

The exit status is 0 if the restore succeeded, 1 if it failed completely and 2 if the database was restored but some books or other data could not be.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

CHECK_LIBRARY¶

calibredb check_library [options]

라이브러리를 나타내는 파일 시스템에 대해 몇 가지 검사를 수행합니다. 보고서는 invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, malformed_formats, malformed_paths, failed_folders임

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

LIST_CATEGORIES¶

calibredb list_categories [options]

데이터베이스의 범주 정보에 대한 보고서를 생성합니다. 이 정보는 태그 브라우저에 표시되는 내용과 같습니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

BACKUP_METADATA¶

calibredb backup_metadata [options]

데이터베이스에 저장된 메타데이터를 각 책 폴더의 개별 OPF 파일로 백업합니다. 보통은 자동으로 수행되지만, --all 옵션을 사용하면 이 명령으로 OPF 파일을 강제로 다시 생성할 수 있습니다.

일반적으로는 이렇게 할 필요가 없습니다. 메타데이터가 변경될 때마다 OPF 파일이 자동으로 백업되기 때문입니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

CLONE¶

calibredb clone path/to/new/library

현재 라이브러리의 복제본을 만듭니다. 이 명령은 현재 라이브러리와 동일한 사용자 지정 열, 가상 라이브러리 및 기타 설정을 가진 새 빈 라이브러리를 만듭니다.

복제된 라이브러리에는 책이 들어 있지 않습니다. 책까지 포함한 전체 복사본을 만들고 싶다면 파일 시스템 도구를 사용해 라이브러리 폴더를 그대로 복사하십시오.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

EMBED_METADATA¶

calibredb embed_metadata [options] book_id

calibre 데이터베이스의 메타데이터를 calibre 라이브러리에 저장된 실제 책 파일에 반영합니다. 일반적으로 메타데이터는 calibre에서 파일을 내보낼 때만 갱신되므로, 파일 자체를 제자리에서 갱신하고 싶을 때 이 명령이 유용합니다. 파일 형식마다 지원하는 메타데이터의 양이 다르다는 점에 유의하십시오. 모든 책의 메타데이터를 갱신하려면 book_id에 특수 값 'all'을 사용할 수 있습니다. 공백으로 구분한 여러 책 ID와 하이픈으로 구분한 ID 범위도 지정할 수 있습니다. 예: calibredb embed_metadata 1 2 10-15 23

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

SEARCH¶

calibredb search [옵션] search expression

지정된 검색어에 대해 라이브러리를 검색하여 검색 표현식과 일치하는 책 ID의 쉼표로 구분된 목록을 반환합니다. 출력 형식은 ID 목록을 입력으로 허용하는 다른 명령에 입력하는 데 유용합니다.

검색 표현식은 calibre의 강력한 검색어 언어의 모든 것이 될 수 있습니다. 예: calibredb search author:asimov 'title:"i robot"'

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

FTS_INDEX¶

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

전체 텍스트 검색 색인 처리 과정을 제어합니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

FTS_SEARCH¶

calibredb fts_search [옵션] 검색 표현식

전체 라이브러리 또는 그 일부에서 전체 텍스트 검색을 수행합니다.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

NOTES¶

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

Manage the notes attached to items such as authors, series, tags and publishers. FIELD is the lookup name of the field, for example: authors, series, tags, publisher or #mycolumn. ITEM is the name of the item, for example the name of an author. Items are matched case insensitively.

List the items that have notes, optionally only those in the specified field. This is the default action:

calibredb notes list [FIELD]

Search the text of notes using the same SQLite full text search syntax as the Browse notes tool in calibre. Print the field, item name and an excerpt for each match. Use --field to search only the notes in a particular field:

calibredb notes search "search expression" calibredb notes search --field authors "search expression"

Print the note for an item as Markdown formatted text, or with --as-html as an HTML document with any images embedded, suitable for use with set:

calibredb notes show FIELD ITEM

Replace the note for an item with the contents of an HTML file. Use - to read the HTML from standard input. Images embedded as base64-encoded data: URLs are added to the note for both local and remote libraries. When using a local library and reading from a file, images referenced by paths relative to the file are added as well:

calibredb notes set FIELD ITEM FILE

Remove the note for an item:

calibredb notes remove FIELD ITEM

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

ITEMS¶

calibredb items [options] (rename|remove) FIELD ITEM ...

Rename or remove items such as authors, tags, series and publishers in all books, the same as the Manage authors, tags, etc. actions in the calibre interface. FIELD is the lookup name of the field, for example: authors, tags, series, publisher or #mycolumn. Items are matched case insensitively.

Rename an item. If an item named NEW_NAME already exists, the two items are merged. For fields that contain multiple values, NEW_NAME can contain more than one value, separated by the separator for the field, for example a comma for tags. The item is then replaced by all the values:

calibredb items rename FIELD ITEM NEW_NAME

Remove one or more items from all books. Authors cannot be removed:

calibredb items remove FIELD ITEM [ITEM ...]

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

VIRTUAL_LIBRARIES¶

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

Manage the Virtual libraries of this library. A Virtual library is a search that behaves as though the library contains only the books it matches. To list or search the books in a Virtual library, use: calibredb search 'vl:"name"'

List the Virtual libraries, with their searches and number of books. This is the default action:

calibredb virtual_libraries list

Create a Virtual library from a search:

calibredb virtual_libraries add name search_expression

Rename a Virtual library:

calibredb virtual_libraries rename name new_name

Remove Virtual libraries, the books in them are not changed:

calibredb virtual_libraries remove name ...

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

ANNOTATIONS¶

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

Manage the annotations, that is the highlights and bookmarks, of books, as created in the calibre E-book viewer or synced from other applications.

List the annotations, with their ids. This is the default action:

calibredb annotations list

Search highlighted text, annotation notes and bookmark titles using the same SQLite full text search syntax as the Browse annotations tool. Results are ordered by relevance and include annotation ids, book titles and matching excerpts. Use --search to restrict the books, --type to restrict the annotation type, --user-type and --annotation-user to restrict the user, --no-stemming to match exact word forms, or --format json for a JSON array of results including the annotation data and excerpts:

calibredb annotations search "search expression"

Export the annotations as plain text, Markdown or JSON, grouped by book. The JSON is the same calibre annotation collection as created by the Export button in the Browse annotations tool:

calibredb annotations export

Import a calibre annotation collection exported as JSON by this command or the Browse annotations tool. The collection must contain annotations from only one book. BOOK_ID is the destination book id, not the id stored in the file. Only the annotations of the format FORMAT are imported, annotations of other formats are skipped. FORMAT must exist in the destination book. Use the same edition of the book so positions match:

calibredb annotations import BOOK_ID FORMAT FILE

Use - for FILE to read from standard input. The entire collection is validated before importing. Annotations are merged with existing ones using the viewer's rules: highlights are matched by UUID and bookmarks by title, and the newer timestamp wins. Repeated imports do not create duplicates. Unrelated annotations and reading positions are preserved.

By default annotations are imported into those of the calibre E-book viewer. Use --user-type web --annotation-user USER to import them into those of a Content server user instead. Exported collections record the user the annotations belong to, and if a collection contains annotations of more than one user, it is rejected. Use the --user-type and --annotation-user options when exporting, to export the annotations of a single user.

Permanently remove the annotations with the specified ids, as shown by list:

calibredb annotations remove ID ...

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

TRASH¶

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

Manage the books and formats that have been removed and placed in the trash bin. Entries in the trash bin are permanently deleted automatically after some days. ids is a comma separated list of book ids, as for the remove command, for example: 23,34,57-85 (when specifying a range, the last number in the range is not included).

List the removed books and formats, most recently removed first, with the times they were removed in local time. Removed formats of books that no longer exist are marked as not restorable, they can only be deleted. With --for-machine, the times are in UTC:

calibredb trash list

Restore removed books, or with --formats, the removed formats of books:

calibredb trash restore ids

Permanently delete entries from the trash bin:

calibredb trash delete ids

Permanently delete everything in the trash bin:

calibredb trash empty

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

DATA_FILES¶

calibredb data_files [options] (list|add|get|rename|remove) BOOK_ID ...

Manage the extra data files associated with a book, in local or remote libraries. Names are relative to the book's data directory. Use / for subdirectories, is also accepted. Files whose names contain a are listed, but cannot otherwise be managed. E-book formats, covers and metadata.opf cannot be accessed with this command. Remote libraries require an account with write access, as for other management commands, and do not support accounts with per-library search restrictions.

List file names, sizes in bytes and modification times (seconds since the Unix epoch). Use --for-machine for JSON output:

calibredb data_files list BOOK_ID

Add a file, using its basename, or --name to specify a name or subdirectory. Existing files are not replaced unless --replace is specified. This is also available through add_format --as-extra-data-file:

calibredb data_files add BOOK_ID FILE

Save one data file to --output on the local machine. Existing output files are not replaced unless --replace is specified:

calibredb data_files get BOOK_ID NAME --output FILE

Rename a file. Existing destinations are not replaced unless --replace is set:

calibredb data_files rename BOOK_ID NAME NEW_NAME

Remove a file to the operating system's recycle bin. With --permanent, delete it permanently instead. For remote libraries this happens on the server:

calibredb data_files remove BOOK_ID NAME

Directories left empty by rename and remove are deleted. With remote libraries, each file is transferred in a single request, so very large files need enough memory on both the client and the server, and uploads are limited by the maximum request size of the server.

calibredb에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal