Colori User Guide

User Guide

Get Started

Download

Latest version: 0.9.5
Download for macOS ⬇
Download for Windows ⬇

What's new in 0.9.5

• Beta release

System Requirements

Your computer must meet the following technical specifications to run OCTOPUS Colori.

Windows

Processor	Intel® 6th Generation or newer CPU – or AMD Ryzen™ 1000 Series or newer CPU
OS	Windows 10 (64-bit) V22H2 or later
Memory	8 GB of RAM
GPU	OpenGL 3.2 & OpenCL 1.2 compliant

macOS

Processor	Intel® 6th Generation or newer CPU – or Apple silicon M1 or newer
OS	macOS Monterey (version 12) or later
Memory	8 GB of RAM
GPU	OpenGL 3.2 / OpenCL 1.2 / Apple Metal compliant

Installation

To install OCTOPUS Colori, launch the appropriate (.dmg for macOS or .msi for Windows) installer or container for your OS. On macOS, the .dmg contains the Colori.app which can be simply dragged into the Applications folder.

Application Interface

Colori by default overlays the application interface with a glass style over the current working media clip. To view the clip without any interface obstruction, go to the Zoom control in the top right corner and select Fit to Space. To return to overlay mode, select Fit to Window in the Zoom control.

Hint
You can pan and zoom the current media clip with touch gestures or click & drag the mousewheel/rotate the mousewheel.

Panels

Colori uses expandable and collapsible panels (Media, Color and Publish) to organize the application's functionality. The Media panel shows the project's imported clips. The Color panel shows the currently selected clip's color tools/effects. And the Publish panel is where the project's clips can be chosen for export/publishing. When the working media clip is a video, the playback controls for the clip appear inside the currently active panel.

Organize Media

Projects

Colori reads from and saves to Colori project files (.colori-proj) to store information about imported clips and their currently assigned color tools/effects.

Media Panel

The Media panel shows all the clips in your project. Here you can remove or import new clips, and make batch changes to clips, such as LUT and Gamma. Selecting a clip sets it as the currently working media clip for use in the Color panel.

Hint
You can select multiple clips at once by holding the Control key on Windows or the Command key on macOS.

Hint
To batch copy entire Color tools/effects states, right click a clip and select Copy Correction State. Then select your target clips, right click and select Paste Correction State.

Import clips

Clips can be imported into Colori in several ways:

• By dragging media onto the application area.
• Via the File > Import menu.
• Clicking the + button in the bottom right of the Media panel.

Supported formats

Colori currently supports the following media formats.

Video formats

Apple ProRes	LT Proxy 422 422 HQ 4444 4444 XQ	QuickTime .mov .mp4 .mxf	Decode Encode (PRO subscription)
HEVC	8-bit 4:2:0 10-bit 4:2:0, 4:2:2	QuickTime .mov .mp4 .mxf	Decode Encode (PRO subscription)
H.264	8-bit 4:2:0	QuickTime .mov .mp4 .mxf	Decode Encode

Image formats

PNG	Decode Encode
JPEG	Decode Encode
WebP	Decode Encode
BMP	Decode only
HEIF/HEIC	Decode only

Audio formats

LPCM Uncompressed	Decode Encode
AAC	Decode Encode

Color tools/effects

The Color panel shows the tools currently assigned to the working clip. All clips have an Exposure and a Temperature tool.

Exposure

The exposure tool contains controls for adjusting exposure and tonal shape.

Input Gamma should be set to the gamma curve the clip was encoded with. See supported gamma spaces. When using log gamma curves, the Exposure slider operates in gamma-correct mode i.e. an Exposure adjustment of 1.0 applied to ISO800 footage will match ISO1600 footage. The Input Gamma selection also acts as a hint for data vs video levels in files.

Exposure is a +/- Ev adjustment slider in stops. Can operate in gamma-correct mode – see above.

Contrast is a standard contrast slider implementation.

LUT allows you to specify a correction LUT to transform from the input gamma space to a target space. Colori has built-in LUTs for popular log gamma spaces to Rec. 709 – or you can load a custom one.

Whites is a standard tone shaping slider to adjust the brightest parts of the image.

Highlights is a standard tone shaping slider to affect just the areas considered highlights of the image.

Shadows is a standard tone shaping slider to affect just the areas considered shadows of the image.

Blacks is a standard tone shaping slider to affect just the darkest parts of the image.

Temperature

The temperature tool contains controls for adjusting color temperature and saturation.

White Balance provides a color picker to automatically white balance based on a pixel sample of the image.

Temperature is a slider to shift the overall color temperature of the image.

Tint is a slider to shift to/from green/pink.

Saturation is a standard color saturation implementation.

Supported gamma spaces

• Rec. 709
• Rec. 2020 HLG
• sRGB
• ARRI LogC3
• RED Log3G10
• Blackmagic Film Gen. 1
• Blackmagic Film Gen. 5
• Sony S-Log3
• Canon C-Log2
• DJI D-Log
• Panasonic V-Log
• Nikon N-Log
• ACEScct

Built-in LUTs

• ACEScct (AP1) to Rec. 709
• Apple Log to Rec. 709
• ARRI LogC3 to Rec. 709
• RED Log3G10 to Rec. 709
• Blackmagic Cinema Camera Film to Rec. 709 v2
• Blackmagic Film Gen. 5 to Rec. 709
• Sony S-Log3 (S-Gamut3.Cine) to Rec. 709
• Canon Log 2 to Rec. 709
• DJI D-Log to Rec. 709
• Panasonic V-Log to Rec. 709
• Nikon N-Log to Rec. 709

Adding Tools

Colori's engine allows for adding any number of tools in addition to the default Exposure and Temperature tools. Tools are added by clicking the + icon.

Hint
Tools are applied in left to right order. All tools bar Exposure and Temperature can be re-ordered by dragging.

Hint
Tools can be favourited to quickly copy them to other clips – even in other projects.

Creating tools

Colori's tool creation engine allows anyone to create their own unique bespoke video tools. To begin creating a tool, simply click the + icon and select New Prompt.

You should then describe an image processing routine you want your tool to perform. You can request user interface controls such as sliders and describe what they should do. Colori currently supports Sliders, Color pickers and Drop-down user interface controls.

Hint
Tools do not have any high-level knowledge of what is in the image. They operate at the pixel level on pixel values. For example, ‘Add a glow around people’ will not function as expected. But ‘Add a glow around bright areas’ could work well.

Note
Colori creates tools by sending only the prompt text to our cloud AI service. Colori does not ever send any of your image or video clip data. The resulting tool is then run on your local GPU and does not require any internet connectivity to run.

Editing tools

All tools (apart from Exposure and Temperature) can be edited and ‘remixed’ into something new by simply pressing the Edit Prompt button in the lower right corner.

Built-in Library

Colori features an extensive built-in tool library for a broad range of scenarios. Tools from the built-in library can also be used in Adobe Premiere. See sharing tools. The built-in library uses the same prompt tool engine as tool creation – this means you can edit built-in tools just like other tools.

Community Library

In addition to the built-in library, Colori has a community space where creators can share and discuss the video tools they have created. Tools can be downloaded from the Community Library and imported into Colori. To import a Colori tool, simply click the + and select Import .colori-effect. To share a tool you have created or ‘remixed’ to the community, simply click the Share icon in the lower left corner and select Share to Community.

Sharing Tools

In addition to sharing to the Community, tools can be exported to .colori-effect files or shared with Adobe Premiere (requires the free Colori for Premiere plugin).

Scopes

To the right of the color tools/effects, there is a Scopes button which provides a variety of analyses of the working clip's frame.

Waveform displays a combined analysis of red, green and blue channels across the picture. Each line of the image is analyzed from left to right and plotted as a wave graph, with the height indicating the strength of that color in that line.

Parade shows an analysis of each independent color channel of the image using waveform graphs.

Vectorscope shows a circular analysis of the hue and saturation found in the image. Hue is represented via the angle of the graph around the center, while saturation is represented by the extent of the graph away from the center. The faint 11 o'clock line represents a universal average skin tone hue angle.

Publish and Export

The Publish panel provides Colori's publishing and exporting functionality. Colori can publish individual images and videos from a project or a batch of multiple images and/or videos. The list of checkboxes on the Publish panel sets which project images and/or videos are marked for publishing. Clicking the Up Arrow Publish button will begin the publishing process.

Hint
Colori allows you to fully continue working on your project while the publishing process is active. Colori will internally copy all image/video state so any project changes don't affect publishing.

Publishing single images or videos

To publish individual images or videos, you can right click on the clip(s) in the Media panel and select Publish. This will mark just the selected clip(s) for publishing and then navigate you to the Publish panel to configure and begin publishing.

Publishing multiple images and/or videos

To mark multiple or all project images and/or videos for publishing, select the clips in the Media panel and then right click and select Publish. Alternatively, you can mark clips for publishing directly in the Publish panel by checking the boxes to the left of the project images/videos.

Publish options

Colori provides extensive options to configure publishing such as codec, bitrate, scaling and audio quality. Colori can publish images and videos and provides separate options for video and image files. When publishing more than one image and/or video, the same options are applied to all images and/or videos.

File (Video or Images)

Filename is the target filename to publish the selected clip to. When multiple clips are selected, this will match the source.

Location is the target folder to publish the selected clip(s) to.

File (Videos)

Container is the containing file format for publishing videos. See supported formats for supported containers for encoding.

Codec selects the video codec for publishing. See supported formats for supported encoding codecs.

Quality selects the video codec's quality for publishing. Video quality options include presets for common video sharing platforms and scenarios but also a custom mode which offers precise codec control.

File (Images)

Format selects the image format to use for publishing. See supported formats for supported image encoding formats.

Quality offers a simple image format quality slider to trade-off between fidelity and file size (JPEG only).

Resize

Colori offers multiple image and/or video resizing options when publishing. To 4K/UHD/HD will scale all images and videos up or down to 4K/UHD/HD while preserving aspect ratio. Scale to Width and Scale to Height allow you to target an arbitrary pixel width or height to scale images and videos to while preserving aspect ratio.

Audio

Audio publishing options appear when publishing videos which contain audio.

Codec selects the audio codec for publishing. See supported formats for supported audio codecs.

Troubleshooting

To aid troubleshooting, Colori writes local diagnostic logs while the application is active.

Diagnostic log path:
macOS /Users/[user]/Library/Application Support/OCTOPUSCINEMA/OCTOPUS Colori/Logs/
Windows C:\Users\[user]\AppData\Local\OCTOPUSCINEMA\OCTOPUS Colori\Logs\

Please see our support page for further help.

Uninstalling

Windows

To uninstall Colori from a Windows machine, navigate to Settings > Apps > Installed apps. Search for or locate OCTOPUS Colori in the list of applications and select Uninstall from the More options menu.

macOS

To uninstall Colori from a macOS machine, you can simply drag the Colori application to the Bin.