Getting started
Operational guide · works offline
There are three ways to use Kalam, and most people only need one of them. Open the one that matches your situation — the steps unfold.
Choose your path
Which way will this person use it?
There’s nothing to install to try Kalam and no account to create. Everything below is about getting from “it opens” to “it’s ready at the bedside.”
Use with touchThe person can reliably tap the screen.
- Open the board
You land on the Home screen: a message bar across the top, and six areas of tiles below it.
- Build a message
Each tile adds its word to the bar at the top. The bar is the message — real communication even before you press SPEAK, and the completed message stays visible whether or not it is ever spoken.
A few urgent tiles (like YES, NO, STOP) also speak the moment you tap them, and still add themselves to the bar.
- Spell a word
For a word that isn’t a tile, tap ABC. Choose a letter group, then letters. Suggestions appear as you go — tap one, or tap ADD to add the word. Tap HOME to return; your message is kept.
- Enter a number
Tap 123 for digits, units and time. Build the number, tap ADD, then HOME.
- Speak the message
Tap SPEAK to say the whole bar aloud. Speaking doesn’t erase it — the message stays so you can add to it.
- Correct a mistake
DELETE removes the last word. UNDO reverses your last change. CLEAR empties the message.
Use with one switchThey press a single button instead of tapping.
- Connect the switch
A keyboard needs no setup — SPACE and ENTER are the select button.
To use a Bluetooth remote or adaptive switch: pair it in the tablet’s Bluetooth settings. Kalam does not pair devices itself. Once connected, most remotes behave like a keyboard — Kalam recognises Space, Enter, and the number keys 1–3. If none of its buttons work, use “Set up switch” in the gear menu.
Space and Enter always work as a fallback.
- Start scanning
Just press the switch. The first press after opening the board starts the scan automatically — there’s no “start scanning” button to find.
- See how scanning works
A highlight ring moves in two steps: first area by area — press on the area you want, and the highlight then moves tile by tile inside it. Press again on the tile to select it. After a selection the highlight returns to the start, so the next choice is predictable.
- Choose the speed
Open the gear menu and pick slow, medium, or fast. This is the setting you’ll reach for most, so it’s right there in the quick menu.
- Test with the person
Have the person make a few real selections before you rely on it. Overshooting? Slow it down. One press being counted twice, or a twitchy switch? See “Other scan settings” below.
- Stop scanning
Stop any time from the play/pause control in the sidebar, or press ESC on a keyboard.
Other scan settings — gear menu → “Other scan settings”
- Double-click filter — ignore an accidental second press right after the first. Turn it up if one deliberate press keeps being counted twice.
- Zone pause — a short extra pause when the highlight first enters a new area. Lengthen it if the person needs a moment to orient.
- Scan sound — a soft click on each step. On by default; works offline.
These three are independent of the slow/medium/fast setting — changing the speed won’t undo them.
| Speed | Area step | Tile step | Zone pause |
|---|---|---|---|
| Slow | 2800 ms | 2400 ms | 1600 ms |
| Medium | 2200 ms | 1800 ms | 1000 ms |
| Fast | 1800 ms | 1500 ms | 600 ms |
Set up for someoneYou’re the caregiver preparing the board.
- Open Caregiver Settings
Tap the gear button, then “Open caregiver editor.” Two deliberate taps — that’s the only protection, so the patient can’t wander in, but you’re never locked out.
- Customise the vocabulary
On the Board tab, tap any editable tile. Change its label (shown, up to 20 characters) and its spoken output (said, up to 60). Layout, positions, and action buttons are fixed on purpose — you change what a button says, never where it is.
- Add names and phrases
Put real names on the people tiles, and the person’s own frequent phrases where the defaults don’t fit. Save each tile — a brief “Saved” confirms it. Leaving with unsaved changes asks before discarding.
- Set the start screen and size
On the Settings tab: choose which screen Kalam opens on (Home, Spell, or Numbers), and drag the Label size slider until words look right, using the live preview.
- Add saved words
On the Saved words tab, add the person’s own vocabulary so it surfaces as suggestions on the Spell screen — real accelerators for the words they actually use.
- Test the phrases
Before handing over, tap through the urgent and daily tiles and press SPEAK. Confirm each says the right thing. If a tile is silent, see Troubleshooting.
- Export a backup
After customising the board, go to Settings → Backup → Export. You get a kalam-backup file holding all your customisation. Because Kalam does not keep a cloud copy, save it somewhere separate from the tablet.
- Install the app
Accept the install prompt (on iPad: Share → Add to Home Screen). Then launch it once from the home-screen icon so it caches everything — from then on it opens full-screen and works offline.
- Test it offline
With Kalam installed and opened online once, turn on airplane mode and open it again. Home, Spell, Numbers, your saved message, and all settings should load. Then press SPEAK to check the voice offline too — on some devices the voice needs installing for offline use (see “The voice disappears offline”). If speech doesn’t work offline, the completed message still shows in the message bar.
- Restore a backup
On a new device, open Kalam → Settings → Backup → Import → choose your backup file. Kalam shows a summary first (customised tiles, saved words, language) and only replaces the setup after you confirm. Then install and test offline on the new device.
This guide is always inside the app too — open the gear menu and choose “How to use Kalam”, or find it in Caregiver Settings, under “About & info”.