Skip to main content

live_thumb

Live thumbnail using MJPEG and nginx_push_stream.

Usage

Compile Nginx with nginx_push_stream support. The example config also uses lua-nginx-module and lua-resty-redis to store and serve old snapshots from Redis, but this module is optional. The Nginx configuration should be something like this:

$ LUAJIT_LIB=/usr/local/lib/ LUAJIT_INC=/usr/local/include/luajit-2.0 ./configure --add-module=../nginx-push-stream-module --add-module=../lua-nginx-module --with-pcre --with-ipv6 --with-ld-opt=-L/usr/local/lib

Now run Nginx with sample config:

$ nginx -c $PWD/nginx.conf

Make a directory to store the thumbs

$ mkdir -p frames/parts

Start ffmpeg to create thumbs for a channel (parts in this example):

$ ffmpeg -re -i rtmp://example.com/live/stream -vf "scale=159:-1" -r 3 frames/parts/thumb%9d.jpg

Run the broadcaster:

$ python broadcaster.py

If you prefer, install the script using pip and run it:

$ pip install live_thumb
$ broadcaster

Watch the movie with the example html:

$ open test.html

Or go to http://localhost:9080/sub/parts directly.

To also store the snapshots on redis, you should run the broadcaster with an extra env variable:

$ REDIS_HOST="localhost" REDIS_PORT=7000 python broadcaster.py

The snapshots will be served from http://localhost:9080/snapshot/parts. You can also specify a timestamp: http://localhost:9080/snapshot/parts?timestamp=1396381230

Metadata

Release files for live_thumb 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for live_thumb 0.1.10
File Size Uploaded Provenance Actions
live_thumb-0.1.10.tar.gz 4.6 kB Without provenance Details for live_thumb-0.1.10.tar.gz

Release files / live_thumb-0.1.10.tar.gz

Download URL live_thumb-0.1.10.tar.gz
Size 4.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9da6eaae6f982cc7ba76cff6091940389c13ed780073d8c533e2c16a4c3b6b90
BLAKE2b-256 checksum
How to use checksums
298b0e59bf615b9c0f67e6d2b2d9c037a3c7215bbbb3cb2bcd7e8e68889a9c82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for live_thumb 0.1.10

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page