---
name: "kewstaterc"
section: "5"
platform: "linux"
package: "kew"
version: "4.4.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/kewstaterc"
---

# kewstaterc(5)

persisted runtime state file for kew

## 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)](/kew/1.md) 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)](/kewrc/5.md): named sections in square brackets, each containing *key*=*value* pairs.

Unlike [**kewrc**(5)](/kewrc/5.md), 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)](/kewrc/5.md), 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)](/kewrc/5.md).

  - 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)](/kewrc/5.md).

  - 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)](/kewrc/5.md). Empty selects the default theme.

## FILES

- *~/.config/kew/kewstaterc*

  State file on Linux, FreeBSD, and Android.

- *~/Library/Preferences/kew/kewstaterc*

  State file on macOS.

## SEE ALSO

[**kew**(1)](/kew/1.md), [**kewrc**(5)](/kewrc/5.md)