Skip to main content

This package allows handling of .cine files created by Vision Research Phantom® cameras.

Project description


PyPI version GitHub license Code style: black Codacy Badge

Reading Vision Research .cine files with python


Release Version

With pip

If you have Python 3 installed you can just use pip:

pip3 install -U pycine

Development version

pip install git+

Example usage

Changing the playback and timecode framerates

pfs_meta set --playback-fps 60/1.001 --timecode_fps 60/1.001 A001C001_190302_16001.cine

You can also set metadata for multiple clips at once:

pfs_meta set --playback-fps 24/1.001 --timecode_fps 24/1.001 *.cine


Every command has its own help output. Just append --help:

$ pfs_meta --help
Usage: pfs_meta [OPTIONS] COMMAND [ARGS]...

  This tool allows .cine file metadata manipulation. Use COMMAND --help for
  more info.

  --help  Show this message and exit.

  copy  Copy metadata from a source clip
  set   Set metadata
  show  Show metadata
$ pfs_meta set --help
Usage: pfs_meta set [OPTIONS] [DESTINATIONS]...

  Set metadata

  --temp FLOAT          Set color temperature.
  --cc FLOAT            Set color correction.
  --record-fps INTEGER  Set record FPS.
  --playback-fps TEXT   Set playback FPS. Use 60 or 60/1.001 but not 59.94
  --timecode-fps TEXT   Set timecode FPS. Use 60 or 60/1.001 but not 59.94
  --tone TEXT           Set tone curve in the form of "[LABEL] x1 y1 x2 y2".
                        You can set up to 32 xy points.
  --help                Show this message and exit.
$ pfs_raw --help

  --file-format [.png|.jpg|.tif]
  --start-frame INTEGER
  --count INTEGER
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Jupyter notebook

Check out an example on how to use the library from a jupyter notebook: notebooks/Display frames.ipynb

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pycine-0.3.2-py3-none-any.whl (24.2 kB view hashes)

Uploaded py3

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