ijod

README

Ijod

Ijod is a quick-to-setup web app, to easily watch videos at the same time, over multiple hosts.

How to use?

All you need is the ijod binary, and a directory with videos. Then run

./ijod

and a server should start listening on port 8080, on all IP addresses. No output should be generated, unless something has gone wrong.

Configuration Options

The above example should cover most use-cases, but if not, Ijod can be configured to act differently with a few extra flags.

These are:

• -addr: on what port to listen on.

  The default value is :8080, meaning on every address, on port 8080, but localhost:80 would mean locally on port 80.

• -auth: require a basic auth password.

  The argument MUST contain a colon (:) that separates the username-part from the password.

• -words: path to a file with words that will be used for names.

  To disable names, point to /dev/null, otherwise it will attempt to use /usr/share/dict/words.

• -debug: print debugging information on stdout.

How to install?

Building Ijod requires Go to be installed, as well as go-bindata.

When everything has been installed, run

go generate
go build

and ijod should appear in the working directory.

Further Notes

• Ijod has been tested with Firefox (primarily) and Chromium (secondarily).

• If the generated binary size is too large, using tools like strip -a or UPX might help to reduce the file size.

• Since the video-files are streamed directly from your file system, it might be necessary to prepare them.

  For most formats, running

    ffmpeg -i file.mp4 -c:v copy -c:a copy -movflags +faststart new-file.mp4
  

  with FFmpeg should suffice to quickly create a streamable file. If not, consider converting it to the WebM format using:

    ffmpeg -i file.mp4 -c:v libvpx-vp9 -c:a libopus -crf 23 -movflags +faststart file.webm
  

• Tools like youtube-dl should automatically produce files fit for streaming.

• Ijod is inspired and conceptually based on an older project of mine, called Doji.

• If any issues or questions come up, send an email to my public inbox.

Legal

Ijod is distributed under CC0 Universal Public Domain Dedication (CC0 1.0).