Skip to main content
Kalam Documentation

Dictation profiles

Open Dictation in the sidebar to customize how Kalam hears your voice and formats your text across different apps. Set a default profile for everyday typing, tune per-profile rules in the pipeline editor, and configure global toggles under While dictating.

For how shared engines and Sense safeguards work under the hood, see Models and Sense and Dictation profiles & Sense.

Dictation screen showing the hotkeys line, New profile button, Plain dictation default, and profile cards. (Click to zoom)

Screen layout​

SectionWhat it controls
Header & Sense barDisplays your dictation hold and Cycle modes shortcuts plus live Sense chips (Clean take, Polish check, Smart profile routing). Click a Sense chip to jump to Models and Sense.
Plain dictationYour baseline profile above the custom cards—transcribes speech as spoken with no AI rewrite or screen context.
Profile cardsBuilt-in (Email, Coding, Notes, Chat) and custom profiles. Badges show Default, AI polish, Context, Auto-switch, or health warnings if a provider needs setup.
Restore bannerAppears if any built-in profile was deleted so you can bring them back with Restore all.

Profile editor​

Click any profile card to open its pipeline editor:

Profile editor showing the dictation pipeline rail (You speak, Hear your voice, Read your surroundings, Improve the text) and Auto-activate rules. (Click to zoom)
  1. Identity: Profile name, icon or app logo, accent color, Set as default, and Delete (custom or removable profiles).
  2. Hear your voice: Inherit the shared speech engine from Models and Sense or pick an explicit On-device or Cloud engine and recognition languages for this profile.
  3. Read your surroundings (Pro): Optionally attach active window context (Off, Window title, Focused field, or Extended), Clipboard, Selected text, or Date and time.
  4. Improve the text (Pro): Toggle Improve with AI, pick a language model, and edit writing instructions. Built-in profiles provide Reset to default if you want to revert custom prompt edits.
  5. Auto-activate: Click Add Rule to match open windows, installed apps, or browser websites so Kalam switches to this profile automatically when that target is focused.
Sensitive apps override

When Sensitive apps matches a password manager or protected window, Kalam automatically routes transcription to an On-device engine and skips Read surroundings, Commands, and clipboard fallback. If Improve is turned on for the active profile, AI polish still runs on the raw spoken transcript without screen context; use Plain dictation (or switch Improve off) if you want zero cloud polish in sensitive windows.

While dictating​

The While dictating panel below your profiles applies globally across every profile:

While dictating toggles showing Pause music and video, Voice commands, and Quiet other apps. (Click to zoom)
ControlBehavior
Pause music and video (Pro)Pauses active media playback (Spotify, Apple Music, or browser media) while you dictate and resumes afterward.
Voice commandsEnables inline punctuation and editing words (period, new line, scratch that) when Improve is off. See Voice commands reference.
Quiet other apps (Pro, Windows & Linux)Lowers system audio volume of other apps during dictation instead of pausing media.

For spoken tools like Ask Kalam, web search, and New note…, open Commands in the sidebar.

Common tasks​

Create or duplicate a profile​

  1. Open Dictation.
  2. Click New (or click the duplicate icon on an existing profile card).
  3. Set the name and icon under Identity, adjust Hear your voice, Read your surroundings, and Improve the text, and optionally add Auto-activate rules.

Set your default profile​

  1. Open the profile you want to use whenever no app-specific rule matches.
  2. Click Set as default.

Add an auto-activate rule​

  1. Open a profile and scroll to Auto-activate.
  2. Click Add Rule.
  3. Pick an open window, installed app, or browser hostname, then confirm. If another profile already claims the same target, the editor flags which rule takes precedence.

Plan gates​

CapabilityFreePro / Pro trialMax
Use Plain dictation and built-in profilesYesYesYes
Create or duplicate custom profilesNoYesYes
Edit Auto-activate rulesYesYesYes
Read your surroundings & Improve the textLocked (Pro)YesYes
Pause music and video & Quiet other appsLocked (Pro)YesYes
Voice commands (when Improve is off)YesYesYes