$mp3 » History » Version 5
Per Amundsen, 12/17/2018 07:33 PM
1 | 1 | Per Amundsen | _Added in 1.9.0_ |
---|---|---|---|
2 | |||
3 | *$mp3(filename)* |
||
4 | |||
5 | 2 | Per Amundsen | Returns "ID3 tag":https://en.wikipedia.org/wiki/ID3 information about a file/song. |
6 | 1 | Per Amundsen | |
7 | _If file is not found, the default sound folder path is returned._ |
||
8 | |||
9 | 4 | Per Amundsen | _Same as [[$sound]]._ |
10 | |||
11 | 1 | Per Amundsen | *Parameters* |
12 | |||
13 | filename - Filename to check. |
||
14 | |||
15 | *Properties* |
||
16 | |||
17 | .album - Album name. |
||
18 | .title - Song title. |
||
19 | .artist - Song artist. |
||
20 | .year - Album/song year. |
||
21 | .comment - Comments field. |
||
22 | .genre - Song genre. |
||
23 | .track - Album track, |
||
24 | .length - Song length. |
||
25 | .bitrate - Song bitrate. |
||
26 | .version - "MPEG":https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group version. |
||
27 | .variable - [[$true]] if the song is "variable bitrate":https://en.wikipedia.org/wiki/Variable_bitrate, otherwise [[$false]]. |
||
28 | .sample - "MPEG":https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group frequency rate. |
||
29 | .mode - "MPEG":https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group mode. |
||
30 | .layer - "MPEG":https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group layer. |
||
31 | 3 | Per Amundsen | .copyright - [[$true]] if copyright field is enabled, otherwise [[$false]]. |
32 | .private - [[$true]] if private field is enabled, otherwise [[$false]]. |
||
33 | 5 | Per Amundsen | .crc - [[$true]] if protected field is enabled, otherwise [[$false]]. |
34 | .vbr - [[$true]] if the song bitrate is variable, otherwise [[$false]]. |
||
35 | 1 | Per Amundsen | |
36 | *Example* |
||
37 | |||
38 | <pre> |
||
39 | ; Print artist - title - album for 'song.mp3' |
||
40 | //echo -ag $mp3(song.mp3).artist- $mp3(song.mp3).title - $mp3(song.mp3).album |
||
41 | </pre> |