raw-player

KO | EN

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #claude-code #windows #codex #developer-tools #dsh

★ 39 Open GitHub ↗

Lightweight multi-platform video playback for reviewing RAW video footage from professional cameras.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Introduction to OCTOPUS RAW Player
OCTOPUS RAW Player is a multi-platform (Windows/macOS) lightweight video playback application for reviewing RAW video footage from professional cameras. Currently the player supports CinemaDNG RAW ```.dng``` sequences. The OCTOPUS RAW Player leverages native C++ code for low-level decoding and implements our unique sophisticated colour science processing pipeline in OpenCL.

&nbsp;
<p align="center">
<img src="https://www.octopuscinema.com/wiki/images/thumb/0/0b/Octopus-raw-player-hero.png/1600px-Octopus-raw-player-hero.png" width="80%">
</p>
&nbsp;

**Features**
- Efficient real-time CinemaDNG playback for 8,10,12,14,16-bit bayer or monochrome, lossless or lossy ```.dng``` sequences
- Professional RAW controls (White balance, exposure)
- Advanced colour science control (Highlight recovery/roll-off, SDR Tone-Mapping)
- Advanced gamma/gamut control (ARRI LogC3, RED Log3G10, Blackmagic Film Gen. 5)
- Built-in manufacturer Rec.709 LUTs and custom ```.cube``` LUT loading
- Timecode and metadata display
- Modern minimal interface
- PNG frame export

**Tested Cameras & Software**
- Sigma Fp
- MotionCam Android App
- DJI Xenmuse X5,X5R,X7
- Blackmagic Cinema Camera 2.5K
- Blackmagic Pocket Cinema Camera (Original)
- Blackmagic Micro Cinema Camera
- Blackmagic Ursa Mini 4K
- OCTOPUS16
- SlimRAW
- RAW Converter

For more information, please visit:
https://www.octopuscinema.com/raw-player

# Getting started for Users

## Basic system requirements
- Windows 10 / macOS 10.10 or newer
- GPU with support for OpenGL 3.2+ and OpenCL 1.2+

## Installation
OCTOPUS RAW Player [releases](https://github.com/octopuscinema/raw-player/releases) are usually installed by launching the Windows ```.msi``` or macOS ```.pkg``` installer file. Alternatively, OCTOPUS RAW Player can be run as a portable single-file executable without installation.

### User Guide
Please see the online user guide:
https://www.octopuscinema.com/raw-player#User_Guide

# Donate
If you enjoy using this free open source software and it assists you professionally, please consider [buying us a coffee](https://ko-fi.com/octopuscinema) to help support open source software.<br><br>
[![Donate](https://img.shields.io/badge/Donate-Buy%20us%20a%20Coffee-orange.svg)](https://ko-fi.com/octopuscinema)

# Getting started for Developers

## Building for Windows
### Dependencies
Building OCTOPUS RAW Player requires Visual Studio 2022 with the C# desktop development workload. The OCTOPUS RAW Player project references several NuGet packages which should be restored (https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore) prior to building.

### Building the solution
The OCTOPUS RAW Player executable for Windows can be built from the ```raw-player/Player.Windows.sln``` solution file. The solution contains both C# and C++ projects (mixed managed/unmanaged code). C++ project dependencies are linked dynamically at run-time - please ensure the C++ projects ```raw-player/Decoders``` are built prior to publishing or launching the debug/release executable.
The native C++ dependancies are statically linked against libjpeg-turbo. The appropriate ```.lib``` static library and header files can be downloaded and installed by running ```raw-player/Decoders/Jpeg/GetDependancies.ps1```

#### Deployment
The ```raw-player/Player.Windows.sln``` solution includes a publish profile to build a standalone single-file executable with an embedded .net runtime. This executable can be run on systems without .net runtimes installed.

## Building for macOS
### Dependencies
Building OCTOPUS RAW Player requires Visual Studio 2022 for Mac (with Xamarin.Mac version 8.12 or newer) and Xcode 13 or newer. The OCTOPUS RAW Player project references several NuGet packages which are normally automatically restored prior to building. (See https://learn.microsoft.com/en-us/visualstudio/mac/nuget-walkthrough?view=vsmac-2022 for more information)

### Building the solution
The OCTOPUS RAW Player application for macOS is built from the ```raw-player/Player.macOS.sln``` C# solution file. Visual Studio for Mac does not support C++ projects - native library dependencies must be built manually from the ```raw-player/Decoders/Decoders.macOS.xcworkspace``` Xcode workspace prior to building the C# solution.
The native C++ dependancies are statically linked against libjpeg-turbo. The appropriate ```.a``` static library and header files can be downloaded and installed by running ```raw-player/Decoders/Jpeg/GetDependancies.sh```

# Included in this repository
Cross platform (Windows/macOS) C# and C++ source code and projects/solutions/workspaces including OpenGL and OpenCL GPU kernel source.

# License
The contents of this repository are licensed under the MIT License (https://mit-license.org)

## Contributions
Unless explicitly stated otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the MIT license, shall be licensed as above, without any additional terms or conditions.

raw-player

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README