Skip to content

xedc1oud/fplay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•—      β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—
β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β•šβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•”β•
β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘ β•šβ–ˆβ–ˆβ–ˆβ–ˆβ•”β• 
β–ˆβ–ˆβ•”β•β•β•  β–ˆβ–ˆβ•”β•β•β•β• β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘  β•šβ–ˆβ–ˆβ•”β•  
β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   
β•šβ•β•     β•šβ•β•     β•šβ•β•β•β•β•β•β•β•šβ•β•  β•šβ•β•   β•šβ•β•   

A terminal-based video player for VK Video

Linux Python uv License


What is fplay?

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.


Requirements

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

Installation

1. Install uv (if not already installed)

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

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

2. Clone the repository

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

3. Build and install

uv tool install .

Updating

cd fplay
git pull
uv tool install . --reinstall

Usage

Search and watch

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

Interactive prompt

fplay

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


Interface

 [>] 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:

Key Action
↑ / ↓ Navigate results
Enter Play selected video in mpv
q Quit

Notes

VK rate limiting

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.


Quick Reference

Command Description
fplay Launch with interactive prompt
fplay <query> Search and pick a video
fplay --help Show help

Uninstall

uv tool uninstall fplay

Contributing

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


Made for Linux. Runs in a terminal. Does its job.

suck VK πŸ–•

About

A terminal-based video player for VK Video (suck VK πŸ–•)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages