shithub: treason

ref: f1e89731d431981623bc9f9481ec81fd02f0fe25
dir: /README.md/

View raw version
# treason

A video player for 9front.

## Status

[Video one](https://diode.zone/videos/watch/bfcd2004-677d-4878-86cc-e20a4ff7ccf1)

[Video two](https://diode.zone/videos/watch/4f16e664-8701-4125-a62c-9137f3b4a4da)

What can it play?  MP4 and MKV/WEBM files, which are multimedia
containers.  Video formats supported are
[AV1](https://en.wikipedia.org/wiki/AV1), H.264, VP8 and VP9.  Only
8-bit per component YUV 4:2:0 is supported atm.  AAC, OPUS and Vorbis
audio is supported.

*It's only supposed to build and run on AMD64 for now.*

More is coming. Patches are very welcome, too.

## Installing/updating

	cd /tmp
	hget https://git.sr.ht/~ft/treason/archive/mustard.tar.gz | tar xz && \
	mv treason-mustard treason && \
	cd treason && ./install.rc

For opus decoding see [adding opus support to 9front](http://nopenopenope.net/posts/audcomp)
(scroll down on the post).

## Usage

See [how to Youtube on ⑨](http://docs.a-b.xyz/youtube.html).

## Gotchas

This is a half-baked early stage project, there are many things
missing, in need of improvement, and some (probably) are outright
wrong.

You need a fast computer to play AV1.  H.264 doesn't require as much.

If you see random crashes, try running with `NPROC=1`.  Multithreaded
decoding "works on my machine", but who knows.

`mcfs` doesn't know how to remux H.264 video in a MKV container yet,
jfyi.  Why would you put H.264 into MKV anyway, right?

## Contact

Sigrid on [9gridchan](https://ftrv.se/8) or freenode (#cat-v).