$sound

$sound(wave|midi|mp3|wma|ogg)

Returns the directory for the specified sound files as specified in the Sound Requests dialog.

$sound(filename)[.album|.title|.artist|.year|.comment|.genre|.track|.length|.version|.bitrate|.vbr|.sample|.mode|.copyright|.private|.crc|.id3|.tag|.tags]

Returns information on the specified .mp3 file

• Paramaters
  • Filename - The file to check. This can be relative to $mircdir or an absolute path, for example "C:\My Folder\My File.mp3")
• Properties
  • The following properties return the id3v1 tag values for the specified mp3 file
    • .album - returns the album associated with the mp3.
    • .title - returns the title of the mp3 sound.
    • .artist - returns the album artist of the mp3 sound.
    • .year - returns the year the mp3 sound was published.
    • .comment - returns the comment associated with the mp3.
    • .genre - returns the genre of the mp3 sound.
    • .track - returns the track number of the mp3 sound (it's track on .album).
    • .length - returns the length of the track in milliseconds(see $calc and $duration to convert).
    • .version - returns the version associated with the mp3.
    • .bitrate - returns the bitrate of the mp3 in kbits/second.
    • .vbr - returns $true if the mp3 has a variable bit rate, otherwise $false
    • .sample - returns the sample rate of the mp3 in hertz
    • .mode - returns the mode of the mp3, for example, "Stereo" or "Mono"
    • .copyright - returns $true if there is associated copyright information, otherwise $false
    • .private - returns $true if the mp3 is marked private, otherwise $false
    • .crc - returns $true or $false based on CRC checking for this file
    • .id3 - returns the version of id3 supported by this mp3
  • The following properties return the id3v2 tag values for the specified mp3 file
    • .tags - returns a list of id3v2 tags for this file
    • . tag - returns the Nth id3v2 tag for this file. For example: $sound(test.mp3,2).tag return the 2nd id3v2 tag listed in $sound(test.mp3).tags

Examples

echo -atg $sound(test.mp3).title

This would echo the id3v1 title of the file

echo -atg $sound(test.mp3,$findtok($sound(test.mp3).tags,TIT2,1,32)).tag

This would search for the tag number of TIT2, and return that tag for test.mp3. Therefore, echoing the id3v2 title

echo -atg $sound(test.mp3,0).tags

This would echo a list of id3v2 tags for the mp3

See Also

• vol
• $vol
• $inwave $inmidi $insong
• On midiend On waveend On mp3end
• splay