Difference between revisions of "APE key"
(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.