KEWSTATERC(5)

📦
version 4.4.2 · 2 versions
, in arch rolling

💖 KEWSTATERC(5) — File Formats Manual vibes 💖

okay bestie, welcome to the KEWSTATERC(5) page from the File Formats Manual. This is the whole lore, and yes, it’s giving “runtime state but make it cute” ✨

✨ NAME ✨

kewstaterc — the 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 you interact with the app — like toggling notifications or adjusting the volume, no cap. It uses the same INI-style syntax as kewrc(5): named sections in square brackets, each containing key=value pairs. Slay.

Unlike kewrc(5), which you’re 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. Periodt.

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

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

⭐ SEE ALSO ⭐

kew(1), kewrc(5)

big kew energy: source/version is kew, stamped 2026-09-24, and this page is literally KEWSTATERC(5) 💖✨🎀

📦 where this page comes from