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

feat(tracks): add native track names with muxing.track_names

Browse Source 
Set muxing.track_names to native to name an unnamed track in its own language (中文（繁體）, Português (Portugal)) in place of English. The same script and region rules apply. --list, the muxed names and the REST API track_name follow the option. A test fixture resets the muxing options, so a local unshackle.yaml cannot change test results.
This commit is contained in:
imSp4rky
2026-10-24 12:43:50 -06:00
parent 1175035317
commit ecf17baffe
7 changed files with 87 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide/output-and-naming.md
+23
View File
@@ -305,6 +305,29 @@ A tag without a region, such as `zh`, gets no script because the region is what
unshackle writes audio tags as the service gives them, because a script applies only to written text.
Track selection, `--list` tags and file names use the service tag.
Set `muxing.track_names` to `native` to name each track in its own language. The same rules apply
to the script and the region:
```yaml title="unshackle.yaml"
muxing:
track_names: native
```
| Service tag | Track name |
|-------------|------------|
| `zh-TW` subtitle | 中文（繁體） |
| `zh-HK` subtitle | 中文（繁體，香港） |
| `pt-PT` | Português (Portugal) |
| `es-419` | Español (Latinoamérica) |
| `ja-JP` | 日本語 |
The option also changes the names in `--list` and in the `track_name` field of the REST API.
!!! note "Players that show the language next to the name"
Some players, such as Jellyfin, show the track name and the language name together. They leave
out the language when the name already contains it, so an English name shows once. A native name
such as `日本語` shows next to `Japanese` in an English interface.
### DTS:X Profile 2 output
A title whose audio holds a `dtsx` or `dtsy` sample entry (DTS:X Profile 2, DTS-UHD) muxes