Added explicit and dolby templates (#223)

* strip formatted parts of path

* handle "None" explicit attribute

* add explicit field to items

* add explicit to template example

* add docs for explicit

* add `dolby` field to items

* add `dolby` docs
This commit is contained in:
Oskar Dudziński
2025-11-17 02:58:13 +01:00
committed by GitHub
parent 66b9f021ad
commit 06b1eded7c
3 changed files with 79 additions and 11 deletions
+28 -7
View File
@@ -44,18 +44,21 @@ Each object type exposes fields you can use inside templates.
| `item.artists` | All main artists | `Daft Punk, Pharrell Williams` |
| `item.features` | Featured artists | `Pharrell Williams` |
| `item.artists_with_features` | Main + featured artists | `Daft Punk, Pharrell Williams` |
| `item.explicit` | Explicit content | `E` |
| `item.dolby:(Dolby Atmos)` | Dolby Atmos (track only) | `(Dolby Atmos)` |
---
### `album`
| Field | Description | Example |
| --------------- | ------------------------- | ------------ |
| `album.id` | Album ID | `98765` |
| `album.title` | Album title | `Discovery` |
| `album.artist` | Primary artist | `Daft Punk` |
| `album.artists` | All main artists | `Daft Punk` |
| `album.date` | Release date (`datetime`) | `2001-03-13` |
| Field | Description | Example |
| ---------------- | ------------------------- | ------------ |
| `album.id` | Album ID | `98765` |
| `album.title` | Album title | `Discovery` |
| `album.artist` | Primary artist | `Daft Punk` |
| `album.artists` | All main artists | `Daft Punk` |
| `album.date` | Release date (`datetime`) | `2001-03-13` |
| `album.explicit` | Explicit content | `clean` |
---
@@ -71,6 +74,24 @@ Each object type exposes fields you can use inside templates.
---
### Explicit
| Format | True Value | False Value |
| ---------------- | ---------- | ----------- |
| `.explicit` | E | |
| `.explicit:long` | explicit | |
| `.explicit:full` | explicit | clean |
### Dolby Atmos
Dolby Atmos is only available in tracks. Format it like this: `item.dolby:<value>`.
| Format | True Value | False Value |
| ------------------ | ---------- | ----------- |
| `item.dolby:D` | D | |
| `item.dolby:DOLBY` | DOLBY | |
| `item.dolby:dolby` | dolby | |
### `extra` and `custom` fields
You can also use: