Install and first launch
It takes a few minutes to go from download to your first recorded class.
Download and install
- Open the download page and select “Download installer”. Only Windows is available at the moment.
- Run the installer and follow the prompts.
- If Windows shows “Windows protected your PC”, select “More info” and then “Run anyway”. The installer is not code-signed yet, so this prompt is expected.
kk checks for updates automatically and tells you when a new version is available. You can also check manually in Settings.
First launch
The first launch walks you through the following choices. You can change all of them later in the app.
- Choose how to use kk. With “kk Pass” you sign in with your email and can claim a trial allowance; “Custom API” needs your own provider keys. The two are compared in the overview. You can also choose “Later” and sign in from the account page or add keys in Settings afterwards.
- Choose a project folder. kk stores all class records as plain Markdown files in this folder. The default is Documents\kk. You can pick another location, or point kk at an existing Obsidian vault; see Using kk with Obsidian.
- Check your audio source. In Settings under “Audio”, choose a default source and select “Test”, then watch the level meter. kk warns you when the level is too low or the signal is clipping.
With a custom API, speech recognition and translation must both be configured before you can start translating. See Custom API.
Choose an audio source
| Source | When to use it |
|---|---|
| System sound | Online classes on Zoom, Teams and similar, where the sound plays on your computer. It captures the playback directly, is unaffected by room noise, and does not require speakers. |
| Microphone | In-person classes. Place the computer as close to the teacher as you can; in a large room, recognition gets harder the farther away you are. |
The small drop-down next to the record button switches the source at any time, and kk remembers your last choice. When capturing system sound, avoid also recording the same audio through a headset microphone.
Record your first class
- Click the record button or press Ctrl+Alt+K.
- Captions start scrolling: the original English on top and the translation below.
- Click stop (the same button or shortcut). The record is saved in your project folder, merged into that day's session for the same course, and post-class notes are generated.
Live features are covered in Live translation.
When you close the window
In Settings under “General” you can choose whether the close button quits kk or minimizes it to the tray. With the tray option, the app keeps running in the background and recording, the floating captions and global shortcuts continue. With quit, kk asks first while recording whether to keep going in the background or stop and exit.
Last updated: November 15, 2026