kewstaterc5

Usage

Overview

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 Visualizer 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.