netflix-open-content-helper 0.2.0

CLI for working with Netflix Open Content resources.

Netflix Open Content Helper

A command-line utility for downloading test frames from Netflix Open Content.

This is the readme for developers. The documentation for users is available here: https://jdmacleod.github.io/netflix-open-content-helper/

Prerequisites

You will need the AWS CLI installed and available in $PATH to download frame content. No AWS account is needed however, as we use -no-sign-request when downloading files.

Quickstart

Install using pip or pipx.

$ pip install netflix-open-content-helper

or

$ pipx install netflix-open-content-helper

This will provide the command-line utility noc.

Using noc with Netflix Open Content

Download the first frame of Sparks to the current directory.

$ noc download sparks
Downloading: sparks frames 1-1
Downloading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:11

List the available Netflix Open Content Assets with frame content.

$ noc list
Available content with frames:
- chimera             : Live action footage, 4K. Download configured for the 23.98fps frame rate version. TIFF files.
- cosmoslaundromat    : Animated short film done in Blender, 2K 24p. EXR files.
- meridian            : Live action noir UHD short, 59.94fps. Mastered in Dolby Vision HDR. TIFF files.
- sparks              : Live action 4K HDR test short, 59.94fps, finished at 4000 nits. ACES EXR files.

Open a new web browser window to the Netflix Open Content URL.

$ noc browse
... (web browser opens)

Get a list of Shots from a file (CSV, JSON, or YAML).

$ noc get shotlist.yaml
Getting Shots...  [------------------------------------]    0%Downloading: sparks frames 5000-5001
Downloading Frames... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:23
Getting Shots...  [####################################]  100%

See the user documentation for more examples.

Developer Setup

Clone this repository (or fork on GitHub).

In the local repository directory, set up for Python development. The steps below show Astral's uv in use - but using Python venv is also fine.

# Create and activate Python virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install development dependencies with the project set as editable
uv pip install -e ".[dev]"

# Install Git pre-commit hooks
pre-commit install

Create a feature branch and make changes. See TESTS.md for details on running this product's tests.

Contributing

Contributions to improve this utility are welcome! Please submit issues and pull requests on GitHub.

License

This code is MIT licensed. See the LICENSE file for details.

Credits

Created and maintained by Jason MacLeod.

Reference

See REFERENCE.md for details on how this project is set up, including more developer details.

Made using Marc Goodner's Python Template