Playing Sounds

mIRC supports the playing of various types of sounds with the following commands and identifiers.

/splay -cwmpq [filename | stop | pause | resume | seek | skip] [pos]

Plays the specified sound, which can be a .wav, .mid, or .mp3 file.

Where switch w = wave, m = midi, p = mp3, and q = queue for playing.

If you don't specify a folder, the sound folders in the Sound Requests dialog are searched.

You can use stop to stop a currently playing sound, eg. /splay stop, or /splay -w stop, to stop just wave files.

You can use pause, resume, and seek with mp3s.

If you specify the pos value when playing an mp3, eg. /splay llama.mp3 1000, mIRC will play the mp3 starting at that position.

You can also seek to a position in an mp3 while it's being played with eg. /splay seek 1000

To skip the currently playing sound, you can use /splay -wmp skip

The -q switch allows you to queue sounds for playing after the current sound ends.

The -c switch allows you to clear the play queue except for the currently playing sound.

When a sound finishes playing, it triggers a sound event.

/vol -wmpvuN [volume]

Sets the volume on your system for waves, midis, and mp3s (same as waves)

If you use the -v switch, this sets the master volume on your system.

The volume value can range from 0 to 65535.

The -uN switch sets the mute setting, where N = 1 is on, N = 2 is off.

$vol(wave | midi | song | master)

Gets the current volume for the specified sound setting

Properties: mute

$vol(wave).mute returns the mute setting for wave sounds

$inwave, $inmidi, $insong

Return $true if the specified sound type is playing, $false otherwise.

Properties: fname, pos, length, pause

$insong.fname returns the filename of the currently playing song

$sound(type)

Returns the directory specified in the Sound Requests section of the Options dialog, where type can be wave, midi, mp3, wma, or ogg.

$sound(filename)

Returns either the directory for that file type, as above, or information about the sound file. Currently, only mp3 files are supported with the following properties.

Properties: album, title, artist, year, comment, genre, track, length, version, bitrate, vbr, sample, mode, copyright, private, crc, .id3, .tag, .tags.

The above properties always return the id3v1 values of the mp3 file. If you want to retrieve the id3v2 values, you can use the .tag and .tags properties.

showtags {

if ($1- == $null) { echo 2 -e * /showtags: please specify filename, eg. /showtags file.mp3 | halt }

echo 1 id3: $sound($1-).id3

echo 1 tags: $sound($1-).tags

var %n = $sound($1-,0).tag

while (%n > 0) {

echo 1 tag: $sound($1-,%n).tag

dec %n

}

}