Editing mirc/commands/splay

{{mirc title|/splay Command}}
'''''Note:''' This command is also a part of the [[Playing music - mIRC|playing music]] section.''


'''/splay''' can be used to play a number of common Windows sound files. Supported formats include, but sometimes are not limited to: ''.wav'', ''.mid'', ''.mp3'', ''.ogg'', and ''.wma''.

== Synopsis ==
<pre>/splay -cwmpq [filename | stop | pause | resume | seek | skip] [pos]</pre>

== Switches ==
* '''-c''' - Allows you to clear the play queue, except for the currently playing sound (which will continue to play).
* '''-w''' - Tells the command you are specifying a ''.wav'' file to play.
* '''-m''' - Tells the command you are specifying a ''.mid'' file to play.
* '''-p''' - Tells the command you are specifying an ''.mp3/.wma/.ogg'' file to play.
* '''-q''' - Specifies that the filename you desire to play should be placed in the queue, after the current sounds has played, and any preceding sounds in the play queue..

== Parameters ==
<span style="display: inline-block; width: 90px;">'''filename'''</span>Desc

<span style="display: inline-block; width: 90px;">'''stop'''</span>Stops the currently playing file.

<span style="display: inline-block; width: 90px;">'''pause'''</span><span style="color: #A60000;">''mp3,ogg,wma ONLY''</span> - Allows you to pause the currently playing sound file.

<span style="display: inline-block; width: 90px;">'''resume'''</span><span style="color: #A60000;">''mp3,ogg,wma ONLY''</span> - Allows you to resume the currently paused sound file.

<span style="display: inline-block; width: 90px;">'''seek'''</span><span style="color: #A60000;">''mp3,ogg,wma ONLY''</span> - Allows you to seek to a certain point in the currently playing file. See '''[pos]''' below.

<span style="display: inline-block; width: 90px;">'''skip'''</span>Allows you to skip the currently playing sound file. If there are any files in the queue, the next file will begin to play.

<span style="display: inline-block; width: 90px;">'''[pos]'''</span><span style="color: #A60000;">''mp3,ogg,wma ONLY''</span> - When used in combination with the '''seek''' parameter, this should be the location, in seconds, where you want to begin playing the sound file. ''Note:'' The seek position is in milliseconds. Keep in mind that 1-second = 1000-milliseconds.

== Examples ==
'''Play the file ''myfile.mp3'' located in the mIRC Sounds folder'''
<source lang="mIRC">/splay -p myfile.mp3</source>

'''Stop the currently playing mp3'''
<source lang="mIRC">/splay -p stop</source>

'''Stop all sound files'''
<source lang="mIRC">/splay -pmw stop</source>

'''Seek to 1:03 in the currently playing mp3'''
<source lang="mIRC">/splay -p seek 60300</source>

== Compatibility ==
{{mIRC compatibility|6.0}}

== See Also ==
* [[Playing Music - mIRC|Playing Music]]
* [[On midiend - mIRC|ON MIDIEND]]
* [[On mp3end - mIRC|ON MP3END]]
* [[On nosound - mIRC|ON NOSOUND]]
* [[On waveend - mIRC|ON WAVEEND]]
* {{mIRC|$inmidi}}
* {{mIRC|$insong}}
* {{mIRC|$inwave}}
* {{mIRC|$sound}}
* {{mIRC|$vol}}
* {{mIRC|/vol}}
{{mIRC command list}}

[[Category:mIRC commands|splay command - mIRC]]