5
Media Management
misleadingrhino edited this page 4 years ago
Root Folders
These are directories that will be scanned for books.
| Option Name | Description |
|---|---|
| Name | How the folder will be named. Has no effect. |
| Path | The path of an existing Calibre Library. Make sure Readarr has read/write permission. If you are using Docker, you should map this path to a volume in your machine. Do not keep your library inside a Docker container. |
| Use Calibre Library | Whether to use an existing Calibre Server to manage library. |
| Monitor | Change how to monitor the books in the folder. |
| Quality Profile | See Quality Profiles for more info. |
| Metadata Profile | See Metadata Profiles for more info. |
| Default Readarr Tags | Auto-tag authors found in this folders. |
Calibre-specific Options
This options are only visible when Use Calibre Library is selected. Read more about calibre-server here.
| Option Name | Description |
|---|---|
| Calibre Host | The host of the calibre server. By default it's localhost (aka the local machine). |
| Calibre Port | The port where calibre-server is listening on. |
| Calibre Username/Password | A username and password used to log in to your calibre content server. |
| Convert to format | Automatically ask calibre to convert to these formats when adding a book to the library. |
| Calibre Output Profile | ??? |
| Use SSL | Wether to use a secure connection when accessing the calibre server. |
Calibre Gotchas
- (Calibre Host) If you are using docker, localhost points to the container, not the machine it's running on.
- (Calibre User/Pass) Readarr only works if calibre-server is set on basic auth mode. When starting calibre-server, add
--auth-mode basic. For more help on managing users, see this here. - In order for calibre-server to work, you'll need to set up a remote path map (see example below).
- Using the file renaming option with Calibre may cause problems, recommend turning this option off.
Remote Path Mappings
Remote path mappings are used to link Readarr paths and remote paths. Say you have a calibre-server running on another docker container, and its path to the calibre library is /Library. Readarr asks calibre for paths, so you'll have to map the calibre (or remote) path to your local path. This is also the case when setting up a download client. You will need to map a local path with the one that your client uses to download.
This is an example configuration. The top map is the download client, the bottom one is calibre-server:
