xdg-open to open your home folder in your file manager and a website in your default browser.
1
Save places.json
Choose a working folder outside the ReCircles configuration directory and save the following file there.
places.json
2
Register and try it
Run these commands from the folder containing the file. The first validates and copies the menu. The second opens it directly. Select Home folder to open your file manager, or press Esc to close the menu.
3
Pin Places to the main ring
Give the installed menu a GTK icon name. Run the launcher with no arguments and select Places.
Edit the installed menu
ReCircles readsplaces.json from $XDG_CONFIG_HOME/recircles, usually ~/.config/recircles. Edit that copy, or edit the source file and run recircles add places ./places.json again. Reopen the menu to see your changes. Re-registering the file preserves its existing pin.
The menu ID is the name passed to add. The visible title can contain spaces. Choose a distinct ID such as places. The built-in names and their aliases, home, and recircles are reserved. A custom ID must be nonblank and cannot start with a dot or contain a path separator.
Import from Settings
Open Settings → Main Menu → Add Entry → Add Menu and choose a.json file or a .zip bundle. Settings installs and pins the menu, using the JSON filename to derive the ID. To distribute an icon with it, put places.json and places.png in the same ZIP. Matching the image stem to the menu ID lets ReCircles find the main-ring icon.
For icons on individual items, use a GTK theme name, an absolute path, or a path starting with ~/. A bare relative filename is looked up as an icon theme name.
Unpin the menu
Runrecircles remove places --main-menu to hide the main-ring entry. You can still open it with recircles --run places. To add a nested choice or ask for a value, continue to Submenus, lists, and input.
