ngchc / vlc-pause-click-plugin

Plugin for VLC that pauses/plays video on mouse click

Pause Click plugin for VLC

VLC plugin that allows you to pause/play a video by clicking on the video image.

Works nicely with "double-click to fullscreen" too, if you enable this option in the settings.

Table of contents

• Supported versions of VLC
• Install
  • Windows
  • macOS
  • Linux
    • Debian
    • Arch Linux
• Usage
• Troubleshooting

Supported versions of VLC

VLC 2.1, 2.2 and 3.0 are supported.

VLC versions below 2.1 are not supported. However, there is a lua extension that should work with VLC 2.0 and possibly even earlier versions of VLC.

Support for the newer VLC versions will be available as they get released and as I get time to work on it.

Nightly development version of VLC (VLC 4.0) is not officially supported as it hasn't been released yet. The development version of VLC often breaks ABI, making the plugin built for it non-functional in newer VLC builds. Meaning that if I release the plugin targeting VLC 4.0 build that was done today, the plugin might not work with tomorrow's build of VLC 4.0 that you might use. If you feel adventurous, you could try building this plugin for the specific VLC 4.0 revision that you use yourself, it might require some code fixes but shouldn't be very hard if you are familiar with C development.

Install

Windows

Download an appropriate archive:

Version/Bitness	VLC 32 bit	VLC 64 bit
VLC 2.1	Download	Download
VLC 2.2	Download	Download
VLC 3.0	Download	Download

Extract the archive at {VLC}\plugins\video_filter\, where {VLC} is the directory the VLC was installed into, for example C:\Program Files (x86)\VideoLAN\VLC\.

Then follow the usage instructions below.

If you want to build the plugin binary yourself, take a look at the build instructions.

macOS

Download an appropriate archive:

Version/Bitness	VLC 64 bit
VLC 2.1	Download
VLC 2.2	Download
VLC 3.0	Download

Extract the archive at /Applications/VLC.app/Contents/MacOS/plugins/video_filter/

Then follow the usage instructions below.

If you want to build the plugin binary yourself, take a look at the build instructions.

Linux

Debian

Get required libraries and tools:

sudo apt-get install build-essential pkg-config libvlccore-dev libvlc-dev

Build and install:

make
sudo make install

Then follow the usage instructions below.

If these build instructions don't work for you (perhaps you are using a non-Debian-derived Linux distribuion), there are more generic build instructions available.

Arch Linux

There is a vlc-pause-click-plugin package available in the AUR repository.

Usage

1. Restart VLC to load the newly added plugin [screenshot]
2. Go into advanced preferences: Tools -> Preferences -> Show settings -> All [screenshot] [screenshot]
3. Enable/Disable the plugin with a checkbox: (in advanced preferences) Interface -> Control Interfaces -> Pause/Play video on mouse click [screenshot]
4. Enable/Disable the plugin with a checkbox: (in advanced preferences) Video -> Filters -> Pause/Play video on mouse click [screenshot]
5. Change the plugin settings however you like: (in advanced preferences) Video -> Filters -> Pause click [screenshot]
6. Restart VLC for settings to take place [screenshot]
7. Play a video
8. Click on video picture to pause/play the video

Make sure you have checked both of "Pause/Play video on mouse click" checkboxes per #3 and #4! It's a very common mistake to skip one of those.

Troubleshooting

I don't see any plugin-related options described in Usage instructions in my VLC preferences

• Make sure to restart VLC after you have put the plugin .dll (Windows) or .so (Linux) or .dylib (macOS) in the appropriate directory.
• Make sure you have downloaded the appropriate version of the plugin for the VLC you are trying to use it with. Plugin's version and bitness should match the version and bitness of the VLC you are trying to use the plugin with. Plugin's bitness has nothing to do with the operation system bintess. For example, if you use 32-bit VLC, it doesn't matter whether your Windows is 32-bit or 64-bit, you should use 32-bit version of the plugin, because it matches the bitness of the VLC you use.
• Some users have reported that they had to run the VLC executable with --reset-plugins-cache flag once for the plugin to appear in the GUI.

I do see the plugin-related options described in Usage instructions in my VLC preferences, but the plugin still doesn't work

• Double-check that you have followed Usage instructions closely, especially 3rd and 4th points. Look at the screenshots. If the issue persists, open an Issue in this repository and I will try to help.