Tileplayer

A simpler multi-video file and stream player based on GStreamer

Notice

This is a personal project under development. Bug reports and feature requests are appriciated.

Installation

Prerequisites

1. GStreamer 1.x
2. Python 3.x

python3 -m pip install git+https://github.com/sandstorm12/tileplayer

Usage

Using config file:

# Generate sample config file
tileplayer -g config.yaml
# Run tileplayer using the sample configs
tileplayer -c config.yaml

Directly passing streams:

tileplayer -i [file or stream uri ...]
tileplayer -i file:///path/to/video/file file:///path/to/video/file ...
tileplayer -i rtsp://stream_address rtsp://stream_address ...

Refer to sample config file or help to check available options:

tileplayer -g /tmp/config.yaml | less
tileplayer -h

Sample config

streams:
  -
    # Optional
    text: "FPS=5"
    # Mandatory
    uri: "rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov"
    # Optional
    fps: 5
    # Optional
    text_size: 30
  -
    text: "FPS=10"
    uri: "rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov"
    fps: 10
    text_size: 30

Run using docker image (tested on ubuntu)

Build the docker image:

docker build -f dockerfile_x86 -t tileplayer .

Give desktop environment access for docker to connect:

xhost +

Run docker container:

docker run -it --rm --env="DISPLAY" -v /tmp/.X11-unix:/tmp/.X11-unix tileplayer bash

Run tileplayer sample:

# Generate sample config file
tileplayer -g config.yaml
# Run tileplayer using the sample configs
tileplayer -c config.yaml

Issues and future work

1. Add the protocol, latency, and drop-on-latency config per stream
2. FIX: GStreamer critical error. Pipeline is not in NULL state.
3. Add more interesting grid placement.
4. FIX: Warning: .gobject/gsignal.c:2736: instance A has no handler with id B