Web reader is in beta and switched on for selected accounts.


Before you start
- Your account must be on a Pro, Business or Enterprise plan. On a lower plan, the Web reader page shows what the web reader does and offers an upgrade, which opens the Plans tab of Billing with only the plans that include it. If your account moves to a lower plan, sites you already set up stop converting articles.
- You need credits. Each reading is charged once, when it is first made. See Credits.
- Your articles must be public web pages. Hamsa fetches each page itself, so pages behind a login or a paywall can’t be read.
How it works
1
Add a site
In Web reader, click Add site and enter your domain and a voice. See Set up a site.
2
Choose readings and a look
On the site’s Settings tab, pick the readings you offer (English, Modern Standard Arabic, Arabic dialects), a voice for each, dictionaries and the player’s look. See Player appearance.
3
Add the snippet to your site
Copy the snippet from the Setup tab and paste it once into your article template. See Add the player to your site.
4
Readers press play
The first time anyone presses play on an article, Hamsa converts it. The audio streams to that reader while it is made, and every later reader gets the saved audio straight away.
How a reading reaches a page
A reading is one version of an article a reader can listen to: English, Modern Standard Arabic, or an Arabic dialect such as Egyptian or Saudi. Each site offers one or more readings, each with its own voice.- The snippet loads the player on the article. Nothing is converted yet.
- A reader presses play. The player sends Hamsa the page address and the reading.
- Hamsa checks that the site is active, that the page is on your domain (or one of its subdomains), and that you offer that reading.
- If the reading already exists, it plays at once. If not, Hamsa fetches the page, takes out the article text, translates it when the reading needs it, applies your pronunciation dictionaries, and speaks it.
- The audio is kept. The page is not read again until you clear the cached audio for that article.
?utm_source= and other tracking parameters don’t create a second conversion.
Translation
Hamsa decides the article’s language from its script: mostly Arabic letters means Modern Standard Arabic, otherwise English. A reading in the same language plays the text as written. Any other reading is translated first: an Arabic article offered in Egyptian is rewritten in Egyptian, and an English article offered in Arabic is translated into Arabic.Credits
Each reading of each article is charged once, when it is first made:- Speech: by the length of the audio produced, at the text to speech rate.
- Translation: for readings that need it, by how much text is translated.
Who can use it
Anyone in the project who can open Hamsa Media can add sites and change them. A site belongs to the member who added it: other members of the same project don’t see it in their list.Good to know
- Articles must have between 50 and 10,000 words. Pages over 5 MB, with more than 5 redirects, or on a private network address are refused, and the player says why.
- Each site can start up to 100 new conversions an hour, and each visitor up to 100 an hour. Plays of existing audio don’t count.
- Hamsa never re-reads a page on its own. After you change an article, clear its cached audio so the next play uses the new text.
- The player always shows “Voiced by Hamsa”.
Related
Set up a site
Add your domain and voice, then follow the Getting this live checklist.
Add the player to your site
The snippet, inline or floating, and per-page overrides.
Conversions and chunks
Check each article, fix a chunk, read the cost.
Analytics
Plays, completion and devices.