███████╗██████╗ ██╗      █████╗ ██╗   ██╗
██╔════╝██╔══██╗██║     ██╔══██╗╚██╗ ██╔╝
█████╗  ██████╔╝██║     ███████║ ╚████╔╝ 
██╔══╝  ██╔═══╝ ██║     ██╔══██║  ╚██╔╝  
██║     ██║     ███████╗██║  ██║   ██║   
╚═╝     ╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝   

fplay is a command-line tool for searching and watching videos from VK Video directly in your terminal. No browser, no GUI — just search, select, and watch in mpv.

• OS: Linux (only)
• Python: 3.13+
• Package manager: uv
• Player: mpv

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your shell or run source $HOME/.local/bin/env after installation.

git clone https://github.com/xedc1oud/fplay.git
cd fplay

uv tool install .

cd fplay
git pull
uv tool install . --reinstall

fplay <query>

Searches VK Video, shows up to 5 results in a curses menu, and opens the selected video in mpv fullscreen.

fplay зверополис
fplay "как приручить дракона"
fplay inception

fplay

If no query is provided, fplay will prompt for one.

 [>] fplay — use arrows to navigate, enter to play, q to quit
─────────────────────────────────────────────────────────────
 [>] 1. Зверополис | Zootopia (2016)               [1:48:12]
 [ ] 2. Зверополис (полный фильм)                  [1:47:51]
 [ ] 3. Зверополис — Русский трейлер               [0:02:13]
 [ ] 4. Зверополис 4K HDR                          [1:48:48]
 [ ] 5. Зверополис (2016) BDRip 1080p              [1:48:12]
─────────────────────────────────────────────────────────────

Controls:

Sometimes VK blocks the connection mid-search. This is normal — fplay will automatically retry until it gets through. You might see this in the terminal:

[?] Searching: inception
[!] Retrying...
[*] Found 5 results, fetching info...

[!] Retrying... means VK dropped the connection. Just wait a few seconds — fplay handles it automatically, no action needed on your end.

uv tool uninstall fplay

Pull requests are welcome. For major changes, open an issue first to discuss what you'd like to change.