kewstaterc(5)

KEWSTATERC(5)

File Formats Manual

KEWSTATERC(5)

NAME

kewstaterc - persisted runtime state file for kew

SYNOPSIS

~/.config/kew/kewstaterc (Linux/FreeBSD/Android), ~/Library/Preferences/kew/kewstaterc (macOS)

DESCRIPTION

kewstaterc stores settings that kew(1) changes automatically at runtime as the user interacts with the application, such as toggling notifications or adjusting the volume. It uses the same INI-style syntax as kewrc(5): named sections in square brackets, each containing key=value pairs.

Unlike kewrc(5), which the user is expected to hand-edit, kew writes to kewstaterc itself whenever the corresponding in-app setting changes. Values in kewstaterc take precedence over the same-named keys in kewrc(5), so a setting changed from within kew will override its kewrc value on subsequent runs.

If kewstaterc is deleted, kew regenerates it with default values the next time it writes state.

MISCELLANEOUS SECTION

Settings in the [miscellaneous] section.

allowNotifications bool: Whether desktop notifications are enabled. Mirrors and overrides the kewrc setting of the same name. Default: 1.
alwaysCrossfade bool: Whether crossfade at the end of every song is enabled. Mirrors and overrides the kewrc setting of the same name. Default: 1.
lastVolume n: The volume level in effect when kew was last closed, on a scale of 0 to 100. Restored on the next launch if autoResume or equivalent volume-restore behavior applies. Default: 5.

TRACK COVER SECTION

Settings in the [track cover] section.

coverAnsi bool: Whether covers are rendered using ASCII/ANSI art mode. Mirrors and overrides the kewrc setting of the same name. Default: 0.

VISUALIZER SECTION

Settings in the [visualizer] section.

visualizerColortype int: The active visualizer color mode. Mirrors and overrides the visualizerColorType setting in kewrc(5).

0: lighten
1: flat
2: reversed lighten
3: party
4: vibrant
5: lum vibrant
6: binning
7: two color gradient
8: off

: Default: 3.

CHROMA SECTION

Settings in the [chroma] section.

chromaPreset n: Index of the last-selected Chroma preset. A value of -1 means no preset is selected. Default: -1.

COLORS SECTION

Settings in the [colors] section.

colorMode int: The active color palette source. Mirrors and overrides the colorMode setting in kewrc(5).

0: 16-bit color palette from the default theme
1: colors derived from the One Album Color theme
2: colors derived from the TrueColor theme
3: colors derived from the Album Colors theme
4: neutral, devoid of color

: Default: 3.

theme name: Name of the currently selected theme file, as found in ~/.config/kew/themes (Linux/FreeBSD/Android) or ~/Library/Preferences/kew/themes (macOS). Mirrors and overrides the theme setting in kewrc(5). Empty selects the default theme.

FILES

~/.config/kew/kewstaterc: State file on Linux, FreeBSD, and Android.
~/Library/Preferences/kew/kewstaterc: State file on macOS.