Khānesh

Khānesh (خوانش, “reading”) is our free reader for learning by reading. Open a text in any of our languages, tap the words you don’t know, and review them as flashcards. It runs in your browser and saves your data locally, no account needed.

What it does

  • Read with help. Words you haven’t met yet are underlined. Tap one to write its meaning, open a dictionary, or save it.
  • Flashcards that come back at the right time. Each word you save becomes two flashcards: word to meaning, and meaning to word. Reviews are spaced with FSRS, the method Anki uses, so each card returns just before you would forget it. Spaced repetition builds on research by the German psychologist Hermann Ebbinghaus on how we forget, and helps material stick in your memory more efficiently through active recall.
  • Progress you can see. Words you’re learning are shaded, and the shade fades as you learn them.
  • Meanings under words. Turn on Meanings under words in the reading options to see a short meaning under each word, like an interlinear edition: yours first, then other learners’, then, if you choose, Gemini’s.
  • Meanings from other learners. When you tap a word, you see the meanings other learners have shared for it, with any dialect, Persian equivalent and source they added.
  • AI help if you want it. AI isn’t used by default. You can add a free Gemini key to get suggested word meanings and sentence translations.
  • Words from our courses. Under the word tables in our courses, press Add these entries to Khānesh, tick the ones you want (anything you already have starts unticked), and mark each one Learning or Known. Learning words become flashcards, each with its meaning and transliteration.
  • Scanned books into text. Train a free reading model to turn scans in your language into text you can read here.
  • Anki when you want it. Send your cards to Anki with their schedules and review history.
  • With or without an account. Without one, your texts and words stay in your browser. Sign in, and they’re saved to your account so you can read on any device. You can also share texts, word lists, and OCR models trained to recognize text in your language.

Start reading

  1. Open the reader. On a phone, you can add it to your home screen so it opens like an app.
  2. Choose your language from the menu at the top. Persian and every language on our roster are ready to use. To add another, or to set up your own, tap Add a language.
  3. In the Library, import a text. It can be a text file (.txt or .md), a web page (.html), subtitles (.srt or .vtt) or a PDF that has text inside it. You can also paste a text, or start with the sample.
  4. Tap a word you don’t know. Write its meaning, using the dictionary links in the panel if you like, then tap Add flashcards.
  5. Turn the page when you’re done. Underlined words you didn’t tap count as known. You can undo that, or switch it off in Options.
  6. Open Review once a day. Show the answer, then grade yourself with the options: Again, Hard, Good or Easy.

What you import is private: nobody else sees it unless you share it.

Where your words are saved

Without an account, everything you read and save is stored in the browser you use the reader in, locally.

  • Back up now and then. In Options, tap Back up everything to save a file with all your texts and words. The reader reminds you when it’s been a while.
  • Moving to another device? Open the reader there, go to Options and choose Restore from a backup file. Recordings aren’t in backups, so choose those files again after you restore.
  • Browsers can clear saved data. Safari, for example, can delete a site’s data if you haven’t visited it for a while. Adding the reader to your home screen helps, and a recent backup means nothing is lost.
  • Private windows forget everything when you close them.

With an account, your texts, words and flashcards are also saved to your account, where only you can see them. Sign in on another device and they’re there too. The first time you sign in, what’s already in your browser is added to your account. Recordings stay on the device where you added them, and backups still work if you want a file of your own. Each account holds up to 50 MB, which is room for about 40 full books. If yours fills up, new texts stay in your browser, marked “on this device only”, while your words and flashcards keep syncing. Options shows how much you’re using; deleting texts you’ve finished makes room.

AI help

The reader can ask Google’s Gemini to suggest what a word means in its sentence, translate a sentence, or type out the text of a scanned page or photo. To use it, you need a key from Google. This is free with any Google account and takes about a minute to get.

Getting a key

  1. Open Google AI Studio’s key page and sign in with your Google account.
  2. Tap Create API key. If you don’t see it, look for the key icon in the menu at the bottom left, or for Get API key.
  3. If Google asks which project the key is for, choose any project, or let it create a new one. A project is just a folder for keys; you don’t need to set anything up in it.
  4. Copy the key. It’s a long code that starts with AQ.
  5. Open the reader, go to Options › AI help, paste the key and tap Turn on.

The Ask Gemini button now appears when you tap a word. You can also translate a sentence from the word panel, or choose Transcribe with Gemini when you import a scanned PDF or a photo of a page.

Note: the free tier allows a set number of requests a day, and resets overnight. If the reader says Gemini is busy or you’ve reached a limit, wait a minute or come back the next day. On the free tier, Google may use what you send to improve its products, so don’t send anything private.

Accounts and sharing

If you choose to make an account, your reading progress will transfer across devices, and you can share texts, word lists and OCR models, choosing who can open each one:

  • Only me: private, for your own use on any device.
  • Anyone with the link: unlisted. It isn’t listed anywhere, but anyone you send the link to can open it.
  • Everyone: public. It opens by link straight away, and joins the Shared library once someone on our team has checked it. Only share what you have the right to share.

To sign in, open Options › Account and choose Sign in with Google. To share, use Share in a text’s menu in the Library, Share a word list in Words, or Share an OCR model on your account page. We check the copyright status of anything shared publicly before approving it. Anything you share with everyone may also be used by Zabanestan to create learning materials, such as lessons, word lists and dictionaries, following the license you chose and crediting you and the source.

What we keep. Only our admins can see your Google email address and, if you choose one, your display name. Members who don’t choose a display name appear as “A Zabanestan member”. You can delete your account at any time, along with everything in it, from your account page. The local copy in your browser stays until you clear it.

Shared meanings

When you write a word’s meaning, you can share it with other learners. Shared meanings appear as suggestions when anyone taps the same word, with the number of people who gave each one. Tap Use this to take one.

  • Sharing is off until you switch it on. Sign in, then switch on Share this meaning with other learners in a word’s panel. To share every meaning you save from then on, use Options › Account.
  • Add what you know. Under Root, dialect, Persian and notes you can add the dialect or place the word comes from, its Persian equivalent, and where the meaning comes from, such as a dictionary or a speaker. These are shared with the meaning.
  • How shared meanings are used. They’re shown without your name. By sharing, you agree that Zabanestan may use them in its learning materials, such as dictionaries, under the CC BY-SA 4.0 license.
  • Vote on suggestions. Once you’re signed in, tap ▲ under a suggestion you agree with, or ▼ if it’s not right. Votes only change the order, so the meanings most people agree on come first. Tap your vote again to take it back.
  • Abusive or spam? Tap Report under it, and our team will take a look.

Flashcards and Anki

You get 20 new cards a day by default. In Options you can change that number.

To move your cards into Anki:

  1. Open Words and tap Export to Anki.
  2. Keep Anki package selected. It carries each card’s schedule and review history.
  3. Tap Save file, then open the .apkg file in Anki: File › Import on a computer, or open it in AnkiMobile or AnkiDroid.

Recordings and recitations

The reader can play an audio or video file beside its text, highlighting each line as it’s spoken. Tap a line to jump to it, repeat it, or slow it down.

In the Library, tap Audio or video, then choose the recording and its timing file: subtitles (.srt or .vtt), lyrics (.lrc) or a file from the helper script. Recordings stay on your device.

YouTube videos

To read along with a YouTube video, tap Audio or video, paste the video’s link, and choose a subtitle file for it (.srt or .vtt). The video plays in the reader, highlighting each line as it’s spoken.

Where to find subtitle files:

  • The video’s maker. Many channels share their subtitles if you ask.
  • Your own transcription. Free subtitle editors such as Subtitle Edit or Aegisub save .srt files.
  • Subtitle generators like TurboScribe.

Some videos can only be watched on YouTube. For those, the reader shows a link to the video.

Ganjoor recitations

The helper script can fetch a Ganjoor poem with a recitation, timed verse by verse. Add --list to see a poem’s recitations and -r 2 to choose another. It needs pip install requests.

python khanesh_tools.py ganjoor https://ganjoor.net/hafez/ghazal/sh1

Languages and dictionaries

The reader handles text written right to left or left to right, in Arabic, Cyrillic, Latin and Devanagari script. For each language it knows which spellings to treat as the same word, such as ي and ی, or ك and ک, and it can ignore optional vowel marks and stress accents.

  • Our roster languages and Standard Persian are ready to use. Add a language offers more Iranian and Indo-Aryan languages as well.
  • Your own language. Set its name, code, writing direction and the letters to treat as the same.
  • Dictionaries. The word panel links to dictionaries for each language: Vajehyab, Abadis and Steingass for Persian, and Wiktionary and Glosbe for many of our languages.

Questions and source code

Found a problem, or have an idea? Contact us, or tell us on Discord.

Like all our software, the reader is open source under the MIT License. Its fonts and libraries have their own open licenses.