Skip to main content
ReCircles creates recircles.json with defaults on first launch. Run recircles --run settings to edit it visually. Settings changes apply live and save automatically. For hand edits, close the launcher, save the JSON, and reopen it.

Where files belong

The usual directory is ~/.config/recircles. When XDG_CONFIG_HOME is set to an absolute path, ReCircles uses its recircles subdirectory.

Main-ring entries

main_menu is an ordered array. The default order is files, apps, windows, wifi, bluetooth, settings. Every entry requires a name. Optional label and icon fields override the displayed title and icon. A custom menu’s label falls back to its title, then its ID. This example gives the ring three entries. Install Places first, then replace only the main_menu array in your configuration. The other built-in modes remain available through --run.
If a pinned custom menu file is missing, ReCircles removes its entry when reading the configuration. To restore the pin after reinstalling the file, run recircles add places --main-menu folder.

Appearance

Set these fields inside appearance. Omitted settings use the defaults below. For example, this keeps large menus circular and makes transitions immediate.
The other top-level objects control palette colors and keybindings.

Environment variables

The two reduced-effects switches check for the presence of the variable. Unset a switch to return control to your appearance and desktop settings.