ns-mkusper / direct-play-nice

CLI utility to convert video files to direct-play formats
GNU General Public License v3.0
1 stars 0 forks source link

direct-play-nice

A CLI utility to convert video files to Direct-Play-compatible (the single best optimization for your home video streaming server) formats.

Purpose

This tool was created to convert video files to formats that satisfy Direct Play requirements for all video files used by your video streaming server and their streaming devices (eg. Chromcast). It is intended to be added to a video-downloading service (ie. with Sonarr or Radarr) as an optimization feature and seamless to the end user (ie. Direct Play selected by default).

Features

Supported Streaming Devices

Device Name Release Year Video Codecs Audio Codecs Resolution Support
Chromecast 2013 H.264, VP8 HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM) Up to 1080p
Chromecast 2 2015 H.264, VP8 HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM) Up to 1080p
Chromecast Audio 2015 N/A HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM), FLAC N/A
Chromecast Ultra 2016 H.264, VP8, VP9, HEVC HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM), FLAC Up to 4K
Chromecast 3 2018 H.264, VP8, VP9 HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM) Up to 1080p
Chromecast with Google TV 2020 H.264, VP8, VP9, HEVC, Dolby Vision, HDR10, HDR10+ HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM), FLAC, Dolby Digital, Dolby Digital Plus, Dolby Atmos Up to 4K HDR
Chromecast with Google TV (HD) 2022 H.264, VP8, VP9, HEVC, HDR10, HDR10+ HE-AAC, LC-AAC, MP3, Vorbis, WAV (LPCM), FLAC, Dolby Digital, Dolby Digital Plus, Dolby Atmos Up to 1080p HDR

Usage

This program can be run standlone directly on the CLI or as a Custom Script Connection with Sonarr or Radarr.

CLI

Usage: direct_play_nice.exe [OPTIONS] <INPUT_FILE> <OUTPUT_FILE>

Arguments:
  <INPUT_FILE>   Video file to convert
  <OUTPUT_FILE>  Our output direct-play-compatible video file

Options:
  -s, --streaming-devices <STREAMING_DEVICES>  List of StreamingDevice
  -c, --config-file <CONFIG_FILE>              Path to the configuration file
  -h, --help                                   Print help
  -V, --version                                Print version

Sonarr / Radarr

When running via Sonarr, Radarr, etc you can use this program to convert each downloaded video file to a Direct-Play-compatible format by adding it as a Custom Script Connection ( Settings >> Connection >> Custom Script )

Running as a custom script in Sonarr

Building

This project relies on FFmpeg and rsmpeg and builds on Mac, Linux and Windows:

cargo install cargo-vcpkg
cargo vcpkg --verbose build
cargo build --verbose

Contributions / Support

If you run into any issues while using this software or want to add a feature or bug fix feel free to raise an issue.