Skip to main content
This page explains the main ideas in Hamsa Media and how they connect, one short section each. Read it once after the quickstart, then follow the links when you need the detail.

Projects and members

A project is the shared space your team works in. Transcripts, text to speech history, voice overs, AI docs, web reader sites, custom voices, dictionaries, members and API keys all live in a project. Switch projects in the header and you see a different set. Projects are the same in Hamsa Media and Hamsa Agents: a project made in one app appears in the other, with the same members and roles. Each member is an Owner, Admin or User. See Projects and Team members. Some work in a project is personal. Other members don’t see it in their lists: Transcripts, AI docs, project voices and dictionaries are the project’s.

Jobs and statuses

Most things you start in Hamsa Media run as a job in the background: a transcript, a speech take, an AI doc, a voice over and its videos. You can start one, move on, and come back. The Activity tray in the header follows every job while it runs, and Recent work on Home shows the newest ones.
The Activity tray: a transcript In progress under Running, and recent jobs marked Completed or Failed with a Try again buttonThe Activity tray: a transcript In progress under Running, and recent jobs marked Completed or Failed with a Try again button
Voice overs use their own words: Generating, Ready (prompt options waiting for you to pick one), Generating video and Failed. Text to speech keeps only finished takes; a generation that fails leaves nothing in History. A failed transcript, speech take or voice over video can run again with Try again in the Activity tray, and a transcript from its row menu too. A failed AI doc or voice over is made again from its own page. See Run a failed job again.

Credits

Every service is paid for in credits. Credits, the plan and the balance belong to the project Owner’s account, not to a project: every project that Owner has, in Hamsa Media and Hamsa Agents, spends from the same balance. Playing, comparing, exporting and downloading cost nothing. Failed jobs aren’t charged.
  • They last twelve months. Every batch of credits, from your plan, a top-up or your sign-up gift, can be used for twelve months from the day it arrives. The batch that expires soonest is spent first.
  • You need a balance above zero to start. With none, a new job is refused and the Insufficient credits dialog offers to upgrade or buy credits. A job that has started finishes, so a long one can take the balance below zero.
  • Your plan can cap use. Some plans limit how many transcriptions you start a month and how many speech takes you make a day, and the web reader needs Pro or higher.
The Your credits dialog: each batch of credits with what is left and its expiry date, and how credits workThe Your credits dialog: each batch of credits with what is left and its expiry date, and how credits work
See Billing for plans, top-ups and the credits meter.

Voices

A voice reads your text in text to speech, voice overs and the web reader. Each voice speaks one language, and each Arabic voice speaks one dialect. A project voice is cloned from 3 to 20 seconds of clear speech. Owners and Admins add and delete them by default.
The Project voices tab of the Voices library, with voices added in this project marked Custom voiceThe Project voices tab of the Voices library, with voices added in this project marked Custom voice

Dictionaries

A pronunciation dictionary is a list of words (the source) and how each should be said (the correction). Before a script is read, Hamsa swaps each source for its correction; your text stays as you wrote it.
  • Dictionaries belong to the project, and the same dictionaries work in Hamsa Agents.
  • You turn them on per script in text to speech (up to 10), set them in project defaults, give them to a web reader site, or turn them on for an agent.
  • Add pronunciation on a word in a transcript or a script saves an entry without leaving the page.
  • Voice overs don’t use dictionaries.
A pronunciation dictionary open, each source word beside the correction that is read insteadA pronunciation dictionary open, each source word beside the correction that is read instead
See Dictionaries.

Languages and dialects

Arabic dialects include Saudi Arabia, Arabic (Gulf), UAE, Kuwait, Qatar, Bahrain, Oman, Iraq, Jordan, Palestine, Syria, Lebanon, Egypt and MSA (Modern Standard Arabic). Arabic text reads right to left in transcripts, documents and exports. The app itself is in English or العربية; switch in the account menu.

Permissions

Roles and permissions belong to the project, so they are the same in both apps. The services themselves have no permission switches: every member can always use them. The Owner can turn single permissions on or off for one member, for example Create on Voices to let a User add voices and dictionaries. Hamsa Media shows every button to every member: when you lack a permission, the action is refused with a message rather than hidden. See Roles and permissions. API keys have their own scopes, separate from member permissions. See API keys.

Quickstart

Transcribe a file, then turn it into speech.

Limits

Every number you can run into.

Troubleshooting

Common problems and how to fix them.

Billing

Plans, credits and how they expire.