Examples

Examples of using noc to interact with Netflix Open Content media.

Browse

Open a web browser to the Netflix Open Content URL.

noc browse

List

List content with frames (default).

noc list

Output:

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.

List all content (some content does not have frames for download).

noc list --no-only-frames

Output:

Available content:
- 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.
- elfuente            : 4K live action footage.
- meridian            : Live action noir UHD short, 59.94fps. Mastered in Dolby Vision HDR. TIFF files.
- nocturne            : Live action test piece at 120fps. Mastered in Dolby Vision HDR and Dolby Atmos.
- sollevante          : 4K HDR Atmos anime short.
- sparks              : Live action 4K HDR test short, 59.94fps, finished at 4000 nits. ACES EXR files.

Download

Download frames 1-5 from Sparks

noc download sparks -fs 1 -fe 5

Output:

Downloading: sparks frames 1-5
Downloading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:57

Resume or Extend Download

Download frames 1-8 from Sparks

noc download sparks -fs 4 -fe 8

Frames that already exist on disk are skipped by default. Use --force to force re-download and overwrite.

Output:

Downloading: sparks frames 4-8
file SPARKS_ACES_00004.exr exists, skipping. Use --force to overwrite.
file SPARKS_ACES_00005.exr exists, skipping. Use --force to overwrite.
Downloading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:34

Download and Rename

Download frames 21000-21005 from Meridian and rename as 'meridian.%05d.tif'

noc download meridian -fs 21000 -fe 21005 --rename meridian.%05d.tif

Output:

noc download meridian -fs 21000 -fe 21005 --rename meridian.%05d.tif
Downloading: meridian frames 21000-21005
Downloading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:01:12

Download, Rename, and Renumber

Download frames 9911-9963 of Cosmos Laundromat, renaming as COS_002_0045_comp_NFX_v001.%04d.exr, and renumbering to start at frame 1001 rather than 9911.

noc download cosmoslaundromat -fs 9911 -fe 9963 --rename COS_002_0045_comp_NFX_v001.%04d.exr --renumber 1001

Output:

Downloading: cosmoslaundromat frames 9911-9963
Downloading... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:07:03

This example uses Netflix VFX Shot and Version Naming Recommendations to compose the new name.

The example also makes the assumptions that Cosmos Laundromat:

  • is a feature, not an episodic
  • uses scenes, but not sequences
  • the frames represent iteration v001 of VFX comp (composite) work by NFX (Netflix), the vendor.

Shot Fields:

  • showID (COS)
  • episode (n/a)
  • seq (not used)
  • scene (002)
  • shotID# (0045)

Version Fields:

  • task (comp)
  • vendorID (NFX)
  • version# (v001)

Get

get accepts a list of Shots for download in a text file; CSV, JSON, and YAML formats are supported.

noc get one_shot.yaml

Output:

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

Each of the examples below represents a single-Shot list, composed of frames 5000-5001 of Sparks. In the example, the frames are renamed as "sparks.%04d.exr", and are renumbered starting with 1001. "name" and "renumber" are optional parameters.

CSV Example

project,name,frame_start,frame_end,renumber
sparks,sparks.%04d.exr,5000,5001,1001

JSON Example

[
 {
  "project": "sparks",
  "name": "sparks.%04d.exr",
  "frame_start": 5000,
  "frame_end": 5001,
  "renumber": 1001
 }
]

YAML Example

---
- project: sparks
  name: sparks.%04d.exr
  frame_start: 5000
  frame_end: 5001
  renumber: 1001