Use this page to find where a control lives. Each row is one card.
- Open Settings from the sidebar or at
/settings.
- The open tab is in the URL, for example
/settings?tab=downloads.
- Link a single card with
s and its id, for example /settings?s=sign-in.
- The command palette searches card names and keywords.
- After an upgrade, a New tab lists the settings added since the version you upgraded from, each
linked to where it normally lives, and those settings carry a New pill on their usual tab. Both
stay until the next upgrade, and a fresh install doesn’t show them.
- Admin cards change the server. Admin cards and cards that need a permission are hidden from accounts without it.
| Card |
Who sees it |
What it holds |
| Sign-in |
Everyone |
Password, active sessions and sign out, two-factor authentication, linking single sign-on. |
| API keys |
Everyone |
Creating and revoking the keys used for the REST API. See API keys and the OpenAPI spec. |
| Card |
Who sees it |
What it holds |
| Appearance |
Everyone |
Theme (light, dark or match the system), accent colour, and motion (page transitions, moving covers and faster animations, which stay off when the device asks for reduced motion). |
| Language |
Everyone |
Interface language. |
| Title language |
Everyone |
Which form of series titles to show, such as romaji, native or original. |
| Content rating |
Everyone with the ChangeContentRating permission |
Which content ratings you see. |
| Start page & Home |
Everyone |
The start page, the Home sections, their order and layout. |
| Series page |
Everyone |
Related-series rails on a series page. |
| Notifications |
Everyone |
In-app notifications, including new chapters, achievements, and new sequels and spin-offs of series you read. |
| Push notifications |
Everyone |
Browser push notifications, and whether this device receives them. |
| Card |
Who sees it |
What it holds |
| Reader profiles |
Everyone |
Reading direction, page fit, tap zone layout, page background, auto next chapter, skip recaps, hide credit pages, progress rail, Enhance, and profiles by series type. |
| Progress & achievements |
Everyone |
Achievements, levels, streak and reading goal, leaderboard, time zone. |
| Reading status |
Everyone |
Optional rules that put a series on hold, or drop it, after a number of days without reading. |
| Rating prompts |
Everyone |
Whether Maki asks how a series is going while you read, and at the end of each volume. |
| OPDS catalogue |
Permission UseOpds |
Your feed URL and token for reading apps, and the Komga address. |
| KOReader progress sync |
Permission UseOpds |
Syncing reading progress with KOReader. |
| Offline reading |
Everyone |
Saving series to this device for offline reading, and installing Maki as an app. |
| Kavita read sync |
Everyone, only when a Kavita connection exists |
Pushing read status to Kavita and importing it from Kavita. |
| Card |
Who sees it |
What it holds |
| Root folders |
Admin |
The library folders Maki reads, with the free space on each and the free space to keep before downloads wait (5 GB by default). Add one by path or with the folder browser, or edit one whose path changed. |
| Root folder rules |
Admin |
Which root folder a new series goes to, by type, genre, content rating, who added it or how. |
| Drop folder |
Admin |
A folder Maki checks every few minutes and imports matching files from. |
| Folder & file naming |
Admin |
Naming templates for series folders and files, and renaming existing ones. |
| File name parsing |
Admin |
The markers and terms Maki looks for in file names, such as volume and chapter markers. |
| ComicInfo & covers |
Admin |
Writing ComicInfo.xml into imported files, and saving a cover.jpg in each series folder. |
| Page conversion |
Admin |
Converting pages to WebP, AVIF or JPEG XL to save disk space, splitting tall pages, how many pages convert at once, and the pass over the existing library. The setup has its own page at /settings/page-conversion. |
| Server upscaling |
Admin |
Whether upscaling is on, the models to download, CPU threads, JPEG XL for colour pages, the disk cache size, and Prepare chapters ahead. |
| Credit pages |
Admin |
Finding credit pages across the library in the background, and the release groups behind them. |
| Recycle bin |
Permission DeleteSeries |
How long deleted files are kept (14 days by default) and restoring them. |
| New series defaults |
Admin |
Defaults for new series: monitoring, skip specials, incognito. |
| Auto-tag rules |
Permission ManageTags |
Tagging a new series as it is added, by genre, type, content rating, root folder or how it came in. |
| Metadata database |
Admin |
The local MangaBaka database: its status and a refresh. |
| Semantic search & recommendations |
Admin |
The embedding model behind semantic search and recommendations. |
Every card on this tab is admin only.
| Card |
What it holds |
| Download queue |
Concurrent chapter downloads, retry attempts, and the time before giving up on a chapter. |
| Smart Download |
Smart Download and its unread trigger. |
| Clean up read chapters |
Automatic deletion of read chapters, with a retention period. |
| Languages |
The languages to download, and their priority. |
| Sources |
Source order and priority, which sources are on, adult sources, looking for volume releases first, and custom sources and their repositories. |
| FlareSolverr |
The FlareSolverr address, used for Cloudflare-protected sources. |
| Indexer |
The indexer connection (Prowlarr or Jackett) and its categories. |
| Download client |
The torrent client (qBittorrent, Transmission or Deluge), its categories and path mapping, whether finished torrents are hardlinked, whether they are removed right after import or after seeding, the stalled torrent limit, and the declined releases list. |
| Quality profiles |
Upgrade profiles: the cutoff score, the minimum gain and maximum loss limits, and the resolution and compression weights. |
| Quality formats |
Format scores and the conditions that match them, such as regex, minimum width and image format. |
| Upgrade scan |
The default profile and automatic upgrades. |
| Volume releases |
Searching for volume packs and grabbing them, searching for chapters no source has, minimum seeders, and approving volume releases automatically. |
| Card |
Who sees it |
What it holds |
| Kavita |
Admin |
The Kavita connection, its libraries, path mapping, and which account owns progress. |
| Suwayomi |
Admin |
The Suwayomi connection and its extension sources. See Built-in sources. |
| Trackers |
Permission UseTrackers |
AniList, MyAnimeList, Kitsu, MangaUpdates and MangaBaka connections, rating sync for each one (including “so far” ratings), and the sync interval. |
| Import lists |
Permission UseTrackers |
Importing series from tracker lists, with optional automatic adding. |
| Notification connections |
Admin |
Outgoing notifications to Discord, webhooks, Telegram, ntfy and other services, and the events each one receives. |
Every card on this tab is admin only.
| Card |
What it holds |
| Users |
Accounts, their permissions, adding users and disabling them. Single-user mode is a control inside this card. |
| Sign-in policy |
Lockout after failed attempts, and session lifetime. |
| Sign-in page |
The blurred cover mosaic behind the sign-in card. |
| Single sign-on |
The OpenID Connect provider: issuer, client details and automatic provisioning. |
Every card on this tab is admin only.
| Card |
What it holds |
| Network |
The HTTPS requirement (which also sends HSTS), trusted proxies and allowing other devices on your network. |
| Backup & restore |
Creating and restoring backups, scheduled backups, and how many to keep. |
| Image cache |
Rebuilding the image cache and clearing cached covers. |
| Library health |
Automatic scanning and the daily reconciliation, when it runs, and the disk and backup freshness thresholds. |
| Updates |
Checking for a new Maki version. |