Every setting Kustos has, where it is, and what it does — for when you know roughly what you want and not what it is called. The detail for each is further down under its own page.
Krista, 2026-09-27: "having settings and what they do on the different pages in a quick chart you can look at would be useful".
Setup → General
Setting
What it does
Instance name
The name on the tab and in notifications. Cosmetic.
External URL
The address Kustos gives out in links it sends elsewhere — invites, Telegram, webhooks. Wrong here means links that work for you and nobody else.
Timezone
The clock every schedule reads. Change it and windows move.
MDBList lookups per pass
Caps how much of the daily MDBList budget one pass may spend.
Artwork language
The language every artwork scrape prefers. Never costs coverage — a title whose only art is in another language still gets it.
Font folders
Where Kustos looks for typefaces. Kustos ships two; Kometa and TitleCardMaker install the libraries people actually want.
API keys
Access for things that are not a browser.
Setup → Subscription
Setting
What it does
Check again
Asks the licence service now instead of waiting for the next scheduled check.
Start free trial
One 30-day trial per Plex account, no card. Only offered when there has been no trial.
Manage billing
Opens Stripe's customer portal, already signed in — cancel, change your card, download invoices. Offered to anyone who has paid, including after a subscription has ended. Somebody who never subscribed is told there is nothing to manage yet.
Managing billing when you cannot reach Kustos
Kustos runs on your own machine, so the Subscription page is unreachable exactly when you may most need it: your server is off, you are away from home, or the subscription has already lapsed.
Billing does not depend on Kustos. The same Stripe portal is reachable from Manage billing in the header of every page at kustos.wiki, and again from the Get help page. Enter the email address you paid with, Stripe sends a one-time code, and you are in — no Kustos, no home network, no account on the website, and no password.
Both routes reach the same portal and do the same things. Cancelling runs to the end of the period you have already paid for, and does not renew after that.
Setup → Media management
Setting
What it does
Watch tracking
How much of a title counts as watched, and which source wins when Plex, Tautulli, Trakt and Simkl disagree.
Requests from watchlist adds
Whether adding to a watchlist creates a request.
Collection defaults
The starting values every new collection gets — sort, poster visibility, sync mode.
Housekeeping
Recycle-bin behaviour and what a reset does to files.
Genre mapping
Now per library, under that library's own defaults.
Identity reconciliation
How Kustos decides two rows are the same title.
Reset artwork
Releases Kustos's claim on artwork slots. The provenance is what is lost, not only the pixels.
Automation → Artwork
New page. Both artwork folders live here, together, because apart they are indistinguishable by name and three other screens used to send people to the wrong one.
Setting
What it does
Local assets folder
Finished artwork on disk, one folder per title: `movies\
shows/Title (Year)/poster.png, Season01.png, background.png, logo.png. New title folders are named the arr's way: the folder Sonarr/Radarr actually made; failing that, the arr's folder format applied to the title; failing that, Title (Year)`. A folder from before that changed can be brought into line with Asset folder names (Activity → Tasks → Maintenance). Your files beat anything Kustos generates, and Kustos writes its own posters here so you can swap them. Several features stay unavailable until this is set — replacing a network logo, saving template art from a fallback, dropping artwork in by hand.
Asset folder
Ingredients, not finished art: logo, network, background, template, texture. Anything dropped in is ingested and offered in Poster Studio. Defaults to a hidden folder under %ProgramData%, which is a poor home for folders you are meant to drag images into.
Auto-art upkeep
Pruning and auto-removal for artwork Kustos manages: enrollment, no-file titles, and what gets tidied.
Automation → Suggestions
Setting
What it does
Filters
Language, original language, year, rating, votes, genre — what may be suggested at all.
Per person
Who gets suggestions, from which service, and where they are sent.
Automation → Notifications
Setting
What it does
Telegram
Bot token and chat. Kustos sends; it does not read.
Discord / webhook
A URL Kustos posts to.
Which events
Shared by both: what is worth telling you about.
Maintenance → Upkeep
Setting
What it does
Cleanup safety limits
The blast radius. A cap on how much one run may delete, as a count or a percentage. A rule that would exceed its own cap queues everything and deletes up to the cap per pass, deferring the rest and warning you. The across-all-rules total works the same way: one pass deletes up to it, and the rest stay in Leaving Soon for the next pass.
Applications
Page
What it holds
Seerr
What happens when Kustos adds something because somebody asked: instance, quality profile, root folder, requester tag.
Sonarr / Radarr instances
Everything per instance — new-media defaults, media management, indexers, quality profiles, custom formats with TRaSH sync, import lists, auto tagging, naming, root folders, tier.
Maintenance
Page
What it holds
Updates
Kustos's own version and update check, then one section per connected app. Auto-update, and Uninstall.
Import Assets
One-time import of an existing Kometa assets folder. Different from the Local assets folder, which is live and ongoing.
Backups
Snapshots of the database: take one now, see what you have, set how many are kept. Restoring is a manual procedure — see Backup and restore.
Credits
Attribution the services require. Nothing to set.
Not in Settings, and deliberately
Some things belong to the screen that uses them, and Settings would be the wrong home. Each is documented with its screen rather than here.
Where
What
Automate Artwork
Which sources auto-scrape uses and in what order; auto-create enrollment; the ThePosterDB and MediUX panels.
