Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
FREEDOM251

Freedom251 › Blog › Linux terminal

How to install and use Ubuntu voice dictation in the terminal

By Freedom251 Team · · 10 min read

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Ubuntu does not include a built-in shell command that turns your microphone into terminal text. The practical approach is speech-recognition software that injects recognized words into whichever window currently has focus. For a keyboard-driven workflow, install vosk-cli-dictation; for a tray-based, desktop-wide interface, install Vocalinux. In either case, click the terminal prompt before you speak, and review any dictated command before pressing Enter.

What “voice dictation in the terminal” actually means

Both approaches described here listen through your microphone, convert speech to text locally or through a configured engine, and type the result into the focused application. They do not create a special Ubuntu shell syntax and they do not automatically know whether you intend prose, a command, or a filename. If the terminal is focused, the inserted text appears there; if another window is focused, that window receives it instead.

As an Amazon Associate I earn from qualifying purchases.

This distinction matters for safety. Dictation can enter sudo commands, paths, punctuation, and line breaks, but recognition is not guaranteed to be exact. Treat the output as untrusted input: inspect it, correct it, and only then execute it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the route that fits your workflow

Question vosk-cli-dictation Vocalinux
Primary style Command-line-oriented package and keyboard controls Desktop application with a tray indicator and settings
Best fit You want a small, keyboard-driven workflow and control from shell subcommands You want dictation available across applications with a desktop interface
Ubuntu baseline Documented package route for Ubuntu 24.04 and newer Debian-derived systems Ubuntu 24.04 or an Ubuntu-based distribution
Language/model choice English, French, German, and Spanish are listed; install the matching Vosk model Choose a language and model size in the application; local engines include whisper.cpp, Whisper, Faster Whisper, VOSK, and Parakeet
Activation Spoken start/stop phrases, toggle, push-to-talk, or silence timeout Hold Right Alt to dictate, or enable toggle mode in Settings
Desktop integration Uses a text-injection backend; Wayland shortcuts are configured in the desktop’s shortcut settings Tray and settings integration handle activation and engine selection
Network use Required initially for bindings and a model unless you supply them yourself; recognition can then run locally Model downloads require connectivity; local engines run on the machine afterward, while a remote API is optional and disabled unless configured

There is no controlled accuracy comparison between these routes. Neither project’s available documentation provides an independently validated recognition-accuracy statistic, so choose based on workflow and integration rather than an unsupported percentage.

#1 Best Overall
FIFINE AmpliGame AM8 USB/XLR Dynamic Microphone for Gaming Streaming | Podcast Mic with RGB Light, Mute Button, Headphones Jack, Desktop Stand, for Vocal Recording Singing YouTube
  • [Natural Audio Clarity] Operated with frequency response of 50Hz-16KHz, the podcasting XLR mic delivers balanced audio range, likely to resonate with your audience. Directional cardioid dynamic microphone corded will not exaggerate your voice, while rejects unwanted off-axis noise for vocal originality and intelligibility during your PS5 gaming streaming video recording. (Tips: Keep the top of end-addressing XLR dynamic microphone AM8 facing audio source, and suggested recording range is 2 to 6 in.)
  • [XLR Connection Upgrade-Ability] To use XLR connection, connect the podcast microphone to an audio interface (or mixer) using a separate XLR cable (NOT Included) . Well-connected and smooth operation improves audio flexibility to make you explore various types of music recording singing. The streaming mic isolates the pristine and accurate sound from ambient noise with greater no interference and fidelity. (RGB and function key on mic are INACTIVE when using XLR connection.)
  • [USB Connection with Handy Mute] Skip the hassle of setting something up and plug the cable to play the dynamic USB microphone directly, which suits for beginner creators or daily podcast. You can quickly control the gamer mic with tap-to-mute that is independent of computer/Macbook programs to keep privacy when live streaming. LED mute reminder helps you get rid of forgetting to cancel the mute. (RGB and function key are only available for USB connection, but NOT for XLR connection)
  • [Soothing Controllable RGB] RGB ring on the desktop gaming microphone for PC, with 3 modes and more than 10 light colors collection, matches your PC gears accessories for gaming synergy even in dim room. You can control the RGB key button of the dynamic microphone USB directly for game color scheme gaming or live streaming. Configured memory function, the streaming microphone RGB no need to repeated selections after turnning off and brings itself alive when power on. (Only available for USB connection)
  • [More Function Keys] Computer microphone with headphones jack upgrades your rhythm game experience and gets feedback whether the real-time voice your audience hear as expected. Get the desired level via monitoring volume control when gaming recording. Smooth mic gain knob on the PC microphone gaming has some resistance to the point, easily for audio attenuation or boost presence to less post-production audio. (Only available for USB connection)

Prepare Ubuntu and your microphone

You need a working microphone and a desktop session that permits applications to inject text. A built-in laptop microphone or an existing USB headset is sufficient; buy a microphone only if your computer has no usable input device. Before installing either route, check that Ubuntu can see the device in Settings → Sound → Input and that the input meter responds when you speak.

  • Ubuntu version: The documented package and Vocalinux installer target Ubuntu 24.04 or newer. Other distributions may work, but their package names, audio stack, or desktop shortcut screens can differ.
  • Microphone: A working input device is required for recognition.
  • Network connection: The first setup downloads Python bindings and speech models. Plan for internet access even though subsequent local recognition can work offline.
  • For Vocalinux: The guide lists Python 3.11 or newer and curl as prerequisites.
  • Session type: Wayland and X11 use different injection arrangements. You can identify the session with echo $XDG_SESSION_TYPE.

Route A: install vosk-cli-dictation from the Debian package

1. Obtain the current package

The project documents a Debian package for Debian 12 and newer derivatives, including Ubuntu 24.04. Its downloads page identified version 0.5.4-beta at the time of writing. Package names and versions can change, so use the current filename shown on that page rather than assuming that an older download remains available.

2. Install the local .deb

For the documented package filename, run:

sudo apt install ./vosk-cli-dictation_0.5.4~beta_all.deb

The ./ tells apt that the file is in your current directory. If you downloaded it elsewhere, change to that directory first or provide the file’s full path. After installation, the vosk-cli-dictation command should be available on your PATH.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Let the first run create its environment

On first use, the program creates a private Python environment and downloads the Vosk Python bindings. The Debian package does not include an acoustic speech model, so recognition will not work until a compatible model is installed.

4. Download an English model

The project provides a command for its small English model:

Rank #2
FIFINE K669B USB Microphone, Condenser Recording Mic for Vocals, Meeting | Metal Cardioid Laptop Mic for MAC OS, Windows, Voice Overs, Streaming, Online Meeting and YouTube Videos
  • [Convenient Setup] Plug and play recording USB microphone for PC, with 5.9-Foot USB cable included for computer PC laptop, is connected directly to USB-A port for recording music, computer singing or podcast. The office condenser microphone for computer is easy to use and install. (NOT compatible with Xbox and Phones)
  • [Durable Metal Design] Solid sturdy metal construction design, the computer microphone for Zoom meetings with stable tripod stand is convenient when you are doing voice overs or livestreams on YouTube. Durable material extends the service life of the voice-over microphone.
  • [Mic Volume Knob] Gaming condenser USB mic compatible for PS4 with additional volume knob itself has a louder or quieter adjustment and is more sensitive. Your voice would be heard well enough through the zoom microphone USB when gaming, skyping or voice recording. Also, you can adjust your volume to zero and protect your privacy.
  • [Widely Use] USB-powered design, the condenser microphone for recording no need the 48v Phantom power supply, works well with Cortana, Discord, voice chat and voice recognition. The podcast microphone for Mac, with USB-B to USB-A/C cable, is compatible with desktop, laptop or PS4/PS5, which meets most of your daily recording needs.
  • [Clear Output Voice] Cardioid condenser microphone for PC captures your voice properly, producing clear smooth and crisp sound. Great computer recording mic for gamers/streamers/youtubers focus on the main source and reduces background noise. The streaming microphone does the job well for broadcast ,OBS and teamspeak.
vosk-cli-dictation --download-model en

You can also download a model from the Vosk model collection and put it in the model directory documented by the project. A model must match the language you select; installing the program alone is not enough.

Start dictating into a terminal

  1. Open your terminal and click the shell prompt, or place the cursor in a terminal editor. The terminal must have focus at the moment text is injected.
  2. Start the program with vosk-cli-dictation.
  3. Say start dictation in English, or use the equivalent documented control for your selected language.
  4. Speak the text you want inserted. The recognizer types it into the focused terminal window.
  5. Say stop dictation when you are finished, or use a finalize control.
  6. Read the entire inserted line. Correct names, options, punctuation, paths, and numbers before executing a command.

English, French, German, and Spanish are listed as supported languages. Select a language with the --lang option, for example:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
vosk-cli-dictation --lang fr

The corresponding acoustic model must already be installed. The documentation also defines spoken words for punctuation and newlines; use the command vocabulary for the selected language instead of assuming that an English punctuation word will work in another language.

Control dictation from the command line

The program exposes the same actions as subcommands, which is useful when a spoken trigger is inconvenient or when you want to bind a desktop shortcut:

vosk-cli-dictation --toggle
vosk-cli-dictation --finalize
vosk-cli-dictation --sleep-toggle
vosk-cli-dictation --diagnose
  • --toggle starts or pauses dictation.
  • --finalize stops the current dictation and copies the recognized text according to the project’s workflow.
  • --sleep-toggle releases or resumes the microphone without necessarily ending the session.
  • --diagnose reports the session type, injection backend, audio device, and model status.

The default trigger mode is toggle. The guide also describes push-to-talk and a mode that stops after a configured silence timeout. Choose the mode that matches your environment: push-to-talk limits accidental listening, while a silence timeout can be more convenient for longer passages.

Rank #3
Sale
Logitech Creators Blue Yeti USB Microphone for PC, Mac, Gaming, Recording, Streaming, Podcasting, Studio and Computer Condenser Mic with Blue VO!CE effects, 4 Pickup Patterns, Plug and Play - Blackout
  • Custom three-capsule array: This professional USB mic produces clear, powerful, broadcast-quality sound for YouTube videos, Twitch game streaming, podcasting, Zoom meetings, music recording and more
  • Blue VO!CE software: Elevate your streamings and recordings with clear broadcast vocal sound and entertain your audience with enhanced effects, advanced modulation and HD audio samples
  • Four pickup patterns: Flexible cardioid, omni, bidirectional, and stereo pickup patterns allow you to record in ways that would normally require multiple mics, for vocals, instruments and podcasts
  • Onboard audio controls: Headphone volume, pattern selection, instant mute, and mic gain put you in charge of every level of the audio recording and streaming process
  • Positionable design: Pivot the mic in relation to the sound source to optimize your sound quality thanks to the adjustable desktop stand and track your voice in real time with no-latency monitoring

Wayland, X11, and text injection

Wayland

Under Wayland, bind the program’s subcommands through your desktop’s own keyboard-shortcut settings. The documented injection arrangement uses wtype together with wl-clipboard. The project’s guide describes these subcommands as the supported path for Wayland shortcuts rather than relying on a global hotkey that the desktop may block.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For example, create a custom shortcut whose command is vosk-cli-dictation --toggle, and another for vosk-cli-dictation --finalize if you want separate keys. The exact menu varies by desktop; GNOME exposes custom shortcuts in its keyboard settings, while other Wayland desktops place them elsewhere.

X11

On X11, the documented arrangement uses xdotool and xclip. If the normal backend cannot inject text, ydotool is available as a fallback. That fallback may require its daemon to be running and your account to belong to the input group. Group changes normally require signing out and back in before they take effect.

Diagnose before changing random settings

Run:

vosk-cli-dictation --diagnose

Use the report to distinguish an audio-device problem from an injection problem. If recognition appears in diagnostics but no characters reach the terminal, check focus first, then the backend and the requirements for your session type.

Source installation for development or unsupported package layouts

The source route is an alternative when you are developing the project or using a distribution without the documented native package. It is not the simplest beginner path.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
JOUNIVO USB Microphone, 360 Degree Adjustable Gooseneck Design, Mute Button & LED Indicator, Noise-Canceling Technology, Plug & Play, Compatible with Windows & MacOS
  • 360 Degree Position Adjustable Gooseneck Design --Plug and play USB microphone Pick up the sound from 360-degree with high sensitivity, in the best possible location for sound to your PC gaming, dragon voice dictation, and talk to Cortana
  • Mute Button & LED Indicator --One-click to mute/unmute your microphone for pc, Build-in LED indicator tells you the working status at any time
  • Intelligent Noise-Canceling Tech --Premium omnidirectional condenser microphone with noise-canceling technology can pick up your clear voice and reduce background noise and echo
  • USB Plug&Play(1.8/6ft USB Cable) -- No driver required. Just need to plug & play for the microphone to start recording, well compatible with Windows(7, 8, 10 and 11) and macOS. (NOT compatible with Xbox/Raspberry Pi/Android)
  • Solid Construction--Adopting premium metal pipe and heavy-duty ABS stand to make sure that you will be satisfied with our computer mic quality
  1. Clone the project repository.
  2. Create and activate a Python virtual environment.
  3. Install the dependencies listed in requirements.txt.
  4. Install the required system packages, including portaudio19-dev, gettext, and a suitable text-injection backend.
  5. Start the application with python3 src/main.py.

System package names and backend requirements can differ by distribution. If you choose this route, follow the project’s current build instructions rather than mixing files from the package installation with the source environment.

Route B: install Vocalinux for desktop-wide dictation

Prerequisites

The Ubuntu-specific guide lists Ubuntu 24.04 or an Ubuntu-based distribution, Python 3.11 or newer, a working microphone, and curl. It identifies Ubuntu 24.04 GNOME on both Wayland and X11 as tested environments and also lists Kubuntu and Linux Mint derivatives.

Run the interactive installer

Use the installer command supplied by the project:

curl -fsSL https://raw.githubusercontent.com/VocaHQ/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --interactive

The command downloads the script to /tmp/vl.sh and starts its interactive mode. Read the prompts before accepting them, particularly if your system has multiple Python installations or more than one audio device.

Use Vocalinux with a terminal

  1. Launch Vocalinux and confirm that its tray indicator is present.
  2. Click the terminal prompt so it is the focused application.
  3. Hold Right Alt while speaking, or enable toggle mode in Settings.
  4. Choose the language and model size in the application.
  5. Release the key or stop toggle mode, then inspect the inserted text before running it.

Vocalinux is designed to type into whichever application has focus, so the same focus rule applies to terminals, editors, browsers, and other windows. Its local engines include whisper.cpp, Whisper, Faster Whisper, VOSK, and Parakeet. Models run on your machine after download; an optional remote API exists but is off unless you configure it. The repository showed release v0.18.1 at the time of writing, so check the current release information before relying on that version number.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Which route should you use?

Choose vosk-cli-dictation when

  • You prefer installing a Debian package and controlling the session with shell commands.
  • You want spoken start/stop phrases, push-to-talk, or a silence timeout.
  • You are comfortable configuring a Wayland shortcut or checking an X11 injection backend.
  • You mainly need a keyboard-oriented workflow for a terminal or terminal editor.

Choose Vocalinux when

  • You want a tray indicator and graphical settings.
  • You dictate into several applications, not only a terminal.
  • You want to select among several local recognition engines and model sizes from the desktop interface.
  • You prefer holding Right Alt over managing command-line toggles.

Neither choice removes the need to focus the destination window. The difference is how you start, configure, and integrate dictation, not where the recognized characters are sent.

Best Value
Sale
CMTECK USB Computer Microphone G009, Noise-Cancelling Recording Desktop Mic for PC/Laptop for Online Chatting, Home Studio, Podcasting, Gaming, Skype, YouTube with Mute Function(Windows/Mac)
  • 【Crystal Clear Audio Quality】Our Omnidirectional pattern condenser microphone accurately captures your voice, making it perfect for dictation, online classrooms, and more.
  • 【Active Noise-Cancelling】Come in CMTECK CCS2.0 SMART CHIP with Omnidirectional Polar Pattern, which can effectively block the background noise. The pop filter prevents plosives from overloading the microphone, ensuring only your voice is heard.7
  • 【Convenient Mute Button with LED Indicator】You can quickly mute/un-mute the microphone with the Mute Button and the built-in LED light lets you know the working status(Greenlight: Connected; Red light: Mute mode).
  • 【Easy to use】 No drivers needed, just plug and record without external power supply, directly connect the microphone to a USB compatible device, well compatible with Windows(7, 8 and 10), Mac OS and PS4 (NOT compatible with Raspberry Pi/Linux/Android)
  • 【Mini size with Adjustable Gooseneck】Adopted flexible and adjustable gooseneck metal pipe, easily adjust position 360 degrees to suit user comfort. The compact and stable base maximizes your desktop space.

Troubleshooting common failures

No text appears in the terminal

  • Click the terminal prompt again; another window may have taken focus.
  • Run vosk-cli-dictation --diagnose and confirm that an audio device, model, and injection backend are reported.
  • Check that the terminal is running inside the desktop session where the injector is configured.
  • On Wayland, create a desktop shortcut for the documented subcommand instead of relying on an X11-only hotkey utility.

The model is missing

The Debian package does not bundle the acoustic model. Run vosk-cli-dictation --download-model en for the small English model, or install a model from the Vosk collection in the documented model directory. For another language, install that language’s model and start the program with the matching --lang value.

The first launch fails without internet access

Initial setup can need a connection because the package downloads Vosk bindings and the model is a separate download. Complete those downloads once, then local recognition can operate without a continuing network connection. Vocalinux likewise needs connectivity to obtain its installer and selected models; its local engines do not require a remote API after setup.

Wayland hotkeys do nothing

Use the desktop’s keyboard-shortcut panel to bind vosk-cli-dictation --toggle or another documented subcommand. Verify the session type and run diagnostics. Do not assume that an xdotool-style X11 shortcut will work unchanged under Wayland.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Only part of a sentence is inserted

Check the trigger mode. A push-to-talk release, silence timeout, or finalize action can end a segment earlier than expected. Speak the punctuation and newline commands documented for your language, and review the resulting text before sending it to the shell.

Punctuation or words are wrong

Confirm that the selected language matches the installed model. Recognition quality depends on the microphone, background noise, speech, and model; the available documentation does not establish a guaranteed accuracy rate. For commands, dictate in short chunks and verify every option, path, quote, and number.

Safe terminal use with voice input

  • Keep the terminal focused only while you intend to dictate into it.
  • Use a non-destructive command or a text editor to test the setup before attempting administrative work.
  • Inspect characters that speech recognition commonly confuses, including hyphens, underscores, slashes, dots, quotes, and numerals.
  • Do not let a dictated line run automatically. Read it, move the cursor through it if necessary, and press Enter yourself.
  • Use finalize or stop controls before switching to another window, so unfinished recognition is not inserted into the wrong application.
  • If privacy matters, prefer a local model and disable any optional remote API; local processing still requires downloading the software and model initially.

What to expect after setup

Once the model, audio device, and injector are working, the recurring workflow is short: focus the destination, activate dictation, speak, stop or finalize, and proofread. The software is an input layer for your desktop, not a shell feature. That is why the same installation can type into a terminal editor or another application, and why focus and desktop-session configuration determine where the text goes.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux terminalSpeech to TextUbuntuVoice dictationVoskWaylandX11

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.