APE key: Difference between revisions
(Initial commit - unfinished) |
(En dash in range. Hyphen: compounds) |
||
(4 intermediate revisions by 2 users not shown) | |||
Line 5: | Line 5: | ||
APE tag item keys can have a length of 2 (including) up to 255 (including) characters in the range from 0x20 (Space) until 0x7E (Tilde). | APE tag item keys can have a length of 2 (including) up to 255 (including) characters in the range from 0x20 (Space) until 0x7E (Tilde). | ||
Typical keys should have a length of | Typical keys should have a length of 2–16 characters using the following characters:<br> | ||
Space (0x20), Slash (0x2F), Digits ( | Space (0x20), Slash (0x2F), Digits (0x30–0x39), Letters (0x41–0x5A, 0x61–0x7A). | ||
Values can contain binary data, a value or a list of values. See [[APE Item Value|here]].<br> | Values can contain binary data, a value or a list of values. See [[APE Item Value|here]].<br> | ||
List of values can be mixed, i.e. contain [[APEtag-UTF8|UTF-8]] strings and external references<br> | List of values can be mixed, i.e. contain [[APEtag-UTF8|UTF-8]] strings and external references<br> | ||
beginning with file://..., http://www..., ftp://ftp.... | beginning with file://..., <nowiki>http://www</nowiki>..., <nowiki>ftp://ftp</nowiki>.... | ||
Not allowed are the following keys: ID3, TAG, OggS and MP+. | Not allowed are the following keys: ID3, TAG, OggS and MP+. | ||
Currently the following keys are defined: | Currently the following keys are defined: | ||
{| border="1" cellspacing="1" | {| border="1" cellspacing="1" | ||
|width="100px"| | |width="100px"| | ||
'''''Key''''' | '''''Key''''' | ||
|width=" | |width="280px"| | ||
'''''Meaning''''' | '''''Meaning''''' | ||
|width="300px"| | |width="300px"| | ||
Line 88: | Line 90: | ||
List of [[APEtag-UTF8|UTF-8]] strings | List of [[APEtag-UTF8|UTF-8]] strings | ||
|- | |- | ||
| | |Publicationright | ||
||Publication right holder | |||
|| | || | ||
[[APEtag-UTF8|UTF-8]] string<br> | |||
List of [[APEtag-UTF8|UTF-8]] strings | |||
|- | |||
|File | |||
||File location | |||
|| | || | ||
Link<br> | |||
List of Links | |||
|- | |||
|EAN/UPC | |||
||EAN-13/UPC-A bar code identifier | |||
||12- or 13-digit Integer | |||
|- | |||
|ISBN | |||
||ISBN number with check digit | |||
||[[ISBN|9-digit number with a check digit (0–9 or X)]] | |||
|- | |||
|Catalog | |||
||Catalog number | |||
||sometimes in the EAN/UPC, often some letters followed by some numbers | |||
|- | |- | ||
| | |LC | ||
||Label Code | |||
||[[APE-LC|LC + 4- or 5-digit Integer]] | |||
|- | |||
|Year * | |||
||Release date | |||
||Date | |||
|- | |||
|Record Date | |||
||Record date | |||
||Date | |||
|- | |||
|Record Location | |||
||Record location(s) | |||
|| | || | ||
[[APEtag-UTF8|UTF-8]] string<br> | |||
List of [[APEtag-UTF8|UTF-8]] strings | |||
|- | |||
|Genre ** | |||
||Genre(s) | |||
|| | || | ||
[[APEtag-UTF8|UTF-8]] string<br> | |||
List of [[APEtag-UTF8|UTF-8]] strings | |||
|- | |- | ||
| | |Media | ||
|| | || | ||
Source<br> | |||
Source Media Number/Total Media Number<br> | |||
Source Time | |||
|| | || | ||
Media<br> | |||
Media Integer/Integer<br> | |||
Media Time | |||
|- | |- | ||
| | |Index | ||
||Indexes for quick access | |||
|| | || | ||
Index Time<br> | |||
List of Index Times | |||
|- | |||
|Related | |||
||Location of related information | |||
|| | || | ||
Link<br> | |||
List of Links | |||
|- | |- | ||
| | |ISRC | ||
|| | ||International Standard Recording Number | ||
||ASCII String | |||
|- | |||
|Abstract | |||
||Abstract | |||
||Link | |||
|- | |||
|Language | |||
||Used Language(s) for music/spoken words | |||
|| | || | ||
[[APEtag-UTF8|UTF-8]] string<br> | |||
List of [[APEtag-UTF8|UTF-8]] strings | |||
|- | |||
|Bibliography | |||
||Bibliography/Discography | |||
||Link | |||
|- | |||
|Introplay | |||
||Characteric part of piece for intro playing | |||
||Index Time Range | |||
|- | |||
|Dummy | |||
||Place holder | |||
||Zero data | |||
|} | |||
<nowiki>*</nowiki>This key name is used to be upward compatible. | |||
<nowiki>**</nowiki>Genre keywords should be normally English terms. A native language supporting plugin can translate common expression to the local language and vice versa when storing the genre in the file. | |||
[[Category:Metadata]] |
Latest revision as of 08:47, 23 November 2021
An APE tag item key is a key for accessing special meta-information in an audio file.
Member of APE Tag Item.
APE tag item keys can have a length of 2 (including) up to 255 (including) characters in the range from 0x20 (Space) until 0x7E (Tilde).
Typical keys should have a length of 2–16 characters using the following characters:
Space (0x20), Slash (0x2F), Digits (0x30–0x39), Letters (0x41–0x5A, 0x61–0x7A).
Values can contain binary data, a value or a list of values. See here.
List of values can be mixed, i.e. contain UTF-8 strings and external references
beginning with file://..., http://www..., ftp://ftp....
Not allowed are the following keys: ID3, TAG, OggS and MP+.
Currently the following keys are defined:
Key |
Meaning |
Recommended format of value |
Title |
Music Piece Title |
UTF-8 string |
Subtitle | Title when TITLE contains the work or additional sub title | UTF-8 string |
Artist |
Performing artist |
|
Album | Album name | UTF-8 string |
Debut album | Debut album name | UTF-8 string |
Publisher | Record label or publisher | UTF-8 string |
Conductor | Conductor | UTF-8 string |
Track |
Track Number |
Integer |
Composer |
Name of the original composer |
|
Comment | User comment(s) | |
Copyright | Copyright holder | |
Publicationright | Publication right holder | |
File | File location |
Link |
EAN/UPC | EAN-13/UPC-A bar code identifier | 12- or 13-digit Integer |
ISBN | ISBN number with check digit | 9-digit number with a check digit (0–9 or X) |
Catalog | Catalog number | sometimes in the EAN/UPC, often some letters followed by some numbers |
LC | Label Code | LC + 4- or 5-digit Integer |
Year * | Release date | Date |
Record Date | Record date | Date |
Record Location | Record location(s) | |
Genre ** | Genre(s) | |
Media |
Source |
Media |
Index | Indexes for quick access |
Index Time |
Related | Location of related information |
Link |
ISRC | International Standard Recording Number | ASCII String |
Abstract | Abstract | Link |
Language | Used Language(s) for music/spoken words | |
Bibliography | Bibliography/Discography | Link |
Introplay | Characteric part of piece for intro playing | Index Time Range |
Dummy | Place holder | Zero data |
*This key name is used to be upward compatible.
**Genre keywords should be normally English terms. A native language supporting plugin can translate common expression to the local language and vice versa when storing the genre in the file.