Pause Click plugin for VLC

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

Can be configured to work nicely with double-click-to-fullscreen by enabling "Prevent pause/play from triggering on double click" option in the settings. By default it pauses on every click instead.

Table of contents

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

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.

There is an experimental support for the nightly, in-development version of VLC (VLC 4.0). The development version of VLC often breaks both API and ABI, which can result in the plugin failing to build and the plugin built for nightly VLC of today be non-functional in newer nightly VLC builds. Due to this, the support for nightly VLC is very limited and low-priority. The plugin is not guaranteed to work correctly with it, or even work at all. If the plugin breaks to build against newer nightly VLC versions, it might not get fixed for quite some time. It's also quite possible that nightly VLC could have its own bugs that prevent the plugin from working that are out of my control to fix.

Install

Windows

Download an appropriate archive:

For the nightly VLC 4.0 see the nightly builds.

Extract the archive at {VLC}\plugins\video_filter\, where {VLC} is the directory the VLC was installed into. By default, the 32-bit VLC installs into C:\Program Files (x86)\VideoLAN\VLC\ and the 64-bit one into C:\Program Files\VideoLAN\VLC\.

Then follow the usage instructions below on how to enable the plugin.

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

macOS

Download an appropriate archive:

For the nightly VLC 4.0 see the nightly builds.

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

Then follow the usage instructions below on how to enable the plugin.

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

Linux

Note that Snap versions of VLC are not supported. Not supported in a sense that I haven't figured out how to build the plugin such that it would be ABI compatible with the Snap VLC and how to make the Snap VLC load the plugin. If someone could figure that out and contribute their findings - that would be very helpful. This Snap VLC discussion might be useful.

Debian

Get required libraries and tools:

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

Get the latest release of the plugin:

sudo apt-get install git
git clone https://github.com/nurupo/vlc-pause-click-plugin
cd vlc-pause-click-plugin
git checkout \
  "$(git tag --list | grep -P '^(\d+).(\d+).(\d+)$' | \
    sed "s/\./ /g" | \
    sort -snk3,3 | sort -snk2,2 | sort -snk1,1 | \
    tail -n 1 | \
    sed 's/ /\./g')"

(Or alternatively download the latest release's tarball, extract it and cd into it)

Build and install:

make
sudo make install

Then follow the usage instructions below on how to enable the plugin.

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

Arch Linux

There is 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 the plugin with a checkbox: (in advanced preferences) Interface -> Control Interfaces -> Pause/Play video on mouse click [screenshot]
4. Enable 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 the 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 bitness. 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.
• Some users have reported that they had to re-install VLC and select "Delete preferences and cache" in the installer for the plugin to work.

If the issue persists, open an Issue in this repository and I will try to help.

Green video image

It has been reported that in some configurations (Windows + d3d11 hardware-accelerated decoding + Nvidia graphics) the plugin causes the video image to turn green when playing certain video formats.

There are several possible workarounds:

• Disable hardware-accelerated decoding.

  You can do so in: Tools -> Preferences -> (Simple) -> Input / Codecs -> Hardware-accelerated decoding

• Enable filters with "D3D11" in their name: Tools -> Preferences -> (All) -> Video -> Filters

  Note that this results in x2 GPU usage.

• If you have Intel integrated graphics, you could try making VLC use that for its hardware-accelerated decoding.

License

LGPLv2.1+