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

# Navigate Hamsa Media: sidebar, header, Cmd+K and keys

> Find your way around Hamsa Media: the sidebar, every header icon, the Cmd+K command palette, keyboard shortcuts, examples of each service and sending feedback.

Hamsa Media has the same shell on every page: a sidebar with the services, and a header with your project, search and a few icons. This page explains each part, how to jump anywhere with Cmd+K (Ctrl+K on Windows), the keyboard shortcuts, the read-only examples, and how to send feedback.

![Hamsa Media on Speech to text: the sidebar with Home, Voices library, API keys and the services, and the header with the project switcher, the search field, Activity, Notifications, docs, feedback and the avatar](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/shell-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=f91849c9a359c43daf27c6d74a4a7a63)

## The sidebar

| Item | What it opens |
| - | - |
| The logo | The platform switcher: **Media Platform** ("Create content with AI") or **Agents Platform** ("Build AI agents"). Picking Agents opens Hamsa Agents in the same tab. |
| **Home** | [Home](https://docs.tryhamsa.com/media/workspace/home.md): quick starts, recent work, credits. |
| **Voices library** | [Voices](https://docs.tryhamsa.com/media/voices/voices-library.md) and [dictionaries](https://docs.tryhamsa.com/media/voices/dictionaries.md). |
| **API keys** | [API keys](https://docs.tryhamsa.com/overview/create-api-keys.md) for this project. |
| **Services** | **Speech to text**, **Text to speech**, **AI docs**, **Voice overs** and **Web reader**. |

![The platform switcher open under the logo, with Media Platform checked and Agents Platform below](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/platform-switcher-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=be3035f63889c452c9797e36110db616)

**Web reader** appears only where it is switched on for your account. See [Web reader](https://docs.tryhamsa.com/media/web-reader/overview.md).

To make room, collapse the sidebar to icons with the button at the start of the header, or press Cmd+B (Ctrl+B on Windows). On a phone or a narrow window, the sidebar opens as a drawer from the same button.

![Speech to text with the sidebar collapsed to icons](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/sidebar-collapsed-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=84281422ac31067c5b8f9c7a6597af5c)

## The header

From start to end:

![The end of the header: the Search or run a command field with its Cmd K keys, then the Activity, Notifications, docs and feedback icons and the avatar](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/header-icons-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=b6edb655f806663ef06e7c4413c3f44d)

| Part | What it does |
| - | - |
| Sidebar button | Shows or hides the sidebar. |
| Project switcher | Shows the project you're in. Open it to switch project, search your projects (when you have more than five), open **Project settings**, **Create project**, **Edit project**, **Rename label** or **Copy project ID**. See [Projects](https://docs.tryhamsa.com/overview/projects/managing-projects.md). |
| "Search or run a command" | Opens the [command palette](#the-command-palette). |
| **Activity** | Jobs running and finished in the last day, with retry. See [Activity](https://docs.tryhamsa.com/media/workspace/activity-and-notifications.md#the-activity-tray). |
| **Notifications** (bell) | Finished and failed transcripts and AI docs, credit and team notices. See [Notifications](https://docs.tryhamsa.com/media/workspace/activity-and-notifications.md#notifications). |
| Docs (book) | Opens the docs page for the screen you're on, in a new tab. |
| **Send feedback** (bug) | Point at part of the page and tell the team about it. See [Send feedback](#send-feedback). |
| Your avatar | Your name and email, your plan and credits, **Theme** (Light, Dark, System), **Language** (English, العربية), **Profile**, **Security**, **Notifications**, **Billing** and **Sign out**. |

![The project switcher open: your own project checked, two invited projects with their owners, then Project settings, Create project, Edit project and Copy project ID](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/project-switcher-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=2bfb08394da61fa1057f89f4ccc650ec)

![The account menu: name and email, the plan and credits left, Buy more credits, Manage plan, Theme and Language switches, Profile, Security, Notifications, Billing and Sign out](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/account-menu-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=614e62f86d35aa1d06cce7324ade56ef)

When you switch project, Hamsa Media leaves any page that shows one item of the old project, stops its uploads and closes its dialogs. If the page has unsaved changes, you're asked first.

### Links that open the right project

A link with `?projectId=` in it opens the page in that project, switching to it first. Notifications use this, so a notice about another project opens in that project.

A link can also open a page's create dialog. Add `?start=upload` to the Speech to text address, or `?start=clone` to the Voices library address, and the upload or add voice dialog opens when the page loads. For example, `https://media.tryhamsa.com/app/speech-to-text?start=upload` opens the upload dialog. The quick starts on [Home](https://docs.tryhamsa.com/media/workspace/home.md) work this way. If you can't create on that page, the page opens without the dialog.

## The command palette

To search or run a command, press Cmd+K on Mac or Ctrl+K on Windows, or click "Search or run a command" in the header. Type to filter, use the arrow keys to move, Enter to pick and Esc to close.

![The command palette with newsroom typed: Your content lists two transcripts and the Newsroom names dictionary](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/command-palette-search-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=f18a59e9d254fd9e80445ff859be8136)

With nothing typed, the palette shows:

| Group | What's in it |
| - | - |
| **Recent** | The last six commands you ran, kept in this browser. |
| The page's own commands | Actions for the page you're on, listed first. |
| **Go to** | Every page in the sidebar. |
| **Actions** | **Theme** (light, dark or system), **Language** (English or Arabic) and **Keyboard shortcuts**. |
| **Activity** | **Open activity**, and up to five **Running jobs** to jump to. |

![The command palette with nothing typed: Open activity, then Go to with every page in the sidebar](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/command-palette-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=42d66e67658e353a442f5dc2a795721b)

Some commands open a list of their own, such as **Theme**. Its name appears as a chip in the search field. Press Esc or Backspace (with the field empty) to step back.

![The command palette inside Theme: a Theme chip in the search field and Theme: light, dark and system](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/command-palette-theme-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=bb78cc36d450674a79cbe7507bd6a6cd)

### Find your content

Type two letters or more and the palette also searches **Your content** in the current project:

* Transcripts and AI docs, by title. Picking one opens it.
* Voices. Picking one opens Text to speech with that voice selected.
* Dictionaries. Picking one opens it.

Up to four of each kind are shown. Text to speech history and voice overs aren't searched.

Where the [web reader](https://docs.tryhamsa.com/media/web-reader/overview.md) is switched on, **Open site…** lists the project's sites by domain, each marked **Active** or **Inactive**. Type part of a domain and pick the site to open its page. On a site's page, the palette also offers **Switch tab**, **Copy embed code** and **Open conversion logs**; on the list of sites, **Add site**.

### Examples of what you can type

| Type | To |
| - | - |
| `newsroom` | Find transcripts, AI docs, voices and dictionaries with "newsroom" in the name. |
| `upload` (on Speech to text) | **Upload a file to transcribe**. `youtube` and `record` find **Transcribe a YouTube link** and **Record and transcribe**. |
| `export` (on a transcript) | **Export as SRT**, **Export as VTT**, **Export as DOCX** or **Export as text**. |
| `speed` (with something playing) | Pick a playback speed, such as **Speed: 1.5×**. |
| `dark` | **Theme: dark**. |
| `example` | Open an example of any service. |
| `api key` | Go to **API keys**. On that page, also **Create API key**. |

Words can come in any order; every word you type must match.

## Keyboard shortcuts

Press **?** anywhere (except while you type in a field) to open **Keyboard shortcuts**, or pick **Keyboard shortcuts** in Cmd+K. The sheet lists the keys that work in the app and on the page you're on.

![The Keyboard shortcuts sheet: General, Player, Transcript and Tables keys](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/keyboard-shortcuts-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=369fc1563f27b231af1099cd52d9d06c)

| Where | Mac | Windows | Does |
| - | - | - | - |
| Everywhere | Cmd+K | Ctrl+K | Search or run a command |
| Everywhere | ? | ? | Show keyboard shortcuts |
| Everywhere except while you type in a field | Cmd+B | Ctrl+B | Show or hide the sidebar. In the AI docs editor it makes text bold. |
| Player, while a track is loaded | Space or K | Space or K | Play or pause |
| Player | J / L | J / L | Back / forward 10 seconds |
| Player | ← / → | ← / → | Back / forward 5 seconds |
| Player | Shift+, / Shift+. | Shift+, / Shift+. | Slower / faster |
| Player | M | M | Mute or unmute |
| A transcript's page | Cmd+F | Ctrl+F | Find in the transcript |
| A transcript's page, in find | Enter / Shift+Enter | Enter / Shift+Enter | Next / previous match |
| A transcript's page, while playing | B | B | Back to playing |
| A transcript's page | D | D | Add pronunciation |
| A page with a table | F | F | Filter the table |
| Text to speech | Cmd+Enter | Ctrl+Enter | Generate speech |
| A web reader site | 1, 2, 3, 4 | 1, 2, 3, 4 | Go to Setup, Conversions, Analytics, Settings |

Single-letter keys don't fire while you type in a field, or while a dialog or menu is open. The transcript editor has more keys for moving between segments; see [Transcript editor](https://docs.tryhamsa.com/media/speech-to-text/transcript-editor.md).

> [!TIP]
>
> On an Arabic keyboard layout, the letter shortcuts still work by key position (K plays and pauses where it types ك), and **؟** opens the shortcuts sheet.

## See an example

Before you have made anything, you can look at a finished example of each service: a transcript, text to speech, an AI doc, and a voice over. Each is read-only, marked **Example**, and "Not saved, and not in your history." Examples have no audio. **Start your own** takes you to the real create flow.

You find them:

![An empty Speech to text list: No transcripts yet, with Upload a file and See an example](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/see-an-example-empty-list-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=b72bf4bf1dc4691cc50c5e7a3f72911b)

* On an empty list (Speech to text, Text to speech, AI docs) and in an empty Voice overs history: **See an example**.
* On [Home](https://docs.tryhamsa.com/media/workspace/home.md), under "Or see an example:" while you have no work.
* In Cmd+K: type `example` or a service's name, such as **See an example of a transcript**.

The example transcript is shown in the app's language, English or Arabic.

![The example transcript: a back button, the Example badge, the note that it is not saved, Start your own, and two speakers](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/example-transcript-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=4e713cb87116981975969a0c03e7c020)

## Send feedback

Use the bug icon in the header to tell the Hamsa team about a problem or an idea, pointing at the exact part of the page.

**1. Start**

Click **Send feedback** in the header. The first time, a card explains how to point; click **Start**, or **Whole page instead**.

![The first-time card: Point at what your feedback is about, with Whole page instead and Start](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/feedback-intro-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=e026083322463f774c62ff1fa7c14be0)

**2. Point at the part**

Move over the page: the part under your cursor is outlined. Click it. Press Esc to cancel, or click **Whole page** at the top.

![Picking a part of the Voices library: the Stories and audiobooks card is outlined, and a bar at the top reads Click the part of the page your feedback is about, with Whole page and Cancel](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/feedback-picking-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=b28afb68d0c3e3f95fe473aad06f0a1c)

**3. Write and send**

The form shows what you picked (**Pick again** to change it). Write **Your feedback**, keep or clear **Include a screenshot**, and click **Send feedback**. "Thanks, your feedback was sent." confirms it.

![The Send feedback form: the picked part with Pick again, Your feedback filled in, Include a screenshot switched on with its preview, and Send feedback](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/workspace/feedback-form-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=fffb10b77288fe6316cdaec48d147f20)

The screenshot shows the screen as you see it, with your private details blacked out: transcripts, the text you turn into speech, keys and anything typed in a field. The form shows the screenshot before you send it. Your name, email, the page you were on and your project go with the report.

## Good to know

* In Arabic the sidebar moves to the right and pages read right to left. Switch the language from your avatar or with **Language** in Cmd+K.
* Cmd+K lists only pages that are switched on for your account.

## Related

> [card] [Home](https://docs.tryhamsa.com/media/workspace/home.md)
>
> Quick starts, recent work and credits.

> [card] [Activity and notifications](https://docs.tryhamsa.com/media/workspace/activity-and-notifications.md)
>
> The tray, the bell and browser notifications.

> [card] [Lists and uploads](https://docs.tryhamsa.com/media/workspace/lists-and-uploads.md)
>
> Saved views, bulk actions, undo and the player.

> [card] [Account settings](https://docs.tryhamsa.com/overview/account-settings/overview.md)
>
> Profile, security and notification settings.


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