NAME¶

calibredb - calibredb

calibredb command [options] [arguments]

:command:

calibredb`는 calibre 데이터베이스의 명령줄 인터페이스입니다. 여기에는 아래에 문서화된 여러 하위 명령이 있습니다.

calibredb`는 경로로 지정된 calibre 데이터베이스나, 로컬 컴퓨터 또는 인터넷을 통해 실행 중인 calibre :guilabel:`콘텐츠 서버`를 조작하는 데 사용할 수 있습니다. calibre :guilabel:`콘텐츠 서버`는 :command:`calibre-server 프로그램을 사용하거나, calibre 메인 프로그램에서 :guilabel:

연결/공유 -> 콘텐츠 서버 시작`을 클릭하여 시작할 수 있습니다. :command:

calibredb`는 calibre 라이브러리를 변경할 수 있으므로, 먼저 서버에 인증을 설정해야 합니다. 이를 위한 방법은 두 가지입니다.

•: 같은 컴퓨터에서 실행 중인 서버에만 연결할 계획이라면,

콘텐츠 서버의 --enable-local-write 옵션을 사용하여 로컬 컴퓨터에서 실행 중인 모든 프로그램(calibredb 포함)이 calibre 데이터에 변경을 가할 수 있도록 하면 됩니다. 메인 calibre 프로그램에서 서버를 실행하는 경우, 이 옵션은 :guilabel:

환경설정->네트워크 공유->고급`에 있습니다. 다만 주의해야 합니다. 특히 Firefox 같은 일부 브라우저는 임의의 웹사이트도 로컬 서버에 접근할 수 있도록 허용합니다. Firefox를 사용한다면, 아래에 설명된 것처럼 사용자 이름과 비밀번호를 설정하는 편이 더 좋습니다. 로컬 네트워크 접근 제한은 Firefox v149 기준으로도 아직 구현되지 않았습니다.

•: 인터넷을 통한 접근을 허용하려면, 서버에 사용자 계정을 설정하고

calibredb`의 :option:--username` 및 --password 옵션을 사용하여 접근 권한을 부여해야 합니다. calibre-server`의 사용자 인증은 `--enable-auth`` 옵션을 사용하고

``

--manage-users``로 사용자 계정을 생성하여 설정할 수 있습니다. 메인 calibre 프로그램에서 서버를 실행하는 경우에는 :guilabel:

환경설정->네트워크 공유->사용자 이름/비밀번호 요구`를 사용하십시오.

실행 중인 콘텐츠 서버에 연결하려면 서버의 URL을 --with-library 옵션에 전달하십시오. 자세한 내용과 예시는 해당 옵션의 문서를 참조하십시오.

전역 옵션
list
add

•: 폴더에서 추가

remove
add_format
remove_format
show_metadata
set_metadata
export
catalog

•: EPUB 옵션

saved_searches
add_custom_column
custom_columns
remove_custom_column
set_custom
restore_database
check_library
list_categories
backup_metadata
clone
embed_metadata
search
fts_index
fts_search

전역 옵션¶

--help, -h: 이 도움말 메시지를 표시한 후 종료

--library-path, --with-library: calibre 라이브러리 경로입니다. 기본값은 설정에 저장된 경로를 사용하는 것입니다. 원격 라이브러리에서 작업을 수행하려면 calibre 콘텐츠 서버에 연결할 수도 있습니다. 이를 위해서는 <http://hostname:port/#library_id> 형식의 URL을 사용하십시오. 예: <http://localhost:8080/#mylibrary>. library_id는 콘텐츠 서버에서 연결하려는 라이브러리의 ID입니다. 특수한 library_id 값인 - 를 사용하면 서버에서 사용 가능한 라이브러리 ID 목록을 얻을 수 있습니다. 콘텐츠 서버를 통한 접근 설정 방법은 <https://manual.calibre-ebook.com/ko/generated/ko/calibredb>.html을 참조하십시오.

--password: calibre 콘텐츠 서버에 연결할 때 사용할 비밀번호입니다. 표준 입력에서 비밀번호를 읽으려면 특수 값 <stdin>을 사용하십시오. 파일에서 비밀번호를 읽으려면 <f:/path/to/file>을 사용하십시오(즉, <f: 다음에 파일의 전체 경로를 쓰고 마지막에 >를 붙입니다). 위의 꺾쇠괄호는 필수이므로 셸에서 이스케이프하거나 따옴표로 감싸야 합니다.

--timeout: 네트워크를 통해 캘리버 라이브러리에 연결할 때의 제한 시간(초)입니다. 기본값은 2분입니다.

--username: 캘리버 콘텐츠 서버에 연결할 사용자 이름

--version: 프로그램의 버전을 표시한 후 종료합니다.

LIST¶

calibredb list [options]

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

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

--ascending: 오름차순의 결과로 정렬합니다

--fields, -f: 데이터베이스의 책 목록을 표시할 때 보여줄 필드입니다. 필드는 쉼표로 구분해 지정해야 합니다. 사용 가능한 필드: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid 기본값: title,authors. 특수 필드 "all"을 사용하면 모든 필드를 선택할 수 있습니다. 위의 내장 필드 외에도 사용자 정의 필드는 *field_name 형식으로 사용할 수 있습니다. 예를 들어 사용자 정의 필드 #rating은 *rating을 사용하십시오

--for-machine: 기계로 처리하기 더 적합한 JSON 형식으로 출력합니다. 이 경우 줄 너비와 구분자 옵션은 무시됩니다.

--limit: 표시할 최대 결과 수입니다. 기본값: 전체

--line-width, -w: 출력에서 한 줄의 최대 너비입니다. 기본값은 화면 크기 자동 감지입니다.

--prefix: 모든 파일 경로의 접두사입니다. 기본값은 라이브러리 폴더의 절대 경로입니다.

--search, -s: 검색 쿼리로 결과를 필터링합니다. 검색 쿼리 의 형식은 사용자 설명서에서 검색 관련 설명서를 참조하십시오. 기본값은 필터링을 하지 않는 것입니다.

--separator: 문자열은 필드를 구분하는데 사용됩니다. 기본값은 공백입니다.

--sort-by: 결과를 정렬할 필드입니다. 쉼표로 구분해 여러 필드를 지정할 수 있습니다. 사용 가능한 필드: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid 기본값: id. 위의 내장 필드 외에도 사용자 정의 필드는 *field_name 형식으로 사용할 수 있습니다. 예를 들어 사용자 정의 필드 #rating은 *rating을 사용하십시오

--template: 필드 목록에 "template"가 있을 때 실행할 템플릿입니다. calibre 서버에 연결 중일 때는 템플릿이 무시된다는 점에 유의하십시오. 기본값: None

--template_file, -t: "template"가 필드 목록에 있을 때 실행할 템플릿이 들어 있는 파일 경로입니다. 기본값: 없음

--template_heading

템플릿 열의 제목입니다. 기본값: template. 옵션 :option:

--for-machine`이(가) 설정되어 있으면 이 옵션은 무시됩니다

ADD¶

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

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

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

--authors, -a: 추가된 책(들)의 저자를 입력하기

--automerge, -m: 비슷한 제목과 저자를 가진 책이 발견되면 들어오는 형식(파일)을 기존 책 레코드에 자동으로 병합합니다. "ignore" 값은 중복 형식을 버린다는 뜻입니다. "overwrite" 값은 라이브러리의 중복 형식을 새로 추가한 파일로 덮어쓴다는 뜻입니다. "new_record" 값은 중복 형식을 새 책 레코드에 넣는다는 뜻입니다.

--cover, -c: 추가된 책에 사용할 표지의 경로

--duplicates, -d: --automerge 옵션이 우선 적용된다는 점에 유의하십시오. 이미 존재하는 책이라도 데이터베이스에 추가합니다. 비교는 책 제목과 저자를 기준으로 수행됩니다.

--empty, -e: 비어있는 책 추가하기 (형식이 없는 책)

--identifier, -I: 이 책의 식별자를 설정하십시오. 예: -I asin:XXX -I isbn:YYY

--isbn, -i: 추가된 책(들)의 ISBN을 입력하기

--languages, -l: 쉼표로 구분된 언어 목록 (일부 언어 이름도 인식될 수 있지만, ISO639 언어 코드를 사용하는 것이 가장 좋습니다)

--series, -s: 추가된 책(들)의 시리즈를 입력하기

--series-index, -S: 추가된 책(들)의 일련번호을 입력하기

--tags, -T: 추가된 책(들)의 태그를 입력하기

--title, -t: 추가된 책(들)의 이름을 입력하기

폴더에서 추가¶

폴더에서 책을 추가하는 동작을 제어하는 옵션입니다. 기본적으로 알려진 전자책 파일 형식 확장자를 가진 파일만 추가됩니다.

--add: 파일명(글롭) 패턴입니다. 폴더에서 파일을 검색할 때 이 패턴과 일치하는 파일은 알려진 전자책 파일 형식이 아니어도 추가됩니다. 여러 패턴을 지정하려면 이 옵션을 여러 번 지정할 수 있습니다.

--ignore: 파일명(글롭) 패턴입니다. 폴더에서 파일을 검색할 때 이 패턴과 일치하는 파일은 무시됩니다. 여러 패턴을 지정하려면 이 옵션을 여러 번 지정할 수 있습니다. 예: *.pdf 는 모든 PDF 파일을 무시합니다

--one-book-per-directory, -1: 각 폴더에 논리적으로 하나의 책만 들어 있으며, 그 안의 모든 파일은 그 책의 서로 다른 전자책 형식이라고 가정합니다

--recurse, -r: 폴더를 재귀적으로 처리

REMOVE¶

calibredb remove ids

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

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

--permanent: 휴지통 사용 안 함

ADD_FORMAT¶

calibredb add_format [options] id ebook_file

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

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

--as-extra-data-file: 이 파일을 전자책 형식이 아니라 책의 추가 데이터 파일로 추가

--dont-replace: 이미 존재하는 형식이면 바꾸지 마세요

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"

--as-opf: OPF 양식(XML)에서 메타데이터를 인쇄합니다

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"

--field, -f: 설정할 필드입니다. 형식은 field_name:value입니다(예: --field tags:tag1,tag2). --list-fields`을 사용하여 모든 필드 이름 목록을 가져옵니다. 이 옵션을 여러 번 지정하여 여러 필드를 설정할 수 있습니다. 참고: 언어의 경우 ISO639 언어 코드를 사용해야 합니다(예: 영어는 en, 프랑스어는 fr 등). 식별자의 경우 구문은 :option:--field` identifiers:isbn:XXXX,doi:YYYYY입니다. 불리언(예/아니요) 필드의 경우 참/거짓 또는 예/아니요를 사용합니다.

--list-fields, -l: --field 옵션과 함께 사용할 수 있는 메타데이터 필드 이름 나열

EXPORT¶

calibredb export [options] ids

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

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

--all: 데이터베이스의 모든 책을 내보냅니다. ID 목록은 무시합니다.

--dont-asciiize: 파일 이름에 있는 모든 비영어 문자를 영어 대응 문자로 변환하도록 calibre에 지시합니다. 유니코드 파일명을 완전히 지원하지 않는 구형 파일 시스템에 저장할 때 유용합니다. 이 스위치를 지정하면 이 동작이 꺼집니다.

--dont-save-cover: 보통, 캘리버는 표지를 실제 전자책 파일과 함께 별도의 파일에 저장합니다. 이 스위치를 지정하면 이 동작이 꺼집니다.

--dont-save-extra-files: 책을 저장할 때 책과 연결된 데이터 파일도 함께 저장 이 스위치를 지정하면 이 동작이 꺼집니다.

--dont-update-metadata: 캘리버가 캘리버 라이브러리에 있는 메타데이터를 가져와 저장된 파일의 메타데이터를 업데이트합니다. 디스크에 저장하는 시간이 더 걸리게 됩니다. 이 스위치를 지정하면 이 동작이 꺼집니다.

--dont-write-opf: 보통, 캘리버는 실제 전자책 파일과 함께 분리된 OPF 파일 내에 메타데이터를 기록합니다. 이 스위치를 지정하면 이 동작이 꺼집니다.

--formats: 책마다 저장할 형식의 목록이며 쉼표로 구분합니다. 기본값으로 모든(all) 이용가능한 형식으로 저장됩니다.

--progress: 진행 상황 보고

--replace-whitespace: 공백 문자를 밑줄로 교체합니다.

--single-dir: 모든 책을 하나의 폴더로 내보내기

--template: 저장되는 파일의 파일명과 폴더 구조를 제어하는 템플릿입니다. 기본값은 "{author_sort}/{title}/{title} - {authors}"이며 제목과 저자가 포함된 파일명을 사용해 저자별 하위 폴더에 책을 저장합니다. 사용할 수 있는 제어 항목은 다음과 같습니다: {author_sort, authors, id, isbn, languages, last_modified, pages, pubdate, publisher, rating, series, series_index, tags, timestamp, title}

--timefmt: 날짜를 표시하는 양식. %d - 일, %b - 월, %m - 월(숫자), %Y - 년도. 기본값: %b, %Y

--to-dir: 책을 지정한 폴더로 내보냅니다. 기본값: .

--to-lowercase: 경로를 소문자로 변환합니다.

CATALOG¶

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

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

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

--ids, -i

범주에 추가할 데이터베이스 ID의 쉼표로 구분된 목록입니다. 선언되면, :option:

--search`는 무시됩니다. 기본값: 모두

--search, -s: 검색 쿼리로 결과를 필터링합니다. 검색 쿼리 의 형식은 사용자 설명서에서 검색 관련 문서를 참조하십시오. 기본값: 필터링 없음

--verbose, -v: 상세한 출력 정보를 표시합니다. 디버깅 시에 유용합니다.

EPUB 옵션¶

--catalog-title: 메타데이터에서 제목으로 사용되는 생성된 범주의 제목입니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--cross-reference-authors: 여러 저자가 있는 책의 저자 섹션에서 상호 참조를 만듭니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--debug-pipeline: 변환 파이프라인의 다른 단계에서 출력을 지정된 폴더에 저장합니다. 변환 프로세스의 어느 단계에서 버그가 발생하는지 확실하지 않은 경우 유용합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--exclude-genre: 장르로 제외할 태그를 설명하는 정규식입니다. 기본값: '기본값(%d)'은 괄호로 묶인 태그를 제외합니다(예: '[Project Gutenberg]', 및 '+', 책 읽기의 기본 태그. 적용 대상: AZW3, EPUB, MOBI 출력 형식

--exclusion-rules: 생성된 범주에서 책을 제외하는 데 사용되는 규칙을 지정합니다. 제외 규칙의 모델은 다음 중 하나입니다. ('<rule name>','태그','<comma-separated list of tags>') 또는 ('<rule name>','<custom column>','<pattern>'). 예를 들어: (('보관된 책','#상태','보관됨'),) 맞춤 열 '상태'에서 값이 '보관됨'인 책은 제외됩니다. 여러 규칙이 정의되면 모든 규칙이 적용됩니다. 기본값: "기본값(%d)" 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-authors: '저자' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-descriptions: '책 설명' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-genres: '장르' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-recently-added: '최근 추가된 항목' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-series: '시리즈' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--generate-titles: '제목' 섹션을 범주에 포함합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--genre-source-field: '장르' 섹션의 소스 필드입니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--header-note-source-field: 설명 헤더에 삽입할 메모 텍스트가 포함된 사용자 정의 필드입니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--merge-comments-rule: #<custom field>:[이전|이후]:[참|거짓] 지정: <custom field> 책 설명과 병합할 메모가 포함된 사용자 정의 필드 [이전|이후] 책 설명에 대한 책 설명 배치 [참|거짓] - 메모와 책 설명사이에 가로줄을 삽입합니다. 기본값: '::' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--output-profile: 출력 프로필을 지정합니다. 경우에 따라 장치에 맞게 카탈로그를 최적화하려면 출력 프로필이 필요합니다. 예를 들어 'kindle' 또는 'kindle_dx'를 사용하면 섹션과 기사로 구성된 구조화된 목차가 만들어집니다. 기본값: 'None' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--prefix-rules: 읽은 책, 위시리스트 항목 및 기타 사용자 지정 접두사를 나타내는 접두사를 포함하는 데 사용되는 규칙을 지정합니다. 접두사 규칙의 모델은 ('<rule name>','<source field>','<pattern>','<prefix>')입니다. 여러 규칙이 정의된 경우 첫 번째 일치 규칙이 사용됩니다. 기본값: "기본값(%d)" 적용 대상: AZW3, EPUB, MOBI 출력 형식

--preset: GUI 범주 빌더로 작성된 명명된 프리셋을 사용합니다. 프리셋은 범주 작성을 위한 모든 설정을 지정합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--thumb-width: 범주의 책 표지에 대한 힌트 크기(인치)입니다. 범위: 1.0 - 2.0 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

--use-existing-cover: 범주 생성 시 기존 표지를 교체합니다. 기본값: '기본값(%d)' 적용 대상: AZW3, EPUB, MOBI 출력 형식

SAVED_SEARCHES¶

calibredb saved_searches [옵션] (list|add|remove)

이 데이터베이스에 저장된 저장된 검색을 관리합니다. 이미 존재하는 이름으로 쿼리를 추가하려고 하면 대체됩니다.

추가할때 구문:

calibredb saved_searches add search_name search_expression

제거할때 구문:

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"

--display: 이 열의 데이터가 해석되는 방식을 사용자 지정하기 위한 옵션 사전입니다. 이것은 JSON 문자열입니다. 열거 열의 경우 --display"{\ "enum_values\ ":[\ "val1\ ", \ "val2\ "]}"를 사용합니다. 표시 변수에 들어갈 수 있는 많은 옵션이 있습니다. 열 유형별 옵션은 다음과 같습니다: 복합: composite_template, composite_sort, make_category,contains_html, use_decorations 날짜시간: date_format 열거: enum_values, enum_colors, use_decorations: enum_values, enum_colors, use_decorations int, float: number_format 텍스트: is_names, use_decorations 합법적인 조합을 찾는 가장 좋은 방법은 GUI에서 적절한 유형의 사용자 지정 열을 만든 다음 책에 대한 백업 OPF를 확인하는 것입니다(열이 추가된 이후 새 OPF가 생성되었는지 확인). OPF의 새 열에 대한 "디스플레이"에 대한 JSON이 표시됩니다.

--is-multiple: 이 열은 태그와 유사한 데이터(즉, 쉼표로 구분된 여러 값)를 저장합니다. datatype이 text일 때만 적용됩니다.

CUSTOM_COLUMNS¶

calibredb custom_columns [옵션]

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

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

--details, -d: 각 열에 대한 상세 정보를 표시합니다.

REMOVE_CUSTOM_COLUMN¶

calibredb remove_custom_column [options] label

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

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

--force, -f: 확인을 다시 묻지 않음

SET_CUSTOM¶

calibredb set_custom [options] column id value

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

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

--append, -a: 열이 여러 값을 저장하는 경우 기존 값을 대체하지 않고 지정한 값을 덧붙입니다.

RESTORE_DATABASE¶

calibredb restore_database [options]

calibre 라이브러리의 각 폴더에 있는 OPF 파일에 저장된 메타데이터에서 이 데이터베이스를 복원합니다. metadata.db 파일이 손상되었을 때 유용합니다.

경고: 이 명령은 데이터베이스를 완전히 다시 생성합니다. 저장된 검색, 사용자 범주, 플러그보드, 책별 변환 설정, 사용자 정의 레시피를 모두 잃게 됩니다. 복원된 메타데이터의 정확도는 OPF 파일에 들어 있는 내용에만 의존합니다.

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

--really-do-it, -r: 실제로 복구를 수행합니다. 이 옵션을 지정하지 않으면 명령이 실행되지 않습니다.

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"

--csv, -c: CSV로 출력

--ignore_extensions, -e: 무시할 확장자의 쉼표로 구분된 목록. 기본값: 전체

--ignore_names, -n: 무시할 이름의 쉼표로 구분된 목록. 기본값: 전체

--report, -r: 쉼표로 구분된 보고서 목록입니다. 기본값: all

--vacuum-fts-db: 전체 텍스트 검색 데이터베이스를 vacuum 합니다. 데이터베이스 크기에 따라 매우 느리고 메모리를 많이 사용할 수 있습니다.

calibredb list_categories [options]

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

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

--categories, -r: 범주 조회 이름의 쉼표로 구분된 목록입니다. 기본값: 모두

--csv, -c: CSV로 출력

--dialect: 생성할 CSV 파일 유형입니다. 선택 가능 값: excel, excel-tab, unix

--item_count, -i: 범주 내 각 항목의 개수 대신 범주의 항목 수만 출력

--width, -w: 출력에서 한 줄의 최대 너비입니다. 기본값은 화면 크기 자동 감지입니다.

BACKUP_METADATA¶

calibredb backup_metadata [options]

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

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

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

--all: 기본적으로 이 명령은 오래된 OPF 파일을 가진 책에만 동작합니다. 이 옵션을 사용하면 모든 책에 대해 동작합니다.

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"

--only-formats, -f: 지정한 형식의 파일에 대해서만 메타데이터를 갱신합니다. 여러 형식을 지정하려면 이 옵션을 여러 번 사용하십시오. 기본적으로는 모든 형식이 갱신됩니다.

SEARCH¶

calibredb search [옵션] search expression

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

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

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

--limit, -l: 리턴할 결과의 최대 갯수. 기본값은 모든 결과입니다.

FTS_INDEX¶

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

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

enable: 이 라이브러리에서 FTS 색인을 켭니다
disable: 이 라이브러리에서 FTS 색인을 끕니다
status: 현재 색인 상태를 표시합니다
reindex: 특정 책 또는 전체 라이브러리를 다시 색인할 때 사용합니다. 특정 책만 다시 색인하려면 reindex 명령 뒤에 추가 인수로 책 ID를 지정하십시오. 책 ID를 지정하지 않으면 전체 라이브러리를 다시 색인합니다.

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

--indexing-speed: 색인 속도입니다. fast는 컴퓨터 자원을 모두 사용해 빠르게 색인하고, slow는 자원을 덜 쓰는 색인입니다. 이 속도 설정은 매번 실행 후 다시 slow로 초기화됩니다.

--wait-for-completion: 모든 책이 인덱싱될 때까지 주기적으로 진행 상황을 표시하며 대기

FTS_SEARCH¶

calibredb fts_search [옵션] 검색 표현식

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

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

--do-not-match-on-related-words: 관련 단어가 아닌 정확한 단어만 일치시킵니다. 따라서 correction은 correcting과 일치하지 않습니다.

--include-snippets: 각 일치 항목 주변의 텍스트 스니펫을 포함합니다. 참고로, 이 기능은 검색 속도를 훨씬 느리게 만듭니다.

--indexing-threshold: 검색을 허용하기 전에 인덱싱되어야 하는 라이브러리 비율입니다. 기본값은 90입니다.

--match-end-marker: 스니펫 내에서 일치하는 단어의 끝을 나타내는 데 사용되는 마커입니다

--match-start-marker: 스니펫 내에서 일치하는 단어의 시작을 나타내는 데 사용되는 마커입니다

--output-format: 검색 결과를 출력할 형식입니다. 일반 텍스트는 "text", JSON 출력은 "json"을 사용합니다.

--restrict-to: 검색할 책을 검색식 또는 ID로 제한합니다. 예: IDs로 제한하려면 ids:1,2,3, 태그 foo가 있는 책으로 제한하려면 search:tag:foo

Author¶

Kovid Goyal

Copyright¶

Kovid Goyal

Source file:	calibredb.1.ko.gz (from calibre 9.7.0+ds+~0.10.5-2)
Source last updated:	2026-04-11T11:53:57Z
Converted to HTML:	2026-04-11T20:45:48Z

NAME¶

전역 옵션¶

LIST¶

ADD¶

폴더에서 추가¶

REMOVE¶

ADD_FORMAT¶

REMOVE_FORMAT¶

SHOW_METADATA¶

SET_METADATA¶

EXPORT¶

CATALOG¶

EPUB 옵션¶

SAVED_SEARCHES¶

ADD_CUSTOM_COLUMN¶

CUSTOM_COLUMNS¶

REMOVE_CUSTOM_COLUMN¶

SET_CUSTOM¶

RESTORE_DATABASE¶

CHECK_LIBRARY¶

LIST_CATEGORIES¶

BACKUP_METADATA¶

CLONE¶

EMBED_METADATA¶

SEARCH¶

FTS_INDEX¶

FTS_SEARCH¶

Author¶

Copyright¶