kenzuya/unshackle
1
0
Fork 2
mirror of https://github.com/unshackle-dl/unshackle.git synced 2026-11-14 04:55:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(naming): add codec_names to rename codec and HDR labels in filenames

Browse Source 
A codec name that ends in a digit now gets a separator before the channels, so AC-4 2.0 gives AC-4.2.0 and no longer AC-42.0.
This commit is contained in:
imSp4rky
2026-10-28 14:19:23 -06:00
parent 2e75cc35a1
commit b0c006d7f6
7 changed files with 89 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/configuration/index.md
+1 -1
View File
@@ -32,7 +32,7 @@ Where the file lives, how unshackle discovers it, and how to edit it:
| [Directories](directories.md) | `directories`, `filenames`, `services_repo_force` |
| [Services & authentication](services.md) | `services`, `credentials`, `firefox_cookies`, `remote_services`, `serve` |
| [Download & processing](download.md) | `dl`, `continue_downloads`, `merge_segments`, `subtitle`, `audio`, `muxing`, `language_tags`, `dual_multi_mode`, `generate_dv_mode`, `hdr10plus_probe` |
| [Output & naming](output.md) | `output_template`, `tag`, `tag_rules`, `tag_group_name`, `tag_imdb_tmdb`, `chapter_fallback_name`, `unicode_filenames` |
| [Output & naming](output.md) | `output_template`, `tag`, `tag_rules`, `codec_names`, `tag_group_name`, `tag_imdb_tmdb`, `chapter_fallback_name`, `unicode_filenames` |
| [DRM & CDM](drm.md) | `cdm`, `remote_cdm`, `decryption` |
| [Network & proxy](network.md) | `network`, `headers`, `proxy_providers` |
| [Key vaults](vaults.md) | `key_vaults`, `vault_timeout` |
docs/reference/configuration/output.md
+26
View File
@@ -69,6 +69,32 @@ folder-kind keys.
| `chapter_fallback_name` | str | `""` | Fallback template for chapter names, e.g. `"Chapter {i:02}"`. |
| `unicode_filenames` | bool | `false` | Allow Unicode in filenames; when `false`, names are ASCII-sanitised. |
## `codec_names`
- **Type:** `dict`  ·  **Default:** `{}`
Renames the codec and HDR names in the filename. Each map key is a name that unshackle writes by
default, and its value is the name to write instead. The map applies to the `video`, `audio`,
and `hdr` [template variables](../../guide/output-and-naming.md#template-variables), and so
also to `audio_full`. A name that is not in the map stays as it is, and an empty value removes
the name. You can also set `codec_names` for one service under `services`.
```yaml title="unshackle.yaml"
codec_names:
DDP: EAC3 # DDP5.1 -> EAC3.5.1
DD: AC3 # DD5.1 -> AC3.5.1
H.265: HEVC # H.265 -> HEVC
HDR10P: HDR10+ # DV.HDR10P -> DV.HDR10+
```
For `hdr`, unshackle renames each part of a Dolby Vision label separately, so `HDR10P` also
changes `DV.HDR10P` to `DV.HDR10+`. When an audio name ends in a digit, `audio_full` puts a
separator before the channels: `EAC3.5.1`, not `EAC35.1`.
!!! note "`tag_rules` see the new names"
unshackle evaluates [`tag_rules`](#tag_rules) after the rename. With the example above, a
rule must match `audio: EAC3`, not `audio: DDP`.
## `tag_rules`
- **Type:** `list`  ·  **Default:** `[]`