Vuu-do simple video player
  • C 92.2%
  • Shell 7.8%
Find a file
2026-09-27 14:58:44 +00:00
LICENSE
README.md Update README.md 2026-09-27 14:58:44 +00:00
vsvp-wrapper.sh
vsvp.c
vsvp.desktop Add vsvp.desktop 2026-09-22 19:18:45 +00:00
vsvps

VSVP

NOTE: This is an alpha version, everything works as it should but the embedding of the ffplay window in the GUI is tricky, about one time in ten it will fail to embed and you have to shut it down and re-start, that's really the only bug and i'm still working on it. This and the music player use ffplay exclusively for the backend and has been an interesting experiment in using ffplay like that, as it was never intended to be a backend for anything but instead a utility for testing ffmpeg.

Vuu-do Simple Video Player, no frills, no features, plain interface. Just video.

  • Builds a local video database from ~/Videos automatically on first run.
  • Re-scan function for adding new local videos.
  • Simple seek functions, minute or chapter, or global in fullscreen.
  • 4 different viewing modes.
  • Supports most common video formats.
  • Fullscreen window, opens a new window for Theater mode or Fullscreen.
  • Works with AlsaTune for real-time audio tweaks (if installed).
  • Depends (runtime) : libgtk-3-0, ffmpeg, yad, bash

vsvp

VSVP is built using ffmpeg via ffplay as the backend to play videos, it has simple controls and is easy to use. On first run it creates your video database, which is used to populate the hierarchical collection tree on the left. To use, just highlight a video and hit play. The pause button toggles pause/play. The rescan button scans ~/Videos again to add any new media you may have added. Maximizing the GUI window takes you to quasi-theater-mode, with borders and video menu hidden, with only the titlebar and the control buttons visible.

The "Fullscreen window" button, opens your selected video in a new window instead of the GUI, this is a native ffplay window with keyboard controls only, it has a theater mode if maximized (titlebar only in addition to the user's panel), and if you toggle the "f" key it expands to fullscreen. Some keyboard shortcuts are noted in the tooltip for the fullscreen window button, and the main 3 are noted in the titlebar of the ffplay window. You can also do a seek to anyhwere in the video by right-clicking in the window. Note that keyboard controls only work in the ffplay window, not in the GUI window.

f - toggle fullscreen
p - toggle pause/play
m - toggle mute

q or ESC - quit and close window

left/right arrow - seek ±10s
up/down arrow - seek ±1min
pg up/pg dn - seek ±1 chapter
right-click - seek to cursor position

Some other things to note:

This is built on Daedalus/Bookworm libraries and will not work on newer versions unless you re-compile it or install the older libav libraries alongside your newer ones. Also it contains an X11-specific bit of code in it, and likely will not work on Wayland.

The wrapper also contains a check for a running instance of vsvp and will exit if there is, two instances do not play well together.

If you are playing a video in the GUI and decide to go for the fullscreen window, go ahead and just click it, it will stop the video in the GUI window first. You can however after that, start another video in the GUI if you just really want two videos playing at the same time. At that point it's on you, have not done any extensive testing on the ramifications of playing multiple videos simultaneously.

The initial GUI window is re-sizeable via grab-handles if you just want it a little larger, but make sure you start the video first before working the grab-handles as it will fail to imbed properly if you do it before a video plays.