xTeVe
M3U Proxy and EPG aggregator for Plex DVR and Emby Live TV
Features
Files
- Merge external M3U files
- Merge external XMLTV files (EPG aggregation)
- Automatic M3U and XMLTV update
- M3U and XMLTV export
Channel management
- Filtering streams
- Teleguide timeshift
- Channel mapping
- Channel order
- Channel logos
- Channel categories
Streaming
- Buffer with HLS / M3U8 support
- Re-streaming
- Number of tuners adjustable
- Compatible with Plex / Emby EPG
Downloads
- See releases page
TLS mode
This mode can be enabled by ticking the checkbox in Settings -> General
.
Unless the server's certificate and it's private key already exists in xTeVe config directory, xTeVe will generate a self-signed automatically.
Self-signed certificate will only allow TLS mode to start up but not to actually establish a secure connections. For truly working HTTPS, you should generate a certificate by yourself and also add the CA certificate to the client-side certificate storage (where the web browser, Plex etc. is).
Certificate and it's private key should be placed in xTeVe config directory like so:
/home/username/.xteve/certificates/xteve.crt
/home/username/.xteve/certificates/xteve.key
If the certificate is signed by a certificate authority (CA), it should be the concatenation of the server's certificate, any intermediates, and the CA's certificate.
This will also enable copy to clipboad by clicking the green links at the header. (DVR IP,M3U URL,XEPG URL)
Docker
Supported OS/ARCH:
- linux/amd64
- linux/arm64
- linux/arm/v7
Get an image
Pull from dockerhub:
docker pull senexcrenshaw/xteve:latest
OR build your own image based on Dockerfile from this repository:
git clone https://github.com/SenexCrenshaw/xTeVe.git
cd xTeVe
docker build --tag senexcrenshaw/xteve .
Create a container
docker create \
--tty \
--publish 34400:34400 \
--name xteve \
senexcrenshaw/xteve
With the specific timezone, ip and port:
docker create \
--tty \
--env TZ=Europe/Amsterdam \
--env XTEVE_PORT=12345 \
--publish 192.168.88.218:12345:12345 \
--name xteve \
senexcrenshaw/xteve
Start a container
docker start xteve
Attach to a started container
docker attach xteve
To detach from a container, press Ctrl + C
.
Access web UI
Open http(s)://<ip>:<port>/web/
in browser, for example:
http://192.168.88.218:34400/web/
Stop a running container
docker stop xteve
Build from source code [Go / Golang]
Requirements
- Go (go1.18 or newer)
Dependencies
Build
1. Download source code
git clone https://github.com/senexcrenshaw/xTeVe.git
2. Install dependencies
go mod tidy
Or
go get github.com/avfs/avfs@latest
go get github.com/gorilla/websocket
go get github.com/kardianos/osext
go get github.com/koron/go-ssdp
go get github.com/samber/lo
go get github.com/stretchr/testify
3. Update dependencies (optional)
go get -u ./...
5. Update web files (optional)
If TypeScript files were changed, run:
tsc -p ./ts/tsconfig.json
Then, to embed updated JavaScript files into the source code (src/webUI.go), run it in development mode at least once:
go build xteve.go
xteve -dev
❗ To not to get CreateFile error, do not forget to switch your binary to "regular" mode after runnning with -dev
flag:
xteve -branch main
or xteve -branch beta
4. Build xTeVe
go build xteve.go
Or use convenient cross-compile tool. To build binaries for every OS / architecture pair into ./xteve-build/
folder:
go get github.com/mitchellh/gox
go install github.com/mitchellh/gox
gox -output="./xteve-build/{{.Dir}}_{{.OS}}_{{.Arch}}" ./
Forks
When creating a fork, the xTeVe GitHub account must be changed from the source code or the update function disabled.
xteve.go - Line: 29
var GitHub = GitHubStruct{Branch: "main", User: "senexcrenshaw", Repo: "xTeVe", Update: true}
// Branch: GitHub Branch
// User: GitHub Username
// Repo: GitHub Repository
// Update: Automatic updates from the GitHub repository [true|false]
https://github.com/xteve-project/xTeVe
This is a fork ofDocumentation for setup and configuration is here.