Skip to main content

CMX 3600 Edit Decision List Parser

Project description

Build Status Documentation Status

pycmx

The pycmx package provides a basic interface for parsing a CMX 3600 EDL and its most most common variations.

Features

  • The major variations of the CMX 3600: the standard, "File32" and "File128" formats are automatically detected and properly read.
  • Preserves relationship between events and individual edits/clips.
  • Remark or comment fields with common recognized forms are read and available to the client, including clip name and source file data.
  • Symbolically decodes transitions and audio channels.
  • Does not parse or validate timecodes, does not enforce framerates, does not parameterize timecode or framerates in any way. This makes the parser more tolerant of EDLs with mixed rates.
  • Unrecognized lines are accessible on the EditList and Event classes along with the line numbers, to help the client diagnose problems with a list and give the client the ability to extend the package with their own parsing code.

Usage

Opening and Parsing EDL Files

>>> import pycmx
>>> with open("tests/edls/TEST.edl") as f
... 	edl = pycmx.parse_cmx3600(f)
...
>>> edl.title
'DC7 R1_v8.2'

Reading Events and Edits

EditList.events is a generator...

>>> events = list( edl.events )  
>>> len(events)
120
>>> events[43].number 
'044'

...and events contain 1...n edits.

>>> events[43].edits[0].source_in 
'00:00:00:00'
>>> events[43].edits[0].transition.cut
True
>>> events[43].edits[0].record_out
'01:10:21:10'

Acessing Transitions and Enabled Channels

>>> events[41].edits[0].transition.dissolve
False
>>> events[41].edits[1].transition.dissolve
True
>>> events[41].edits[0].clip_name
'TC R1 V1.2 TEMP1 DX M.WAV'
>>> events[41].edits[1].clip_name
'TC R1 V6 TEMP2 M DX.WAV'

              # parsed channel maps are also
              # available to the client
>>> events[2].edits[0].channels.get_audio_channel(7)
True
>>> events[2].edits[0].channels.get_audio_channel(6)
False
>>> for c in events[2].edits[0].channels.channels:
...     print(f"Audio channel {c} is present")
... 
Audio channel 7 is present
>>> events[2].edits[0].channels.video
False

How is this different from python-edl?

There are two important differences between import edl and import pycmx and motivated my development of this module.

  1. The pycmx parser doesn't take timecode or framerates into account, and strictly treats timecodes like opaque values. As far as pycmx is concerend, they're just strings. This was done because in my experience, the frame rate of an EDL is often difficult to precisely determine and often the frame rate of various sources is different from the frame rate of the target track.

    In any event, timecodes in an EDL are a kind of address and are not exactly scalar, they're meant to point to a particular block of video or audio data on a medium and presuming that they refer to a real time, or duration, or are convertible, etc. isn't always safe.

  2. The pycmx parser reads event numbers and keeps track of which EDL rows are meant to happen "at the same time," with two decks. This makes it easier to reconstruct transition A/B clips, and read clip names from such events appropriately.

Should I Use This?

At this time, this is (at best) beta software. I feel like the interface is about where where I'd like it to be but more testing is required.

Contributions are welcome and will make this module production-ready all the faster! Please reach out or file a ticket!

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

pycmx-0.7.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

pycmx-0.7-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file pycmx-0.7.tar.gz.

File metadata

  • Download URL: pycmx-0.7.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for pycmx-0.7.tar.gz
Algorithm Hash digest
SHA256 5adb4f98cb59b533ca9192111ef5f316a9af2599dd7d013657d91e2f06dcff56
MD5 24ec20660635d71225e61fe539ae6750
BLAKE2b-256 c081d2cd55cb404b848ca7b40b1dee0423db5c7b6bbf3da79510907947574381

See more details on using hashes here.

File details

Details for the file pycmx-0.7-py3-none-any.whl.

File metadata

  • Download URL: pycmx-0.7-py3-none-any.whl
  • Upload date:
  • Size: 12.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for pycmx-0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 a0baf5abcfa3a9427a72507ecca081b48176a4022dbdd4a3c78f4b9305d65691
MD5 7868b3f8699b96cb6bd618071de7e4dc
BLAKE2b-256 780ba5f739ece5ddc2ef005689b6680453d3a79fc491f1bb9255f565899431d0

See more details on using hashes here.

Supported by

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