Okay, so, I had to look at the windows flow a bit more in-depth. Winget was a good tool but it’s actually unmaintained and people have been reporting some possible malicious packages. So I redid the entire install script to not use winget anymore. It’s much easier to install stuff on Linux, there the install script would have just done everything for you 😭 but no worries, it is what it is.
What you will need:
Install the latest Python version here: https://www.python.org/downloads/windows/. Python now offers the ‘install manager’, and they said this is how you will install Python from now on. So it’s probably better to use the install manager, and install the latest 3.12.x version of Python from it. Add it to your PATH if there is a checkbox for it, otherwise it will be pretty much useless (it should just be checked by default but it is what it is).
ffmpeg: ffmpeg is required for STT to work. On its own website, ffmpeg links to this website: https://www.gyan.dev/ffmpeg/builds/. Scroll down and download ffmpeg-release-full.7z. This is a guide that explains what to do with this zip file afterwards: https://www.wikihow.com/Install-FFmpeg-on-Windows. I’m sorry that ffmpeg is such a mess to install on windows but they don’t provide an installer unfortunately.
yt-dlp: https://github.com/yt-dlp/yt-dlp/releases. The latest as of writing is yt-dlp 2026.06.09, and the file is simply called
yt-dlp.exe. Click on it in the list to download, then run the .exe to install yt-dlp on your computer.
Pandoc: You can install pandoc from here: https://github.com/jgm/pandoc/releases. The latest as of writing is
pandoc-3.10-windows-x86_64.msi - it’s also an installer that you just run to install pandoc.
Then you can run the install script provided on my codeberg repo. In Powershell (not cmd):
The install script is very simple; it just sets up a folder called stt in C:\Users\YourUsername. Everything that STT sets up by itself stays within that stt\ folder. When stt is installed correctly, the installer script will tell you with the words “stt installed. Open a NEW terminal window and type: stt --help”
Open a new cmd or powershell, and simply run the command ‘stt gui’. It will open the user interface in a new window, which is probably easier to use. I find that when I was on Windows I preferred user interfaces, and on Linux I prefer command-line tools lol.
The first time you actually start transcribing or translating a video, stt will automatically download the models. This happens automatically, you just have to wait. But it means the first transcription will take a bit more time to finish.
If you ever want to uninstall stt from your computer, run this in PowerShell:
# Windows (PowerShell)
[Environment]::SetEnvironmentVariable("Path", $env:Path.Replace("$HOME\stt\.venv\Scripts", ""), "User")
Remove-Item -Recurse -Force$HOME\stt
ffmpeg, yt-dlp and pandoc are pretty nice tools to have on any computer. ffmpeg can convert and compress any video file. yt-dlp allows you to download videos from any website by just running ‘yt-dlp https://link.com/’ in the CMD, and pandoc can convert any text format to any other text format, so you can convert . So they are dependencies, but they are generally good tools to have. Python as well is pretty nice to have as a lot of open-source software uses python. You only install it once then most open-source software is available to you.
That’s actually very smart, for people who aren’t afraid of using WSL. Then you would just sudo apt installthe dependencies (and I assume since it’s an ubuntu subsystem it already has python 3.12), and then run the installer for Linux through WSL:
I also heard that your C:\ drive mounts in the WSL through /mnt/c/, so you can pass any audio file to stt by simply specifiying ‘stt transcribe “/mnt/c/Documents/my_video.mp4”’
but I assume you will have to run stt through the WSL cli from then on?
Yes it would be the CLI. Thing is that it’s simpler since the Linux filesystem gets exposed in the File Manager (it’s literally a “Linux” tab next to “This computer”)
So, you can just drag and drop a file from the Videos folder in Windows into Linux and vice-versa.
So you could drag the video into Linux, run stt transcribe /home/user/my_video.mp4 and then grab it back to Windows Videos folder (or just use the Linux folder since it’s treated as a regular directory by Windows)
It’s easier for a beginner than messing with mounting and mv. It’s what I do in my work computer whenever I need to do something with yt-dlp.
It’s very, very convenient. I wonder if WSL is the reason why winget was abandoned
deleted by creator
which operating system are you on? I can provide more specific instructions.
The difficult part is installing the program, using it will come naturally once you’ve done it once or twice.
deleted by creator
Okay, so, I had to look at the windows flow a bit more in-depth. Winget was a good tool but it’s actually unmaintained and people have been reporting some possible malicious packages. So I redid the entire install script to not use winget anymore. It’s much easier to install stuff on Linux, there the install script would have just done everything for you 😭 but no worries, it is what it is.
What you will need:
Then you can run the install script provided on my codeberg repo. In Powershell (not cmd):
iwr https://codeberg.org/CritBase111/speech-to-text/raw/branch/main/install.ps1 | iexThe install script is very simple; it just sets up a folder called stt in C:\Users\YourUsername. Everything that STT sets up by itself stays within that stt\ folder. When stt is installed correctly, the installer script will tell you with the words “stt installed. Open a NEW terminal window and type: stt --help”
Open a new cmd or powershell, and simply run the command ‘stt gui’. It will open the user interface in a new window, which is probably easier to use. I find that when I was on Windows I preferred user interfaces, and on Linux I prefer command-line tools lol.
The first time you actually start transcribing or translating a video, stt will automatically download the models. This happens automatically, you just have to wait. But it means the first transcription will take a bit more time to finish.
If you ever want to uninstall stt from your computer, run this in PowerShell:
# Windows (PowerShell) [Environment]::SetEnvironmentVariable("Path", $env:Path.Replace("$HOME\stt\.venv\Scripts", ""), "User") Remove-Item -Recurse -Force $HOME\sttffmpeg, yt-dlp and pandoc are pretty nice tools to have on any computer. ffmpeg can convert and compress any video file. yt-dlp allows you to download videos from any website by just running ‘yt-dlp https://link.com/’ in the CMD, and pandoc can convert any text format to any other text format, so you can convert . So they are dependencies, but they are generally good tools to have. Python as well is pretty nice to have as a lot of open-source software uses python. You only install it once then most open-source software is available to you.
deleted by creator
Why not WSL?
wsl --installI can’t recall if there’s any set-up besides this, but I think that using WSL is better than rawdogging EXEs in Windows.
That’s actually very smart, for people who aren’t afraid of using WSL. Then you would just
sudo apt installthe dependencies (and I assume since it’s an ubuntu subsystem it already has python 3.12), and then run the installer for Linux through WSL:curl -fsSL https://codeberg.org/CritBase111/speech-to-text/raw/branch/main/install.sh | bashI also heard that your C:\ drive mounts in the WSL through /mnt/c/, so you can pass any audio file to stt by simply specifiying ‘stt transcribe “/mnt/c/Documents/my_video.mp4”’
but I assume you will have to run stt through the WSL cli from then on?
Yes it would be the CLI. Thing is that it’s simpler since the Linux filesystem gets exposed in the File Manager (it’s literally a “Linux” tab next to “This computer”)
So, you can just drag and drop a file from the Videos folder in Windows into Linux and vice-versa.
So you could drag the video into Linux, run
stt transcribe /home/user/my_video.mp4and then grab it back to Windows Videos folder (or just use the Linux folder since it’s treated as a regular directory by Windows)It’s easier for a beginner than messing with mounting and
mv. It’s what I do in my work computer whenever I need to do something with yt-dlp.It’s very, very convenient. I wonder if WSL is the reason why winget was abandoned