> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rekosk.dev/recircles/llms.txt
> Use this file to discover all available pages before exploring further.

# Build a Places menu

> Create a two-item radial menu, test it by name, and pin it to the main ring. Use the same file to update your menu or share it with another user.

A ReCircles menu gives each command a label and a place on the ring. This Places menu uses `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.

```json places.json theme={null}
{
  "title": "Places",
  "items": [
    {
      "label": "Home folder",
      "icon": "user-home",
      "left_click": "xdg-open \"$HOME\""
    },
    {
      "label": "Wikipedia",
      "icon": "web-browser",
      "left_click": "xdg-open https://www.wikipedia.org"
    }
  ]
}
```

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

```sh theme={null}
recircles add places ./places.json
recircles --run places
```

**3. Pin Places to the main ring**

Give the installed menu a GTK icon name. Run the launcher with no arguments and select **Places**.

```sh theme={null}
recircles add places --main-menu folder
recircles
```

## Edit the installed menu

ReCircles reads `places.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

Run `recircles 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](https://docs.rekosk.dev/recircles/menus/actions.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.