sc0ttj / vlc-gtk

Tiny, lightweight frontend for VLC

VLC-GTK

Description

This is a lightweight frontend GUI for VLC, which uses gtkdialog to render the GUI, designed for Puppy Linux.

This program is just a set of shell scripts, and contains no binaries.

If you don't have the (large) Qt-based VLC GUI, this is a tiny alternative GUI, which you may find useful.

Only been tested on Puppy Linux. It may not work on other distros.

Dependencies:

• gtkdialog >= 0.8.4
• vlc
• Xdialog
• xdotool
• rtmpdump (optional)
• sopcast(optional)

Note, sopcast and rtmpdump are required for some online streams.

Screenshot

Main menu

During video playback

Features:

• Supports playback and download video from youtube URLs
• Supports transcoding/converting, DVD ripping, etc
• Supports screen capture to file,
• Supports batch file conversion
• Supports multiple instances, non-root users, etc
• Open File, Dir, Playlist, DVD, VCD, Audio CD or online streams
• On-screen controls for video playback (screenshot in next post)
• Save dir as playlist (audio, video or both)
• Play and manage your favourite internet streams
• Set default playback device for CDs and DVDs
• Supports auto and file subtitles, and sub delay
• Plays online TV from CNN, FOX, MSNBC, ABC, Al Jazeera, RT News, SopCasts, more
• Change crop, aspect ratio and video output module settings
• Change the default OSD and subtitles display settings
• Store player settings and favourite streams in $HOME/.vlc-gtk
• Adds ROX right click options for VLC
• Show all commands sent to vlc in a popup window, using --debug (for testing)
• Supports the command line interface - set options before startup
  • type vlc-gtk --help in the terminal for all command-line options:

  VLC-GTK 2.8.1: a lightweight VLC GUI frontend

  Usage: vlc-gtk [OPTION(S)]

  NOTE: The 1st option given must be a file, dir or URL for playback to start
  immediately. You can force immediate playback with the --play option.

  Options:

  [FILE/URL]              Start playback of FILE or URL, if no other options
  -o|--open "file"        Set a file to play
  --play                  Start playback immediately
  -d|--dir "dir"          Set a directory to play
  -u|--url "url"          Choose the URL/stream to play
  --fave                  Save stream to favourites
  --subs "file"           Choose the subtitles file to load
  --subs-delay <integer>  The number of seconds to delay
  -r|--random             Shuffle files during playback
  --loop                  Loop through all files repeatedly
  --play-stop             Stop playback after each file completes
  --audio                 Enable audio playback
  --vol <integer>         Set the volume level (0...1024)
  --dolby <string>        Enable dolby surround (Auto, On, Off)
  --equalizer <string>    Equalizer preset (classical, club, dance, fullbass,
                          fullbasstreble, fulltreble, headphones, largehall,
                          live, party, pop, reggae, rock, ska, soft, techno)
  --mute                  Disable audio playback
  -fs|--fullscreen        Load the video file in fullscreen
  --no-overlay            Disable overlay video output
  --on-top                Show the video window above all other apps
  --crop <string>         Crop video image (16:10, 16:9, 1:1, 221:100, 4:3, 5:4)
  --aspect <string>       Set the video aspect ratio (16:10, 16:9, 1:1, 221:100,
                          4:3, 5:4)
  --vout                  Video output (XVideo, X11, SDL, GLX, SVGAlib)
  --window                Load the video file in window
  --ffmpeg-fast           Speed up hacks for faster playback (may cause errors)
  --no-osd                Disable the on screen display
  --osd-size <string>     OSD font size (Default, Smaller, Small, Large, Larger)
  --tab                   Choose the tab to show at startup (0,1,2,3)
  --debug                 View all commands sent to vlc in a popup window
  --logfile "file"        The file to which VLC write its messages, errors, etc.
  -v|--version            Show the version number of this app
  -h|--help               Show this help message

  Examples:

  vlc-gtk "/path/to/film.avi"
  vlc-gtk --open "/film.avi" --subs "/subs.srt" --fullscreen --play
  vlc-gtk -fs -d "${HOME}/tv-series/" -r

  Requirements: gtkdialog4, xdialog, VLC 0.8.6 or higher

Releases:

PET packages for Puppy Linux:

• vlc-gtk-2.8.1 (requires at least VLC 2.2.x)
• vlc-gtk-2.8.0 (requires VLC 2.1.x or older)
• vlc-gtk-2.7.0 (requires VLC 2.1.x or older)

Notes:

• For VLC 2.2.x and newer you must use VLC-GTK 2.8.1 or newer.
• For older VLCs, use VLC-GTK 2.8.0 or older.

Building your own package

In Puppy Linux, run the following command from the root dir of this repo:

dir2pet vlc-gtk-2.8.1-noarch

This will build the PET package for you.

Changelog

2.8.1:

• updated for use with VLC 2.2.x
• fixes in recording streams
• fixes in recording fave streams to file (set the codecs etc in streams tab, click rec button next to faves list)
• fixes in popup GUI for audio and streams
• font/GUI alignment fixes
• many radio streams still work.. but..
• BUG: the TV streams all need updating.. don't use them, find new ones!
• BUG: recording fave streams might need to be killed in htop (or whatever)!

2.8.0:

• improved OSC: combined the Audio Playlist and on-screen GUIs into one single OSC GUI
• fixes in ordering items in playlist
• fixed resizing items in playlist GUI tree
• fixes in resize stream list in OSC for high resolutions
• fixed hide playlist GUI for radio streams
• updated resize_playback to allow for larger GUI below video
• added resize_playback to playlist GUI, if playing video
• added 'Stream Info' button next to Fave Streams list

Contributing:

1. Fork this repo.

2. Then pull down the code:

git clone https://github.com/<username>/vlc-gtk
cd vlc-gtk

2. Edit some files.

3. Rebuild the PET package (see Building your own package above)

4. Install the package (click on it or run petget <package>.pet).

5. Test out your changes.

6. Share your changes:

Push your changes to your fork:

git checkout -b "mybranch"
git add .
git commit -m "some message"
git push -u origin mybranch

Then open a Pull Request.