ofxVlc4Player

Inspired by ofxVLCVideoPlayer.

ofxVlc4Player binds libVLC 4 for openFrameworks.

Installing libVLC

The addon ships with helper scripts that download libVLC into the addon-local libs/libvlc layout.

Windows

Run:

scripts\install-libvlc.ps1

Or:

powershell -ExecutionPolicy Bypass -File scripts\install-libvlc.ps1

What it does:

• Downloads the latest VLC nightly runtime from VideoLAN.
• Downloads public libVLC headers from the VLC master branch.
• Installs headers into libs/libvlc/include.
• Installs libvlc.lib into libs/libvlc/lib/vs.
• Copies libvlc.dll, libvlccore.dll, plugins, and lua into each example bin folder.

The installer uses a temporary directory outside the addon tree while downloading and extracting archives, which helps avoid filesystem issues when the addon lives in a OneDrive-synced folder.

Linux / WSL

Run:

bash scripts/install-libvlc.sh

This wrapper calls the same PowerShell installer, so it is mainly useful from WSL or Git Bash on Windows.

Native Linux (Ubuntu)

Install VLC 4 and libVLC development files:

sudo add-apt-repository ppa:videolan/master-daily
sudo apt-get update
sudo apt-get install vlc libvlc-dev

The addon links against libvlc through pkg-config on Linux.

Linux with Nvidia GPU

You may also need the Nvidia VA-API driver:

• nvidia-vaapi-driver

Example environment setup:

export LIBVA_DRIVER_NAME=nvidia

Example dependencies

The example app also depends on:

• ofxProjectM
• ofxImGui, and it must be checked out on the develop branch

Example:

git clone --branch develop https://github.com/jvcleave/ofxImGui.git

Recommended projectM assets

For the ofxProjectM-powered parts of the example, these packs are recommended:

• presets-cream-of-the-crop
• presets-milkdrop-texture-pack

Place them like this:

• Presets from presets-cream-of-the-crop go in the presets folder.
• Textures from presets-milkdrop-texture-pack go in the textures folder.