ru.vodka API · Open ru.vodka

Download all songs from the command line

The script downloads MP3 files one at a time, from the newest song to the first. Run it directly in the folder where you want to save the music. If your internet connection or terminal window stops, simply run the same command again: completed files with the correct size will be skipped.

128 kbps739 tracks
2.36 GB
320 kbps739 tracks
5.46 GB

Windows: step-by-step guide

  1. Create or open the folder where you want to save the MP3 files. Complete every step below inside this folder. You can use your Music folder or any folder on another drive.
  2. Open a terminal in this folder. In File Explorer, click the folder path at the top, type powershell, then press Enter. This works in Windows 8, 8.1, 10 and 11. If a normal black window showing C:\...> opens instead, that is also fine: the commands below work there too.
  3. Make sure the correct folder is open. To the left of the > sign, you should see the path to your chosen folder, for example C:\Users\Win Pro\Music\ru-vodka>. This means MP3 files will be saved there.
  4. Choose the yellow quality panel below. Copy one whole command, paste it into the window and press Enter. It downloads the script and begins downloading songs immediately.
If opening PowerShell from the path bar does not work
In Windows 11: right-click an empty area of the folder and choose Open in Terminal.
In Windows 8 / 8.1: in File Explorer choose File - Open Windows PowerShell. A normal cmd window works too.
Need help? Message us on Telegram: @ru_vodka_help

Which songs should be downloaded

Optional: leave both fields empty to download every song. To get only newer songs, enter the number to start from and the number to end at. Downloads always run in reverse order: from the higher number to the lower number. If you enter them the other way around, the script swaps them automatically.

Example: 739
Example: 690
Both fields are empty: the command will download all songs from 739 to 1.

Choose MP3 quality

Open PowerShell, Windows Terminal or a regular black cmd window directly in the folder where you want to save the music. The script puts MP3 files in that current folder. Two source qualities are available: 128 and 320 kbps.

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "$ErrorActionPreference = 'Stop'; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri 'https://ru.vodka/downloads/ru-vodka-download.ps1' -OutFile 'ru-vodka-download.ps1'; & '.\ru-vodka-download.ps1' -Quality 320"

Linux

curl -fsSLo ru-vodka-download.py https://ru.vodka/downloads/ru-vodka-download.py && python3 ru-vodka-download.py --quality 320

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "$ErrorActionPreference = 'Stop'; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri 'https://ru.vodka/downloads/ru-vodka-download.ps1' -OutFile 'ru-vodka-download.ps1'; & '.\ru-vodka-download.ps1' -Quality 128"

Linux

curl -fsSLo ru-vodka-download.py https://ru.vodka/downloads/ru-vodka-download.py && python3 ru-vodka-download.py --quality 128

If downloading stops, run the command from the selected panel again. Files with the correct size will be skipped.

Need help? Message us on Telegram: @ru_vodka_help

How it works

What the script uses

The scripts get a track list from the public API, beginning with the highest track number, and check the size of every completed MP3 before downloading. An unfinished file is written as .part first, then renamed to its final MP3 name after the size check.

Can this script harm my computer?

By design, the script does not need administrator permissions, change Windows or Linux settings, or ask for passwords. It gets a song list from ru.vodka and saves MP3 files only in the folder where you start it. The temporary .part file is used only for an unfinished download.
The PowerShell and Python scripts are openly available below. You can open either one, copy its code into ChatGPT and ask for an explanation of every line - that lets you independently confirm that the script only downloads songs.
API manifest 320 kbps JSON | 128 kbps JSON | PowerShell script | Python script
Need help? Message us on Telegram: @ru_vodka_help