Skip to main content
Run recircles with no arguments to open the main ring. For a compositor shortcut that goes straight to one menu, bind the full command, such as recircles --run files.

Launch a menu

Built-in names

Built-in names and aliases are case-insensitive. For a custom menu, use the installed filename without .json, preserving its case.

Register and pin

<config.json> is a filesystem path. <icon> is required with add --main-menu and accepts a GTK icon name or an image path. You can also write --main-menu=<icon>. Quote paths that contain spaces.

Unpin or remove

Configuration and history

To check the supported environment variables or choose a different configuration directory, see Launcher configuration.