Documentation for Windows
Current for ahsk 1.27 on Windows. Hold a shortcut, speak, and your words are written wherever your cursor is, in any program. ahsk also answers questions by voice, translates as you speak, has Alan to do things for you and show you how, puts a small bubble on any text you select, opens a launcher on Win + Space, converts any file you drag, records meetings into notes, finds your files, cleans up your PC and keeps it awake with the lid closed.
New in 1.27
- • Convert any file. Start dragging a file, tap Shift, and drop it on a format in the ring that opens: photos, PDFs, Word, Excel, PowerPoint, video, audio and archives. The new file lands beside the original. See Convert.
New in 1.25 and 1.26
- • Alan writes where you are. “Write a comment on this post” or “reply to this saying I’ll be there”: he reads the window you are in and types it at your cursor. Nothing is ever sent.
- • Alan opens and closes apps (Store apps too) and tidies your Desktop, Downloads and Documents, asking first. Say “undo” to take back what he just did. See Alan.
- • A four-step tour on the pill for new installs: dictate, hands-free, Alan, the launcher.
- • Start a new take while the last one is still being written. And when ahsk cannot tell whether a paste landed, your words stay on the clipboard and a line by the pill says so.
- • ahsk starts with Windows, with a switch under Dashboard → Shortcuts → Startup.
- • Safer (1.26): no service keys live on your PC, and your plan is checked on our servers.
The four shortcuts
- • Hold Ctrl + Win to talk, release to paste.
- • Tap Ctrl + Win + Space to dictate hands-free; tap Ctrl + Win when you are done.
- • Tap Ctrl + Win + A to ask a question, or Ctrl + Win + T to translate what you say.
- • Hold Ctrl + Win + Alt for Alan: tell him what to do, or ask how, and he shows you on screen.
Installation
ahsk for Windows is a single installer. It installs for your user account only, so it never asks for an administrator password.
- 1. Download the installer from the homepage — the file is called
ahsk-windows-v<version>-setup.exe. - 2. Double-click it. If Windows shows “Windows protected your PC”, click More info, then Run anyway (see the note below).
- 3. Keep Start ahsk when I sign in to Windows ticked so the shortcut is always ready (you can change it later under Dashboard → Shortcuts → Startup). A desktop shortcut is optional.
- 4. Click Install. ahsk launches on its own when setup finishes.
About the SmartScreen warning
The Windows build is not yet code-signed, so SmartScreen shows a warning the first time you run the installer. It is the standard notice for any new, unsigned program. Click More info and then Run anyway. The download always comes from our GitHub releases page, so you can check the address before you run it.
Where it lives
ahsk installs to %LocalAppData%\Programs\ahsk and keeps its data in %LocalAppData%\ahsk. Uninstall from Settings → Apps like any other program; your history and settings are left behind in the data folder in case you reinstall.
Getting Started
The first launch signs you in and walks you through every shortcut with your own microphone.
1. Sign in
Use the same account as on Mac or iPhone — email and password, or Continue with Google. New to ahsk? Create your account at ahsk.app/signup first — since 1.12 the app signs you in but doesn’t create accounts, because your email is verified during signup. Your plan follows your account. ahsk keeps you signed in between restarts.
2. Setup walkthrough
A short interactive tour. Each step waits for you to actually do it, so you leave knowing the shortcuts by feel:
- • Test the keys — press Ctrl + Win and see ahsk notice.
- • Test your microphone — a live level meter confirms Windows is sending ahsk audio.
- • Send a message — hold Ctrl + Win, say a message, let go, and watch it land.
- • Write an email hands-free — tap Ctrl + Win + Space, dictate an email (correct yourself halfway, it keeps only what you meant), tap Ctrl + Win.
- • One bar for everything — open the real Win + Space launcher.
- • Meet Alan — what Ctrl + Win + Alt does (skippable).
- • Select text, get a bubble — the selection bubble and its actions.
- • Your style and your languages — the dictation mode, the language you speak, the one ahsk writes in and the one Translate writes in.
You can replay it any time from the tray menu: Show onboarding again.
3. Find the pill and the tray icon
After setup ahsk has no main window. Two things tell you it is running: a small dark pill at the bottom of your screen that grows into a waveform while you speak, and the ahsk icon in the notification area next to the clock (click the ^ arrow if Windows has hidden it).
4. The tour on the pill
After the walkthrough, a blue dot ripples on the pill and a small card beside it has one thing to try, four in all: hold Ctrl + Win and say something, tap Ctrl + Win + Space for hands-free, hold Ctrl + Win + Alt and ask Alan, press Win + Space to find anything. It moves on when ahsk sees you do each one — there is no Next button — with a green tick in between, and the card coaches you while you are mid-gesture. A step stays until you have done it once, even across restarts. If your first dictation lands on the clipboard instead of a text box, the tick comes with how to paste it.
Free plan
New accounts get 10,000 dictated words free, plus 20 translations, 20 web searches, 20 AI answers and 10 video downloads — then Pro. See Plan.
Dictation
Dictation works in every program that accepts typed text: browsers, Word, Outlook, Slack, Teams, VS Code, Notepad, the Windows search box. Put your cursor where you want the text, then use either mode.
| Mode | Shortcut | How it works |
|---|---|---|
| Push-to-talk | Hold Ctrl + Win | Hold both keys, speak, release. Your text is pasted at the cursor. |
| Hands-free | Tap Ctrl + Win + Space | ahsk keeps listening after you let go. Tap Ctrl + Win (or the same chord again) to stop and paste. |
Push-to-talk
Press Ctrl first, then Win, and keep both held while you talk. The pill turns into a live waveform so you can see you are being heard. Release when you finish the thought — transcription takes well under a second and the text lands where your cursor was.
Why Ctrl first
Pressing Win on its own opens the Start menu. ahsk only claims the Win key while Ctrl is already down, which is what keeps the Start menu closed. If Start pops up, you pressed Win before Ctrl.
Hands-free
For anything longer than a sentence or two. Tap Ctrl + Win + Space once and let go: a soft blue glow around the edge of every monitor shows ahsk is listening. Speak as long as you like, pause, think, keep going. Tap Ctrl + Win to stop — everything you said is transcribed and pasted as one piece.
- • A hands-free session stops on its own after 5 minutes and pastes what it heard, so a forgotten session never runs all afternoon.
- • If you want to watch your words as you talk, turn on Dashboard → Voice → Live transcript: a card beside the pill writes them as you speak. It is off by default since 1.25.1, because the live words are a rough first draft; what gets pasted always comes from the full transcription.
- • Press Esc to throw a hands-free take away without pasting anything.
- • A coach mark appears if you keep holding Ctrl + Win for a long time — a reminder that hands-free exists.
- • You can start the next dictation while the last one is still being written; the new one is not interrupted.
Sounds
Short cues, the same ones as the Mac app, tell you what happened without looking at the screen (and a soft chime when a video download finishes):
- • Start — ahsk is listening.
- • Paste — your text was pasted (or your answer is on screen).
- • Error — something did not work; a message under the pill says what.
Turn them off under Dashboard → Voice → Preferences → Mute sounds.
“We couldn’t hear you”
When a recording contains no speech, a dark card appears by the pill. It says why from what the mic actually delivered — nothing at all, exact silence (muted), or nothing loud enough — and has a play button with the take’s waveform so you can hear what was captured. Check Microphone takes you straight to Voice → Input. The card closes itself after ten seconds.
Nudges
One line by the pill for the moments people trip up:
- • You started dictating with nothing focused that can take text — Click a textbox, hold Ctrl + Win and say what you want ahsk to write. (At most three times.)
- • A hands-free session ran to its limit — Hands-free stays open until you tap Ctrl + Win again. (At most three times.)
- • Eight characters typed in a row — You could say this instead. This one keeps coming; turn it off under Dashboard → Shortcuts → Reminders.
Messages under the pill
ahsk never fails silently. When something else goes wrong a small dark tile appears just below the pill for a few seconds:
| Message | What it means |
|---|---|
| Hold Ctrl + Win to dictate | The keys were released in under a third of a second. Keep them held while you speak. |
| Can't reach your microphone | Windows would not open the mic — another app has it exclusively, or microphone access is off in Windows privacy settings. |
| No connection | The transcription server could not be reached. Your recording is kept: press Retry on the card once you are back online. |
| Almost — we couldn't paste that | Your words were transcribed but could not be pasted. They are on the clipboard: press Ctrl + V. |
| Copied to clipboard | The program did not take the paste. Your words are on the clipboard: press Ctrl + V where you want them. |
| Also on your clipboard | ahsk could not read the field to check the paste. If your words did not appear, press Ctrl + V. |
| Wrapped up your hands-free session | The 5-minute limit was reached; what you said so far was transcribed. |
Smart Formatting
Raw speech-to-text is not the same as written text. After transcribing, ahsk runs a quick cleanup pass on anything longer than a few words so what gets pasted reads like you typed it:
- • Punctuation and capitals — sentences, commas, question marks.
- • Fillers removed — “um”, “uh”, “you know”, repeated words.
- • Self-corrections — say “send it Tuesday, no, Thursday” and only Thursday survives.
- • Spoken symbols and code — “open paren”, “new line”, “camel case user name” become the real thing.
- • Lists and emails — “first… second… third” becomes a numbered list; a dictated email gets its greeting, body and sign-off on their own lines.
- • Fits the app you are in (since 1.23) — in Outlook, Gmail and other mail a dictation is laid out as an email; long updates get paragraphs; in VS Code, Cursor, JetBrains, Windows Terminal, PowerShell and Warp, spoken file names become
@filereferences (“login view dot swift” →@LoginView.swift) and “Git status” is typed asgit status. The pill shows the icon of the app your words are going to. - • Names on your screen (since 1.23) — when you start dictating, ahsk reads the names and terms in the window you are in and uses them as spelling hints, so the name of the person you are replying to comes out right without saving it.
- • Nothing you said is dropped — if the cleanup loses a sentence, ahsk pastes your words as you said them instead.
Dictations under 7 words are pasted exactly as heard — short phrases rarely need cleanup, and skipping it keeps them instant. If the formatter cannot be reached, ahsk pastes the raw transcript rather than making you wait.
Dictation Modes
The mode is the one setting that changes what every dictation looks like, so it lives on the Dashboard’s Home as well as under Voice. Each card previews the same sentence in that mode so they compare at a glance.
| Mode | What it does |
|---|---|
| Informal | Uses symbols — €, $, %, ms, km — and keeps the text casual and concise. |
| Formal | Writes units and symbols out in full words (euros, percent, milliseconds) with proper punctuation and grammar. |
| Shapes the dictation as a ready-to-send email: greeting, organised paragraphs, a closing line. | |
| Your own | Click New mode under Voice, give it a name and describe the formatting you want — meeting notes, code comments, a social post. The instruction is shown on its card. |
A mode governs tone and notation only. Lists and emails are still detected and structured the way Smart Formatting describes, and dictations under 7 words are pasted as heard in every mode. The same modes, with the same instructions, exist on the Mac.
Ask (Ctrl + Win + A)
Ask a question out loud and get a web-sourced answer without opening a browser. Good for a quick fact, a definition, today’s news on something, or a “how do I…” while you work.
How to use
- 1. Tap Ctrl + Win + A. ahsk starts listening hands-free.
- 2. Ask your question naturally.
- 3. Tap Ctrl + Win to finish. A dark card opens out of the pill and the answer streams in, with headings, lists and source links.
- 4. Press ↩ (or click Insert) to paste the answer at your cursor, or Esc to close the card.
On the card
- • Follow up — hold Ctrl + Win while the card is open (or click the chip), ask, let go. The whole conversation is sent, up to ten turns; the pager at the top steps back through earlier answers.
- • Copy and Regenerate — the two icons beside Insert.
- • The card never takes focus, so the cursor in your document stays where it was — Insert lands exactly there.
Answers come from a model that searches the web as it answers; nothing is pasted until you ask for it, so your document is untouched while you read.
Alan (Ctrl + Win + Alt)
Say what you want done and Alan does it: he writes where your cursor is, opens and closes apps, tidies your folders, opens pages, and when you ask how to do something he shows you on your screen, one step at a time, in any program or website.
How to use
- 1. Hold Ctrl + Win + Alt, Ctrl first. The pill shows Alan’s face instead of the app icon, so you know it is him listening and not dictation.
- 2. Say what you want (examples below).
- 3. Let go. A small bubble by your cursor says what he is doing; then he does it and says what he did.
| Say | What he does |
|---|---|
| “Write a comment on this post”, “reply to this saying I’ll be there”, “give me 100 words on Rome” | Reads the window you were in and types the text at your cursor, in your voice. Click into the box first. Nothing is ever sent; with no text box focused, the text comes back in his bubble instead. |
| “What does this say?”, “summarise this” | Reads the window you were in and answers in a bubble. |
| “Open Figma”, “launch Calculator” | Opens the app, or brings it to the front if it is open. Store apps work too. If the app is not installed, he opens the website. |
| “Close Slack and Spotify” | Closes them the way their X would, so an app with unsaved work asks you to save. |
| “Close everything except Chrome” | Shows you the list first and waits for Ctrl + Enter. |
| “Tidy my Downloads”, “put the invoice PDFs in Documents/Invoices”, “what’s in my Desktop?” | Sorts loose files into folders by type (Images, PDFs, Videos…) or by month, moves the files you name, or lists a folder. Desktop, Downloads and Documents only. He shows you what goes where and waits for Ctrl + Enter. Nothing is ever deleted or overwritten. |
| “Google the weather in Milan”, “open YouTube” | Opens the page or the search in your browser. |
| “How do I turn on dark mode?”, “open Wikipedia and show me how to search” | The guide, below. |
| “Undo” | Takes back what he just did: reopens what he closed, closes what he opened, puts your files back where they were. |
The guide
- • A pointer flies from your cursor to the control and the control is outlined, with the step written beside it. He says each step out loud.
- • Click the control and the next step comes once the screen settles. For a step where you type or drag, press Ctrl + Enter when you are done.
- • Esc ends the guide at any point. When he is done he says so, and the guide stays open: anything you ask him meanwhile (“where is that?”) goes to the guide, and asking something else ends it.
- • If he would send you back to something you already clicked, he looks again first; going round in circles, he stops and says so.
- • Plain questions (“what’s 15% of 80?”) get a short answer in a bubble by your cursor, read out. His bubbles follow your cursor, so they are always where you are looking.
Make it yours
The Dashboard’s Alan tab sets how the guide looks: light or dark bubbles, an arrow or a dot for the pointer, an outline, a hand-drawn loop or nothing round the control, three sizes, six colours, whether captions write themselves in word by word, and whether the working bubble shows. Show me previews it. The same tab turns his voice on or off, picks one of ten voices, sets his volume apart from your PC’s, and sets his language: he listens, answers and guides in it (by default, the language you dictate in).
Each guide step he looks at one screenshot of the monitor your cursor is on; it goes to our server and the model to find the next step and is not kept. His own working bubble is never in it. When you ask him to write about “this”, the text of the window you were in goes to the model the same way. On the free plan you get 20 guides a month, on Pro 150; a guide counts once, however many steps it takes, and the count is under Dashboard → Alan. On the Mac, Alan also works in Calendar, Reminders and Messages.
Meeting Notes (Ctrl + Win + R)
New in 1.14. ahsk records both sides of a meeting — your microphone and the computer’s own audio, captured digitally inside Windows — so Zoom, Teams and Meet calls are covered whether you wear headphones or not. When you stop, the recording is transcribed and organized into notes.
How to use
- 1. Tap Ctrl + Win + R when the meeting starts (or use the tray menu’s Start meeting recording).
- 2. While recording, a red glow frames every screen and a small recording pill with the notetaker’s face sits in the top corner, above every window.
- 3. Tap Ctrl + Win + R again, click the recording pill, or use the tray menu to stop.
- 4. The dashboard opens on the new Notes tab with the finished notes: a summary, key points, decisions, checkbox action items, a mind-map diagram, and the full transcript.
The Notes tab
- • Every meeting is listed newest first; open one to read it rendered, or click Open file for the Markdown.
- • The notes are yours on disk too:
Documents\ahsk meetings. - • Two switches control the indicators: the red screen glow and the corner recording pill.
10 hours a month
Every account includes 10 hours of meeting recording per month; the meter is in the Notes tab and resets monthly. Recording stops on its own if a meeting reaches the remaining allowance.
Please make sure recording a meeting is okay with the people in it — consent rules vary by place. Dictation keeps working normally while a meeting records.
Selection Bubble
Select text in any program — drag over it, double-click a word, or use Shift + arrows — and a small bubble appears under the pointer, like the one the Mac app shows. Its actions, left to right:
- • Ask (the ahsk icon) — ahsk starts listening. Ask your question about the selected text, tap Ctrl + Win to finish, and the answer card opens with the answer.
- • Rewrite — ahsk listens for an instruction (“make it formal”, “shorter”, “fix the grammar”). Tap Ctrl + Win to finish; the rewrite appears on the card and Insert (or ↩) pastes it over your selection.
- • Translate — replaces the selection with its translation into your Translate language. No recording needed.
- • Copy — copies the selection.
- • Search Google — opens a search for the selection in your browser.
- • Add to dictionary — adds the selection to your dictionary so it is spelled right from the next dictation.
- • Dictation mode — switches the mode every dictation is written in (Informal, Formal, Mail or one of yours), right from the bubble.
The bubble goes away on its own after five seconds, when you click elsewhere, or with Esc. It never takes focus, so your selection and cursor stay exactly where they were.
If you would rather not have it, Dashboard › Shortcuts has a switch that turns the bubble off, and one per action to hide the ones you never press.
ahsk reads the selection through Windows accessibility, which most programs support (Notepad, Word, browsers, VS Code, Slack, Teams). In browsers and Electron apps it falls back to a quick copy when needed and puts your clipboard back afterwards. It stays out of terminals and File Explorer, and it cannot see selections in programs running as administrator.
Launcher (Win + Space)
Tap Win + Space anywhere and a search bar drops in near the top of the screen — the Windows counterpart of the Mac app’s Cmd + Space launcher. Type, pick a row with the arrow keys, press ↩. Esc or clicking away closes it.
| Type | What you get |
|---|---|
| An app name | Open it — everything in your Start menu, matched as you type |
find or open + a name | Files and folders — your Desktop, Documents, Downloads, Pictures, Videos, Music and OneDrive, plus any folder you add. Roughly right is enough: rprt finds quarterly-report.pdf. Words inside your documents count too. |
Keyword + query, e.g. g best laptop | Web search: g, img, maps, yt, r, tw, gh, so, npm, hn, w, amz, gpt, cl and more; the keyword alone opens the site |
| A sum, e.g. 12*12 or (3+4)/2 | The result — Enter copies it |
sleep, lock, empty trash, clean up, awake 2h / awake off, restart, shut down, settings | System commands |
kill + an app name | Force quit that program |
| A web address | Opens it in your browser |
| Anything else | The last row is always Ask AI — Enter opens the answer card with the reply |
Folders to search. Out of the box find covers your own folders — Desktop, Documents, Downloads, Pictures, Videos, Music and OneDrive. If your work lives somewhere else, a projects drive or a second disk, add it under the Dashboard’sLauncher tab, in Folders to search. ahsk also asks Windows to index what you add, so a word that appears inside a document finds the file and not just its name; each row says which of the two is active for that folder.
Rows show your apps' own icons and each site's logo, and once you type a keyword and a space the bar's own icon becomes that site's logo. Add your own web searches under the Dashboard’sLauncher tab. Windows uses Win + Space to switch keyboard languages; ahsk takes the chord over while it runs, and the same tab has the switch that hands it back. Store apps (the ones without a Start-menu shortcut) are not listed yet.
Translate (Ctrl + Win + T)
Speak in one language and paste in another. Set the pair once in the Dashboard and the shortcut does the rest — handy for replying to colleagues abroad or writing in a language you read better than you write.
How to use
- 1. Open the Dashboard → Voice tab and choose I speak and Translation mode writes in. The setup walkthrough asks for both, so they are usually already set.
- 2. Put your cursor where the text should go and tap Ctrl + Win + T. ahsk listens hands-free.
- 3. Speak, then tap Ctrl + Win to finish. The translation is pasted at your cursor.
Languages
Both can be any of: English, Spanish, French, German, Italian, Portuguese, Dutch, Russian, Japanese, Chinese, Korean, Hindi, Arabic, Turkish, Polish.
The Translate window
For text you already have: the tray menu’s Translate… opens a window to paste into, and the selection bubble’s Translate can open it with your selection. Pick from 27 languages, press Ctrl + Enter to translate and Copy the result. It uses DeepL; Esc closes it.
The input language is also passed to the transcriber as a hint for all dictation, not only translation — setting it correctly improves accuracy for accented or non-English speech. If input and output are the same language, the shortcut simply pastes what you said unchanged.
Dictionary
Names, brands, acronyms and jargon are where speech recognition guesses wrong. Add them to your dictionary and ahsk passes them to the transcriber as context on every dictation, so “Kubernetes”, “HiQ” or a colleague’s surname come out spelled right.
How to use
- 1. Open the Dashboard → Dictionary in the sidebar (it is the Voice tab scrolled to its dictionary section). Or select a word anywhere and pick Add to dictionary on the bubble.
- 2. Type a word or short phrase and click Add. Remove an entry with the × beside it.
- 3. That is it — the next dictation already uses the updated list. It applies to plain dictation, Ask and Translate alike.
- 4. The dictionary belongs to your account: words you added on the Mac or iPhone are here already, and what you add on Windows shows up there.
- 5. You do not need to add every name: since 1.23 ahsk also picks up names from the window you are dictating into, and recognises a saved word even when it is heard quite differently (“devam” for Daivam).
The transcriber accepts a limited amount of context (about 800 characters). If your list grows past that, the entries you added most recently are the ones that are sent.
Snippets
A snippet is a keyword that turns into a block of text as you type it. Type a semicolon, the keyword and a space in any program — ;mail, ;sig, ;ty — and the keyword is taken back out and the saved text is pasted in its place. It works everywhere your dictation does, and nothing has to be selected first.
Yours to change
- 1. Open the Dashboard → Snippets in the sidebar. Fourteen come with the app — ;mail, ;reply, ;meeting, ;intro, ;email, ;phone, ;addr, ;sig, ;date, ;time, ;ty, ;otw, ;lgtm, ;brb.
- 2. New snippet takes a keyword, a name and the text. Click a row to edit it, or the × to delete it.
- 3. Put
{date},{time}or{clipboard}anywhere in the text and they are filled in as it is pasted. - 4. The switch at the top of the page turns typing expansion off, if you would rather only use them from the launcher.
The launcher knows them too: press Win + Space, type ; and pick one to paste it where you were.
A keyword only expands when it stands on its own — after a space, or at the start of a line. Typing it inside a longer word does nothing, so ordinary text is never rewritten by accident.
Download Video
Press Ctrl + Shift + D anywhere and a panel opens with the link you last copied already filled in. Pick a quality, press Download, and the file lands in your Videos folder. It is in the tray menu too, as Download video.
- 1. Copy a video link — YouTube and hundreds of other sites work. A Spotify track link works too, and saves the song as audio.
- 2. Ctrl + Shift + D. The link is already there; paste one yourself if it is not.
- 3. Choose Best, 1080p, 720p or 480p, or M4A / MP3 for audio only.
- 4. Change… picks a different folder and it is remembered. Show in folder opens it when the download finishes.
ahsk brings everything a download needs and keeps it up to date quietly in the background, which is what keeps it working when a site changes something. There is nothing else to install.
The first time you open the panel, ahsk sets up downloads: a one-time download of about 140 MB, with a progress bar. Every download after that starts straight away.
Convert
Start dragging any file in Explorer or on the desktop, tap Shift once, and a ring of formats opens around your pointer. Drop the file on one: the new file appears beside the original, which is never changed or moved. Tap Shift again for the next formats, or Esc to close. Drag several files to convert them all at once.
- • Photos: JPG, PNG, HEIC, WebP, AVIF, PDF, TIFF, GIF, BMP, ICO, TGA and EXR; Smaller, Half size, 1080 px, rotate, flip, black & white, no location, and Text (OCR). Several photos also become One PDF or an Animated GIF
- • PDFs: Word, Excel (the tables on the pages, like statements and invoices), PowerPoint (a slide per page), Text (scans are read), Markdown, HTML, EPUB, PNG or JPG pages, Smaller, Searchable (scans get hidden text you can search and copy), Split pages, Rotate, Black & white, Page numbers, Watermark, Password, Unlock, Images inside, Summary and Read aloud; several PDFs Merge
- • Documents: Word, RTF, ODT, text, Markdown, HTML and EPUB ebooks to PDF, Word, Word 97, ODT, RTF, HTML, Markdown, EPUB, text, PNG or JPG pages, Summary and Read aloud
- • Spreadsheets: Excel to CSV and CSV to Excel with no Excel needed; also JSON, TSV, PDF, Markdown and HTML tables, and Each sheet (every tab as its own CSV). Several tables Merge into one, columns lined up by name. CSVs are saved the way Excel reads them on your PC: accents intact, with your region’s separator
- • Contacts and calendars: a contacts export (.vcf) or a calendar (.ics) becomes Excel, CSV or any table format, one row per person or event
- • Slides: PowerPoint to PDF, PNG or JPG slides, a video, or a .pptx from an old .ppt; outlines (text or Markdown), Summary and Read aloud
- • Video: MP4, MOV, GIF, MP3, HEVC, 1080p, 720p, 480p, Still frame, Mute, Audio only, WAV, Transcribe and Summary
- • Audio: MP3, M4A, WAV, FLAC, Lossless, AIFF, AAC, Ringtone (the first 30 seconds), Smaller, Transcribe and Summary
- • Any file or folder: Zip, Zip + password (opens in Explorer and on a Mac with the password), TAR.GZ and Preview image; archives (zip, RAR, 7z, tar, gz, ISO, cab) Extract
Password, Unlock, Zip + password and Watermark ask for what they need after you drop; ahsk never keeps a password. The Dashboard’s Convert tab turns each format on or off, sets whether new files go to Downloads and how small Smaller makes a photo, and has Choose files… to convert without dragging.
Everything except Transcribe and Summary happens on your PC. Formats that need an Office app appear only when it is installed: Word for PDF and Word from documents and for PDF to Word, Excel for a spreadsheet’s PDF and old .xls files, PowerPoint for slides. HEIC needs the free HEIF Image Extensions from the Microsoft Store. Video, audio, WebP, AVIF and GIF use a converter ahsk downloads once (about 80 MB) the first time you need it.
Clean Up
Press Win + Space and type clean. Two rows appear: Clean up shows a list first, Clean up now just does it. It is in the tray menu too, as Clean up….
- 1. Clean up looks through your PC for a second and lists what can go, with each size.
- 2. Untick anything you want to keep. Your choices are remembered for next time.
- 3. Press Clean. The panel shows what was actually freed: disk, memory and cache.
| Row | What goes |
|---|---|
| Temporary files | Files programs left in your temp folder and have not touched for a day. Anything in use is skipped. |
| Thumbnail & icon cache | Picture previews Windows redraws on its own. Files Explorer is still using are skipped. |
| Crash dumps & error reports | Leftovers from programs that crashed. |
| Chrome, Edge and Firefox cache | Saved copies of web pages, so sites load a little slower the first time. Never your logins, cookies, passwords or history. A browser that is open is left alone and the row says so. |
| Old ahsk updates & meeting audio | Installers from past updates, and meeting recordings older than 30 days. Your meeting notes are kept. |
| Recycle Bin | Emptied for good. Untick it if you might still want something in there. |
| Trim background apps | Gives back memory that apps are holding but not using. Nothing closes. |
| Clear standby cache | Empties the memory Windows keeps for files it might open again. Windows asks for permission each time. |
| Close apps | The programs using the most memory, never ticked for you. Each one closes the way its X would, so it can ask you to save; one that is still open afterwards is listed. |
Clean up now uses what you last ticked, shows the result beside the pill, and never closes your apps. To make Clean up skip the list as well, turn on Clean up without asking under the Dashboard’s Shortcuts tab.
Freed memory fills up again as you use your apps — that is Windows doing its job, not the clean failing. It helps most right before something heavy, like a game or a video export.
Keep Awake with the Lid Closed
Start Claude Code, Codex or any long job, close the lid, and it keeps running with the screen off. Right-click the tray icon → Keep awake with lid closed and pick 30 minutes, 1, 2 or 4 hours, or Until I stop it. Or press Win + Space and type awake 2h (awake 45m, or awake alone for until you stop it).
- • While it is on, the tray menu and the tray icon show the time left. Stop it from the tray or with
awake off. - • It stops by itself when the time is up, when the battery reaches 15% unplugged, or when ahsk quits.
- • Your setting comes back. While it runs, closing the lid does nothing; afterwards closing the lid does what it did before — even if ahsk crashed or the PC restarted in between.
A closed laptop in a bag gets warm. Leave it somewhere with air, and plug it in for long runs.
Where Your Text Goes
ahsk pastes into whatever had keyboard focus when you started the shortcut. It does this by briefly placing your text on the clipboard and sending Ctrl + V, then putting your previous clipboard contents back — whatever they were, text, image or file — so dictation never costs you something you copied earlier.
When there is nowhere to paste
The cases where the text is left on the clipboard instead, with a tile telling you so:
- • No text field is focused — for example the desktop or a read-only page. Click into a field and press Ctrl + V.
- • The program did not take it — ahsk looks at the field a second after pasting, and if your words are not there the tile reads Copied to clipboard. Press Ctrl + V where you want them.
- • ahsk cannot tell (since 1.25) — some programs do not let ahsk read their text field back. Your words stay on the clipboard and the tile reads Also on your clipboard: if they did not appear, press Ctrl + V. Your previous clipboard is not put back in this case.
- • The window runs as administrator — Windows does not let normal programs type into elevated ones (Task Manager, an admin PowerShell, some installers). Press Ctrl + V there yourself.
Everything you dictate is also kept in Recent transcriptions in the Dashboard, so a paste that went to the wrong window is never lost.
Dashboard
The Dashboard is the app’s only window, laid out the same way as the Mac app. Open it from the tray icon (Open ahsk) or by launching ahsk again from the Start menu — a second launch just brings it up. Closing it hides it; ahsk keeps running. It is light or dark to match your Windows app mode.
Sidebar
- • Home, Get started (a short video for each thing ahsk does), Alan and Notes, then a Settings group with Voice, Dictionary, Launcher, Snippets and Shortcuts.
- • At the foot: the update pill (click to check, or to install when a version is waiting), the plan card with your free-words progress and Upgrade, and your name — click it for Account.
Home
- • The hero card — words dictated, your pace (the median of recent dictations, so one open mic cannot drag it down), time saved against typing at 40 wpm, and your day streak. The chip in the corner is the mode you are dictating in.
- • Get started — six tasks judged from what you have already done; the strip disappears once they are all ticked.
- • Dictation mode — the same cards as under Voice; click one to switch.
- • History — every dictation grouped by day (Today, Yesterday, then dates), with a search box and a copy button on each row.
Voice
- • I speak — the language you dictate in, passed to the transcriber for accuracy.
- • ahsk writes in — the language plain dictation comes out in; “same as spoken” by default.
- • Translation mode writes in — what Ctrl + Win + T pastes in.
- • Input — the microphone ahsk records with. Automatic (the default) picks a wired mic first, then the built-in, Bluetooth last, and switches when you plug one in or pull it out — the Mac rule. Or pin a specific one; ahsk falls back to automatic if it disappears. A mic that stops sending sound is swapped for the next one, but a wired or built-in mic is never swapped for a Bluetooth headset. Plus the pill position, top or bottom of the screen.
- • Preferences — Mute sounds, Live transcript (your words in a card while you dictate hands-free; off by default) and Use what’s on screen (names on your screen as spelling hints).
- • Voice modes — Informal, Formal, Mail and your own. See Dictation Modes.
- • Custom dictionary — words the transcriber should know how to spell. See Dictionary.
Shortcuts
- • Every chord with what it does. They are fixed in this version.
- • Reminders — the “you could say this instead” note while you type.
- • Startup — Open ahsk when Windows starts. On by default.
- • Clean up — skip the list and clean straight away.
- • Selection bubble — turn the bubble off, or hide the actions you never use.
Account
- • Your name and email, your plan with words used and an Upgrade (or Manage plan) button.
- • Contact support, Open data folder, Open logs folder and Sign out. Signing out runs the setup tour again on next sign-in.
Keyboard Shortcuts
Almost every shortcut starts with Ctrl + Win, pressed Ctrl first. The exception is the downloader: Windows keeps Ctrl + Win + D for virtual desktops, so it is Ctrl + Shift + D. They work in any program and cannot be changed in this version.
| Shortcut | Gesture | Action |
|---|---|---|
| Ctrl + Win | Hold | Push-to-talk dictation — release to paste |
| Ctrl + Win + Space | Tap | Start hands-free dictation |
| Ctrl + Win | Tap (while hands-free) | Stop and paste |
| Ctrl + Win + A | Tap | Ask a question — answer shown in a panel |
| Ctrl + Win + T | Tap | Translate what you say into your output language |
| Ctrl + Win + Alt | Hold | Alan — he writes at your cursor, opens and closes apps, tidies files, opens pages, or guides you on screen |
| Ctrl + Enter | Press (Alan) | Move Alan’s guide on after a typing step, or say yes to what he asked |
| Ctrl + Win | Hold (card open) | Ask a follow-up on the answer card |
| ↩ | Press (card open) | Insert the answer at your cursor |
| Ctrl + Win + R | Tap | Start or stop a meeting recording |
| Ctrl + Shift + D | Tap | Open the video downloader |
| Win + Space | Tap | Open the launcher (turn off under Dashboard › Launcher) |
| Shift | Tap while dragging a file | Open the Convert ring; tap again for more formats (turn off under Dashboard › Convert) |
| Esc | Press | Close the answer card or the launcher, end Alan’s guide, say no to what he asked, or throw away a hands-free take |
A reminder you can speak instead. After eight characters typed in a row, a small note appears beside the pill pointing out you could hold Ctrl + Win and say it. It keeps turning up rather than stopping after your first few days — that is when people forget ahsk is running. Turn it off for good under the Dashboard’s Shortcuts tab, inReminders.
The letters follow your keyboard layout, not the physical key position — on an AZERTY keyboardCtrl + Win + A is the key printed A. Nothing ahsk types itself (the paste) is ever mistaken for you pressing a shortcut.
Plan
Two plans, the same on every platform:
| Plan | What you get |
|---|---|
| Free | 10,000 dictated words, then ahsk asks you to upgrade. Every feature is included until then, with 20 translations, 20 web searches, 20 AI answers and 10 video downloads, plus 20 on-screen guides from Alan a month. |
| Pro | Unlimited dictation and every feature, and 150 guides from Alan a month. |
Words are counted from the day the free allowance reached your account, so nothing you dictated before it counts against you. Your progress is on the sidebar’s plan card and under Account; when the allowance is used up a card beside the pill says so — with the same sound as any other press that goes nowhere — and Upgrade to Pro on it opens pricing.
Updates
ahsk checks for a new version at launch, every six hours while running, and when your PC wakes from sleep. When one is available the pill at the foot of the Dashboard’s sidebar turns blue and reads Update available. Clicking it any other time checks again.
From 1.9 on, clicking it is the whole update. ahsk downloads the new version itself — the pill counts it up — installs it, and relaunches. There is no browser download, no wizard to click through, and no “Windows protected your PC” warning, because the file never passes through a browser. Your sign-in, history, dictionary and settings are all kept.
If anything goes wrong on the way — no connection, a download that stops halfway — ahsk falls back to opening the download page in your browser, so you can always install by hand.
System Requirements
- • Windows 10 (version 1809) or Windows 11, 64-bit.
- • Arm PCs (Snapdragon / Copilot+) run the same build under Windows’ built-in emulation. It works; the microphone takes about half a second longer to open.
- • A microphone — built-in, USB and Bluetooth all work. ahsk picks one itself (wired first, then built-in, Bluetooth last) unless you pin one under Dashboard → Voice → Input.
- • Microphone access for desktop apps enabled in Settings → Privacy & security → Microphone.
- • An internet connection — transcription, formatting, Ask and Translate run on our servers.
Everything the app needs ships inside the installer; there is no separate .NET or runtime to install.
Privacy
- • Dictation audio is never stored. A recording exists only in memory for the moment it takes to transcribe it, then it is gone. Meeting recordings are the one exception: their audio is kept on your PC in
%LocalAppData%\ahsk\meetings(it is sent only to be transcribed, never kept on a server), and Clean up removes it after 30 days. - • Your history stays on your PC — transcriptions and stats live in
%LocalAppData%\ahsk. Use Clear all in the Dashboard to wipe them. - • No keys on your PC. Since 1.26 every request to our speech, writing and translation services goes through our server with your sign-in, and the server adds its own keys. ahsk never holds them.
- • Your clipboard is yours. ahsk restores whatever was on it after every paste it can see land, and its own pastes are not added to Windows clipboard history.
- • Alan sees only what you ask about. A guide sends one screenshot per step; “write a reply to this” sends the text of the window you were in. Neither is kept. His file tools only move files inside Desktop, Downloads and Documents, never delete them, and only after you say yes.
- • Minimal account data — we store your email, plan and usage counts. Your sign-in token is encrypted with Windows’ own data protection so only your user account can read it.
- • Never used for training — your speech, text and questions are never used to train AI models.
- • Names on your screen — when you press the keys, ahsk reads the window you are dictating into on your PC and sends only the names and terms it finds (at most 40 words) as spelling hints — never the text itself. Turn it off under Dashboard → Voice → Use what’s on screen.
Troubleshooting
Pressing the shortcut opens the Start menu
Press Ctrl before Win. ahsk only takes over the Win key once Ctrl is already held; Win on its own is still the Start menu.
“Can’t reach your microphone”
Open Settings → Privacy & security → Microphone and turn on both Microphone access and Let desktop apps access your microphone. If another program has the mic open in exclusive mode (some conferencing and audio tools do), close it and try again.
“Is your microphone muted?” every time
Open Dashboard → Voice → Input and check which microphone ahsk is using; pin the one you talk into if Automatic picks another. Then check its level moves in Settings → System → Sound → Input. Replay the setup walkthrough from the tray menu to see ahsk’s own live meter.
The shortcut stopped responding after a while
ahsk repairs its keyboard hook automatically, including after sleep and unlock. If it still seems dead, right-click the tray icon → Quit ahsk and start it again from the Start menu.
Text was transcribed but not pasted
It is on your clipboard — press Ctrl + V. This happens when no text field had focus, the program did not take the paste, or the target window runs as administrator; see Where Your Text Goes.
Dictation pastes without punctuation
Dictations shorter than 7 words are pasted as heard by design. For longer ones, check your connection — the formatter falls back to the raw text when it cannot be reached — and the mode you have selected: Informal keeps things casual on purpose.
SmartScreen blocks the installer
Click More info, then Run anyway. The build is unsigned for now; the download itself comes from our GitHub releases page.
Need more help?
Write to support@ahsk.app and attach ahsk.log from the tray menu’s Open logs folder — it tells us exactly what happened.