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

# Browse and manage installed eikons in Herm Gallery

> Use Herm Gallery to preview installed eikons, activate one, create drafts, install packages, update entries, delete local eikons, and submit drafts.

Gallery is the local library for Herm eikons. It lists bundled eikons and eikons installed under the active Hermes home.

Open it with **Alt+5** and the **Gallery** sub-tab, or type `/gallery`.

## What the list shows

The list focuses on eikon names and active state. The details pane shows richer metadata for the selected entry, including author, local status, source availability, package identity, and trust/status labels when available.

The preview pane renders the selected eikon. If Herm cannot render a preview, it shows a fallback message instead of crashing the tab.

## Activate an eikon

Select a row and press `Enter`. Herm saves that eikon name as the active avatar and updates the sidebar.

## Create or install an eikon

Press the configured `list.new` key, usually `n`, to open the **New / Install** dialog.

You can:

* create a blank local eikon draft
* create a draft from local source media
* inspect and install a supported package source

Current source install flows are GitHub-package oriented. Use Marketplace for the default public catalog.

## Gallery actions

| Key     | Action                                              |
| ------- | --------------------------------------------------- |
| `Enter` | Activate the selected eikon                         |
| `n`     | Create or install an eikon                          |
| `e`     | Edit the selected eikon in Studio                   |
| `u`     | Update a non-bundled installed eikon                |
| `s`     | Submit a local draft to the configured catalog flow |
| `d`     | Delete a local non-bundled eikon                    |
| `/`     | Search the list                                     |

<Warning>
  Deleting an eikon removes local files. Bundled eikons cannot be deleted from Gallery.
</Warning>

## When to use Studio or Marketplace

Use **Studio** when you want to edit source media, tune rasterizer settings, or render state frames.

Use **Marketplace** when you want to browse the shared catalog, install a package, download source when the package provides it, or activate an already-installed catalog entry.

## Related docs

* [Eikon overview](/eikon/overview)
* [Studio](/eikon/studio)
* [Marketplace](/eikon/marketplace)