about summary refs log tree commit diff stats
path: root/libmpv2/README.md
diff options
context:
space:
mode:
authorBenedikt Peetz <benedikt.peetz@b-peetz.de>2024-08-21 10:49:23 +0200
committerBenedikt Peetz <benedikt.peetz@b-peetz.de>2024-08-21 11:28:43 +0200
commit1debeb77f7986de1b659dcfdc442de6415e1d9f5 (patch)
tree4df3e7c3f6a2d1ec116e4088c5ace7f143a8b05f /libmpv2/README.md
downloadyt-1debeb77f7986de1b659dcfdc442de6415e1d9f5.tar.gz
yt-1debeb77f7986de1b659dcfdc442de6415e1d9f5.zip
chore: Initial Commit
This repository was migrated out of my nixos-config.
Diffstat (limited to '')
-rw-r--r--libmpv2/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/libmpv2/README.md b/libmpv2/README.md
new file mode 100644
index 0000000..7f77b16
--- /dev/null
+++ b/libmpv2/README.md
@@ -0,0 +1,35 @@
+<!--
+yt - A fully featured command line YouTube client
+
+Copyright (C) 2024 Benedikt Peetz <benedikt.peetz@b-peetz.de>
+SPDX-License-Identifier: GPL-3.0-or-later
+
+This file is part of Yt.
+
+You should have received a copy of the License along with this program.
+If not, see <https://www.gnu.org/licenses/gpl-3.0.txt>.
+-->
+
+Credits go to @anlumo for the rendering implementation and @sirno for updating the API to support libmpv version 2.0.
+
+# libmpv2-rs
+
+A libmpv abstraction written in rust that's easy to use and provides the ability to read next to all video and audio codecs.
+
+# Dependencies
+
+Rust version >= 1.30. Libmpv version 2.0 (mpv version 0.35.0) is the minimum required version.
+
+For ease of building, you can use the `build_libmpv` feature that is used to link against. Especially useful to cross compile to windows. The `MPV_SOURCE` environment variable needs to be set to a directory containing the mpv source you want to build against. For windows targets this is expected to be already built, with a directory named `MPV_SOURCE/64` or `/32` containing [build artifacts](https://mpv.srsfckn.biz/) for 64-bit and 32-bit targets respectively. On unix this is expected to be a copy of the mpv-build repo.
+
+# Examples
+
+To run an example, execute `cargo run [--release] --example x -- test-data/jellyfish.mp4`, where x is any of:
+
+- `events`: event enumeration
+- `protocol`: implementation of custom `filereader://` protocol that… reads files
+- `opengl`: openGL rendering onto SDL2 window
+
+# Contributing
+
+All pull requests/issues welcome.