Settings

A complete reference to every setting on Kioku’s Settings page, grouped by its on-screen section.

Settings are buffered as you edit them and persist only when you select Save settings (or Save in the sticky Unsaved changes banner). Navigating away with unsaved changes prompts you to Discard first. Theme and Highlight colors apply to the screen immediately but still require Save to persist.

Note

This page documents savable settings only. The Settings page also hosts actions that are not stored settings: running FSRS optimization, importing Anki decks, exporting, browsing and restoring backups, managing Collections, configuring import domains, running media diagnostics, toggling usage analytics, and checking for updates. Those are described at the end under Actions on the Settings page.

Categories and optional features

Use General, Learning, Library & backups, Privacy, and About to find settings. Switching categories keeps unsaved changes; Save settings saves changes from every category, and Discard reverts them together. Actions such as backups and analytics still apply immediately.

Under General → Optional features, Enable Plan shows the Plan workspace, its command and shortcuts. It is off by default, including for existing collections without a saved preference. Select it and save to enable Plan for the current collection. Each collection remembers its own choice. Turning Plan off or resetting settings preserves schedules and history. Active schedules are not paused; their elapsed time continues, and timers resume when Plan is reopened.

Display

Setting	What it does	Default	Options / range
Theme	Previews the selected appearance immediately; Save to keep it for the current collection.	Kioku Dark	Kioku Dark, Kioku Light
Primary highlight color	Color used by highlight slot 1. Applied from the menu over a selection, or with M while reading and Cmd/Ctrl+Shift+H while writing.	Theme default	Any hex color, or Reset to return to the theme default
Secondary highlight color	Color used by highlight slot 2. Applied from the menu over a selection (no keyboard shortcut).	Theme default	Any hex color, or Reset to return to the theme default
Tertiary highlight color	Color used by highlight slot 3. Applied from the menu over a selection (no keyboard shortcut).	Theme default	Any hex color, or Reset to return to the theme default

Note

Older dark palettes now use Kioku Dark; Solarized Light uses Kioku Light. Saving settings stores the corresponding Kioku theme. Custom highlight colors are preserved; a highlight color left at its default follows the active theme.

Keyboard shortcuts

This section has no stored rows on the page. Select Show shortcuts (or press ?) to open the shortcut help, which is also the rebinding editor: click a shortcut chip and press a new combination to rebind it. Custom bindings are saved by that editor, independently of Save settings.

For the full list of bindings and how rebinding works, see Keyboard shortcuts and the Customize shortcuts guide.

Item scheduler

These settings control how Items (flashcards) are scheduled. See Spaced repetition for the model behind them and the Tune FSRS guide for how to adjust them.

Setting	What it does	Default	Range
Item review model	Read-only. The algorithm used to schedule Items. Not configurable.	FSRS	N/A
Desired retention	The target probability of recalling a Card when it is due. Higher values mean more frequent reviews.	0.90 (90%)	0.70–0.99, step 0.01

Note

Desired retention is stored separately from the other settings. Reset to defaults restores it to 0.90.

Audio

Setting	What it does	Default	Options
Play audio automatically	Plays a Card’s question audio when it appears and its answer audio when you reveal it. Turn it off to play audio only with A or the play buttons. See Cards with audio.	On	On, Off

Topic scheduler

Controls scheduling for Topics and Extracts. It does not affect Item Cards.

Setting	What it does	Default	Options
Scheduler version	Chooses how Topics are paced. The default adapts each Topic’s interval to how you read and act on it; an earlier mode is also available.	Adaptive (default)	Adaptive, Legacy

Queue

Controls how a review session mixes and limits content. See The review queue for how these interact.

Setting	What it does	Default	Range / options
Queue strategy	How Topics and Items are interleaved during a session. Pick a steady rhythm of Cards to Topics, follow your chosen topic share, or have Kioku draw all due content in priority order.	Fixed rhythm	Fixed rhythm, Topic share, Priority order
Topic ratio	Share of a session devoted to Topics and Extracts. Honored only under the Topic share strategy.	0.30 (30%)	0–0.5, step 0.05
New cards per session	Maximum new Cards introduced per session. Set to 0 for reviews only. Empty or invalid input becomes 0.	20	0–100
Review limit	Maximum Cards to review in a single session. Empty or invalid input becomes 10.	100	10–500

Note

Topic ratio is ignored by the Fixed rhythm and Priority order strategies. It applies only to Topic share.

Auto-postpone

Spreads low-priority overdue Topics across upcoming days instead of piling them into today’s pool.

Setting	What it does	Default	Range
Low-priority overdue topic daily cap	How many low-priority overdue Topics stay in today’s pool; the rest are spread across upcoming days.	40	1–500, integer
Protected threshold	Only Topics with priority above this threshold can be auto-postponed.	0.30 (30%)	0.1–0.9, step 0.1

Page footer

Action	What it does
Save settings	Persists the buffered changes from every section above, including Desired retention.
Reset to defaults	After confirmation, restores every setting on this page to its default and Desired retention to 0.90. This cannot be undone.

Actions on the Settings page

The sections below are management and maintenance panels, not stored settings with defaults. They are listed here for completeness; follow the linked guides for how to use them.

Section	Purpose	See
Item scheduler → Run optimization	Tunes a Collection-specific FSRS weight set to your review history and activates it only if it predicts your recall better than your current parameters. Includes Latest run and Run history (with Roll back). Availability depends on a minimum review count and no unsaved retention changes.	Tune FSRS
Import domains	Lists configured domains with their import mode and a Thread badge for live thread mode. Add or remove domains here.	Import a web page
Collections	Switch, Rename, Show in Finder, Export, Delete, Create, or Import a Collection.	Collections
Import & export	Export CSV (flashcards only), Export JSON (full database, no media), Export everything (.zip) (database plus media), and Import Anki (.apkg).	Back up and export, Import an Anki deck
Backups	Lists automatic snapshots with their time, size, and origin (Automatic, Before update, Before restore). Back up now takes one immediately, Show backups folder reveals them on disk, and Restore rolls the Collection back to a snapshot (saving the current state first).	Back up and export
Scheduling	Read-only summary of the active Collection’s scheduler configuration.	Spaced repetition
Media diagnostics	Run media diagnostics now cleans up unused media and checks that assets are servable, reporting any unservable assets.	Troubleshooting
Privacy → Usage analytics	A single opt-in toggle for pseudonymous usage analytics, off by default. Once it is on, an Exclude this device link appears alongside the device’s install ID. Applies immediately, and is not part of Save settings.	Privacy
About	Read-only app Version, Send feedback, and Check for updates.	N/A

Related

• Keyboard shortcuts: the full binding map.
• Glossary: definitions of Topic, Extract, Item, Card, and Collection.
• Where Kioku stores your data: on-disk locations for Collections and backups.