shithub: treason

ref: 60f4589f28583b6d83dde28c70be3b16092d2858
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 files, which are multimedia containers.  Video
formats supported are [AV1](https://en.wikipedia.org/wiki/AV1) and
H.264 (baseline only).  Only 8-bit per component YUV 4:2:0 is
supported atm.  AAC audio is supported (inside and outside of a
container).  OPUS audio is supported outside of a container.

It can play VP8 and VP9, but no support for webm/matroska has been
added yet to mcfs, so treason can only play a VP8/VP9 video stream
muxed as IVF as of now.

*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

## Usage

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

## Gotchas

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

## Contact

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