direct_play_nice 0.1.0-beta.2

CLI program that converts video files to direct-play-compatible formats.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# Getting Started

## First conversion

```bash
direct_play_nice input.mkv output.mp4
```

## Set up a default config file

If you run this tool often, create a config once and keep day-to-day commands
short.

By default, direct-play-nice reads:

- `$XDG_CONFIG_HOME/direct-play-nice/config.toml` (when `XDG_CONFIG_HOME` is set)
- `~/.config/direct-play-nice/config.toml`

Create the file:

```bash
mkdir -p ~/.config/direct-play-nice
cat > ~/.config/direct-play-nice/config.toml <<'EOF'
streaming_devices = "all"
video_quality = "match-source"
video_codec = "auto"
audio_quality = "192k"
hw_accel = "auto"
unsupported_video_policy = "ignore"
sub_mode = "auto"
ocr_default_language = "eng"
servarr_output_extension = "mp4"
servarr_output_suffix = ".fixed"

[plex]
refresh = false
EOF
```

### Why these defaults are sane

- `streaming_devices = "all"` keeps output compatible across all built-in
  device profiles.
- `video_quality = "match-source"` avoids unnecessary downscaling by default.
- `video_codec = "auto"` lets the tool pick the safest codec intersection.
- `audio_quality = "192k"` is a practical bitrate for broad AAC compatibility.
- `hw_accel = "auto"` uses hardware encoding when available and falls back to
  software when not.
- `unsupported_video_policy = "ignore"` skips extra video streams that can
  break muxing in common container/player paths.
- `sub_mode = "auto"` only OCRs bitmap subtitles when needed.
- `ocr_default_language = "eng"` gives OCR a stable fallback language.
- `servarr_output_extension = "mp4"` targets the most portable container for
  direct play.
- `servarr_output_suffix = ".fixed"` makes replaced files easy to identify
  during rollout.

### Override order

When the same option appears in multiple places, priority is:

1. CLI flags (highest)
2. `--config <path>`
3. `DIRECT_PLAY_NICE_CONFIG=<path>`
4. Default config location above

## Device targeting

Use `--device` to narrow compatibility constraints:

```bash
direct_play_nice --device chromecast input.mkv output.mp4
direct_play_nice --device chromecast,roku input.mkv output.mp4
```

`--device all` (or omitting `--device`) computes a profile compatible across all
built-in device definitions.

## Inspect an input before converting

```bash
direct_play_nice --probe-streams input.mkv
direct_play_nice --probe-streams --output json input.mkv
```