Skip to content

Zhoros/XenStream

Repository files navigation

Xen Stream

Xen Stream is a very lightweight, zero setup video streaming web app with video zoom and configurable subtitle. No login, no transcoding, no confusing settings, just put your videos in a folder and watch right away!

Please star this repo if you find it useful, thank you!

Screenshot 📸

image

Requirements (important) 📌

  1. Video MUST be in .mp4 / .mkv format
  2. Subtitle MUST be in .srt / .vtt format
  3. Most browsers DO NOT support .mkv format. You can convert .mkv to .mp4 with ffmpeg -i input.mkv -c:v libx264 -c:a aac output.mp4
  4. Read Potential issues

How to install (with Docker) 🐋

Simply run docker compose up -d

How to install (without Docker) 💻

  1. npm install
  2. npm run build
  3. npm run start If you have installed and built it before, you can just run it immediately with npm run start

How to use ↓

  1. Place any video inside the videos folder
  2. Place the subtitle (.srt/.vtt) file inside the videos folder, the subtitle file name MUST be in ALL LOWER CASE and match the video name e.g. newvideo.mp4 and newvideo.mkv will load newvideo.srt or newvideo.vtt for it's subtitle
  3. Open the web page, you can now select which video you want to watch from the dropdown menu. Changing subtitle size is also supported

Potential issues ⚠️

Most browser only support x264 for video encoding and AAC for audio. If the video won't play it's either:

  1. Bitrate too high = use lower bitrate videos (nothing more than 1080p), lower the video bitrate with ffmpeg -b:v ... command or just use it locally as a web video player
  2. Incompatible audio/video codec = convert with: ffmpeg -i input.mkv -c:v libx264 -c:a aac output.mp4

About

Xen Stream - lightweight & easy to use video streaming web app with subtitle support & black bars hider

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors