Go to file
Pierre Réveillon 1c9c665a7a Merge branch '2-bindgen' into 4-clippy_fmt 2021-11-23 11:33:49 +01:00
examples Fix most clippy errors and warnings, applied rustfmt 2021-11-19 10:02:43 +01:00
libvlc-sys updated bindgen 2021-11-23 11:32:37 +01:00
src fmt second pass 2021-11-22 09:23:46 +01:00
.gitignore Merge remote-tracking branch 'origin/use-bindgen' into 2-bindgen 2021-11-09 22:58:38 +01:00
.gitlab-ci.yml fixed CI image 2021-11-19 10:33:14 +01:00
Cargo.toml fixed repository url 2021-11-19 10:23:03 +01:00
LICENSE Initial commit 2015-11-29 10:26:04 +09:00
README.md Add support for building on Windows 2021-04-13 20:22:58 +02:00
build.rs Adjust rustc-link-lib directive 2021-04-13 21:18:30 +02:00

README.md

vlc-rs Build Status

Rust bindings for libVLC media framework.

Status

Many missing functions and wrappers.

Use

Please add the following dependencies to your Cargo.toml.

[dependencies]
vlc-rs = "0.3"

Or:

[dependencies.vlc-rs]
git = "https://github.com/garkimasera/vlc-rs.git"

Example

Play for 10 seconds from a media file.

extern crate vlc;
use vlc::{Instance, Media, MediaPlayer};
use std::thread;

fn main() {
    // Create an instance
    let instance = Instance::new().unwrap();
    // Create a media from a file
    let md = Media::new_path(&instance, "path_to_a_media_file.ogg").unwrap();
    // Create a media player
    let mdp = MediaPlayer::new(&instance).unwrap();
    mdp.set_media(&md);

    // Start playing
    mdp.play().unwrap();

    // Wait for 10 seconds
    thread::sleep(::std::time::Duration::from_secs(10));
}

Other examples are in the examples directory.

Building

Windows

To build vlc-rs, you must either build VLC from source or grab one of the pre-built packages from videolan.org.

If you're building for x86_64, then you should grab the download labelled "Installer for 64bit version". That installer is actually a self-extracting ZIP archive, so we can extract the contents without installing VLC itself.

If you're building for x86, then you should either download labelled "7zip package" or the one labelled "Zip package".

Once you've downloaded your chosen package, you should extract it some place such that its path contains no spaces. To point vlc-rs at your VLC package, you should set an appropriate environment variable:

  • VLC_LIB_DIR: Directory of the VLC pacakge, any architecture
  • VLC_LIB_DIR_X86 : Directory of the VLC pacakge, x86-only
  • VLC_LIB_DIR_X86_64 : Directory of the VLC pacakge, x86_64-only

You should also add the package to your PATH variable if you intend to run the program. For distribution of an executable program, you should probably copy over the neccessary DLLs, as well as the plugins directory.

License

MIT (Examples are licensed under CC0)