shithub: treason

ref: db8bb1cf65a89e025244786c70ba5fc76d9e3fc3
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 (baseline only), 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

Install [git9](https://github.com/oridb/git9), then:

	cd /tmp
	git/clone https://git.sr.ht/~ft/dav1d
	git/clone https://git.sr.ht/~ft/faad2
	git/clone https://git.sr.ht/~ft/h264bsd
	git/clone https://git.sr.ht/~ft/libvpx
	git/clone https://git.sr.ht/~ft/mcfs
	git/clone https://git.sr.ht/~ft/treason
	cd libvpx && mk
	cd ../dav1d/src && mk
	cd ../../h264bsd/src && mk install
	cd ../../treason && mk install
	cd ../mcfs && mk install
	cd ../faad2/libfaad && mk install && cd ../frontend && mk install

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.
VP8/VP9 might be a good alternative.

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

## Contact

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