Skip to content

Jon1969Edwards/VlcMedia_UnrealEngine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License: Proprietary No Redistribution UE5.4 Supported

📺 VlcMedia Plugin for Unreal Engine [WIP]

This plugin enables Unreal Engine to stream video content using VLC Media Player functionality. Designed for Blueprint-only projects, it includes everything you need to drop in and start playing streaming .m3u8 sources with no source compilation required.


✅ Features

  • Stream .m3u8 and live video URLs in UE 5.4+
  • Auto-play support via included BP_TV Blueprint
  • Packaged plugin — no C++ compilation needed
  • Integrates MediaPlayer, Texture, and Material setup automatically

✅ Supported Platforms & Requirements

The VlcMedia (libVLC) Plugin for Unreal Engine is currently focused on stable Windows x64 support. Additional platforms may be added in the future.

🖥️ Supported Operating Systems Platform Status Notes Windows 10 / Windows 11 (64-bit) ✅ Officially Supported Fully tested in Editor + Packaged builds. Recommended.

macOS ❌ Not Supported No prebuilt libVLC binaries provided; untested.

Linux ⚠️ Not Supported May work with custom libVLC builds, but not tested.

Android ❌ Not Supported Requires separate libVLC integration (not yet implemented).

iOS ❌ Not Supported Unreal + libVLC on iOS requires significant additional work.

🧩 Supported Unreal Engine Versions Unreal Version Status Notes 5.4.4 ✅ Primary Target Latest precompiled release is built for 5.4.4.

5.2.1 ⚠️ Legacy Support Older source tag available but no longer actively developed.

Other UE versions ❌ Unsupported No active builds or testing outside 5.4.4. 🎥 VLC / libVLC Requirements

A 64-bit VLC installation is required on Windows The plugin dynamically loads:

libvlc.dll

libvlccore.dll

If VLC is not installed (or the 32-bit version is installed), Unreal will not be able to initialize the media player.

📦 Distribution Type

Precompiled Plugin (Recommended) Download from Releases → drop into YourProject/Plugins/VlcMedia/.

Source Version (5.2.1 Only) Provided for historical/compatibility reasons; not maintained.

📝 Summary

The current official target configuration is:

Unreal Engine 5.4.4 + Windows 10/11 64-bit + VLC x64 installed

All other platforms are considered untested or unsupported for now.

📦 Installation

  1. Download or clone the plugin into your project's Plugins/ folder:

YourProject/

└── Plugins/

└── VlcMedia/

  1. The directory should look like this after packaging:

Plugins/ └── VlcMedia/

├── Binaries/

├── Config/

├── Content/

│ ├── BP_TV.uasset

│ ├── YourMediaAssets...

├── Resources/

├── VlcMedia.uplugin

└── README.md

  1. Open or restart your Unreal project.
  2. Enable the plugin if it is not already auto-loaded.
  3. Done! Ready to drag and drop the TV Blueprint into the world.

Note: No need to build or compile C++ modules. This is a precompiled, packaged plugin.


🧠 Setup Guide

This setup follows this tutorial from Timo Helmers for Blueprint-based media playback using streaming URLs.

1. Included Blueprint: BP_TV

Drag the BP_TV Blueprint into your level. It auto-plays video on BeginPlay using an index from a predefined Media Source array.

🔧 To customize:

  • Open BP_TV
  • Replace the default entries in the ChannelList array with your own Stream Media Source assets.
  • Adjust the ChannelIndex integer variable to select which one auto-plays.

2. Blueprint Logic

The following Blueprint handles media loading and playback:

TV Blueprint


📌 Notes

  • If playback fails, check that:

  • Your .m3u8 or stream URL is public and working

  • VLC is installed and supported (used under-the-hood)

  • Media Source is properly assigned

  • StreamMediaSources used in Blueprints must be stored in the main Content/ folder (not inside the plugin) unless manually linked.


🧪 Example Streams (For Testing)

Use any of these publicly accessible streams:

⚠️ Some streams may block cross-origin requests. Use trusted sources for production.

Documentation

Wiki documentation

Support

Credits

  • Developed by Jon Edwards

  • Special thanks to Charles (age 9) for testing + feature ideas 🎮

  • Uses VLC backend via VideoLAN / libVLC

  • Buy Me a Beer at ko-fi.com

About

VLC Media Plugin for Unreal Engine 5.4.4

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors