https://github.com/chimildic/obs-vlc-video-plugin
VLC plugin with Streamlink and hardware acceleration for OBS Studio
https://github.com/chimildic/obs-vlc-video-plugin
libvlc obs obs-studio obs-studio-plugin streamlink vlc windows
Last synced: about 1 month ago
JSON representation
VLC plugin with Streamlink and hardware acceleration for OBS Studio
- Host: GitHub
- URL: https://github.com/chimildic/obs-vlc-video-plugin
- Owner: Chimildic
- Created: 2024-08-20T18:21:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-26T12:41:49.000Z (almost 2 years ago)
- Last Synced: 2024-08-26T14:50:50.079Z (almost 2 years ago)
- Topics: libvlc, obs, obs-studio, obs-studio-plugin, streamlink, vlc, windows
- Language: C
- Homepage:
- Size: 162 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: docs/readme-en.md
- Funding: .github/funding.yml
Awesome Lists containing this project
README
# obs-vlc-video-plugin
Modified VLC-plugin with [Streamlink](https://streamlink.github.io) and hardware acceleration support for OBS Studio.
## Features
- Launch video stream via link to channel by local server from Streamline with additional parameters. Twitch and more.
- Hardware acceleration support (move part of the load to the graphics card).
- Custom UI
## Install
> Save backup of the files before install: `vlc-video.dll`, `vlc-video.pdb`. Default path `C:\Program Files\obs-studio\obs-plugins\64bit`.
1. [Install VLC Player](https://www.videolan.org/vlc/)
2. [Install Streamlink](https://streamlink.github.io/install.html).
3. Download archive in [releases](https://github.com/Chimildic/obs-vlc-video-plugin/releases).
4. Unpack archive to root folder of OBS Studio. Default path `C:\Program Files\obs-studio`.
## Streamlink
Streamlink allows to receive a video stream via link to channel. For example, by link like `https://www.twitch.tv/igorghk` the plugin will create a new process in which to run the local server. It is also possible to use additional parameters: low latency, skip twitch ads, personal token and more.
Use the field `Streamlink options` to fine-tuning. Each parameter starts with `--` and is separated by space. For example `--hls-live-edge 1 --twitch-disable-ads`. See [Streamlink documentation](https://streamlink.github.io/cli.html).
## libVLC
libVLC is library that the plugin uses to communicate with the VLC player. It can also be configured via the `VLC options` field. Their list is in the [documentation](https://wiki.videolan.org/VLC_command-line_help). In particular [parameters for hardware acceleration](https://wiki.videolan.org/Documentation:Modules/avcodec/).
The each option looks like `:key=value` and is separated by space `:avcodec-skip-frame=1 :avcodec-hw=any`.
## Build
The plugin has many dependencies that not provided here. In order to build `.dll` youself, place modified files to [vlc-video](https://github.com/obsproject/obs-studio/tree/master/plugins/vlc-video) folder from OBS Studio repository.
> The `get_free_port` function requires `Ws2_32.lib` dependency. The path for Visual Studio: `Project Properties > Linker > Input > Additional Dependencies`.