Skip to main content

An ISO BMFF emsg atom generator

Project description

emsg

An ISO BMFF emsg atom generator. This cli generates an emsg atom file with any given parameters. You can insert it into an mp4 file by using an mp4 file editor such as Bento4's mp4edit to deliver in-band media timed event data for MPEG-DASH, HLS, and so on.

Installation

$ pip install --upgrade emsg

Usage

$ emsg --help
usage: emsg [-h] [-o OUT] [-s SCHEME_ID_URI] [--box_version {0,1}] [-i ID] [--value VALUE] [-m MESSAGE_DATA]
            [--presentation_time PRESENTATION_TIME] [--presentation_time_delta PRESENTATION_TIME_DELTA]
            [--timescale TIMESCALE] [--event_duration EVENT_DURATION]

options:
  -h, --help            show this help message and exit
  -o OUT, --out OUT     set file name to output (default=./emsg.atom)
  -s SCHEME_ID_URI, --scheme_id_uri SCHEME_ID_URI
                        set scheme id uri to identify the message scheme (default=https://aomedia.org/emsg/ID3)
  --box_version {0,1}   set emsg box version (default=1)
  -i ID, --id ID        set id (default=0)
  --value VALUE         set value for event stream elements (default=1)
  -m MESSAGE_DATA, --message_data MESSAGE_DATA
                        set message data
  --presentation_time PRESENTATION_TIME
                        set presentation time for emsg version 1 (default=450000)
  --presentation_time_delta PRESENTATION_TIME_DELTA
                        set presentation time delta for emsg version 0 (default=450000)
  --timescale TIMESCALE
                        set timescale (default=90000)
  --event_duration EVENT_DURATION
                        set event duration (default=270000)

Examples

To generate an emsg box file named "sample-emsg.atom" containing the metadata below:

  • timescale = 90000
  • presentation time = 270000
  • event duration = 180000
  • id = 0
  • scheme id uri = "urn:mpeg:dash:event:2012"
  • value = "1"
  • message data = "A sample message data"

Run the command below:

$ emsg -o sample-emsg.atom --timescale 90000 --presentation_time 270000 --event_duration 180000 -i 0 -s urn:mpeg:dash:event:2012 --value 1 -m "A sample message data"

Format support

Format Supports
emsg version 0 Y
emsg version 1 Y
ID3 Metadata in emsg (version 1) Y

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emsg-0.0.4.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

emsg-0.0.4-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file emsg-0.0.4.tar.gz.

File metadata

  • Download URL: emsg-0.0.4.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.7.13

File hashes

Hashes for emsg-0.0.4.tar.gz
Algorithm Hash digest
SHA256 3f5eb5fd129c67808bbe0e9f3500f6b8c534c14692f6e7f1ff1057c3f362848a
MD5 0d7b42149d5be3d9d8ce5ee3ec8a725b
BLAKE2b-256 efb2bda7ff2fc2589c21cb908d9ea1a3aba44d089f8893fbdb32c8b0072b12a2

See more details on using hashes here.

File details

Details for the file emsg-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: emsg-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.7.13

File hashes

Hashes for emsg-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f8f65ba02aeaf8983b7bf4e9e5b8baf03e15e8604128cd1ca13516d3b37aa913
MD5 6d87f9017a7cff60ccc0cc3dc3b6e5ae
BLAKE2b-256 4ffd665f2cf1642ce6b9de80120e1927332fe039e6dd20c428689f3e1d769b8d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page