From WikiChip
Difference between revisions of "mirc/playing music"
< mirc

m
(Remove spam link.)
 
(56 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
{{stub}}
+
{{mirc title|Playing Music}}
−
{{mIRC Guide}}
+
'''Playing music''' in mIRC is really a very simple process, easily accomplished through the use of the {{mIRC|/splay}} command. mIRC can also be enhanced by other sounds, not just songs, as well. Depending on how you want your own, custom mIRC experience to be, whether you are a newbie or an advanced scripter, sounds are often added to events in mIRC by some scripters. Creating games in mIRC is an advanced type of script where sounds can greatly enhance a user's experience.
  
−
'''Playing music''' in mIRC is really a very simple process, easily accomplished through the use of the [[/splay command - mIRC|/splay command]]. mIRC can also be enhanced by other sounds, not just songs, as well. Depending on how you want your own, custom mIRC experience to be, whether you are a newbie or an advanced scripter, sounds are often added to events in mIRC by some scripters. Creating games in mIRC is an advanced type of script where sounds can greatly enhance a user's experience.
+
== Enabling mIRC Sounds ==
 +
In order for you to be able to play music or any other type of sound in mIRC, you must first enable sounds. Sounds can be enabled simply by going to the options dialog (Alt+O), then clicking on the 'Sounds' option in the left-hand side list, and then placing a check mark into the ''Enable Sounds''. Below is a screenshot of the options window with the ''Enable Sounds'' option ticked.
  
−
= Enabling mIRC Sounds =
+
'''Note:''' Alternatively, you may use the {{mIRC|/ebeeps}} command to enable sounds in mIRC: <code>/ebeeps on</code>
−
In order for you to be able to play music or any other type of sound in mIRC, you must first enable sounds. Sounds can be enabled simply by going to the options dialog (Alt+O), then clicking on the 'Sounds' option in the left-hand side list, and then placing a check mark into the ''Enable Sounds''. Below is a screenshot of the options window with the ''Enable Sounds'' option ticked.
 
  
 
[[File:Options-sounds2.png|Enabling mIRC Sounds]]
 
[[File:Options-sounds2.png|Enabling mIRC Sounds]]
  
−
= Support =
+
== Supported Formats ==
 
mIRC supports the following media formats: <code>.wma,.mp3,.wav,.mid,.ogg</code>
 
mIRC supports the following media formats: <code>.wma,.mp3,.wav,.mid,.ogg</code>
  
−
Multiple file formats can be played at the same time, but you '''cannot''' play multiple files, of the same format, at the same time. For instance, you can play a ''.wav'' file at the same time as an ''.mp3'' file, but you cannot play a ''.wav'' file and another ''.wav'' file at the same time. The second ''.wav'' file will take precedence; the first ''.wav'' file will be stopped and the second one then played.
+
'''Note:''' The <code>.mp3,.wma & .ogg</code> formats are all considered the same format when using the <code>/splay</code> command.
 +
 
 +
Multiple file formats can be played at the same time. However, you '''cannot''' play multiple files, of the same format, at the same time. For instance, you can play a ''.wav'' file at the same time as an ''.mp3'' file, but you cannot play a ''.wav'' file and another ''.wav'' file at the same time. The second ''.wav'' file will take precedence if you're not queuing the file: the first ''.wav'' file will be stopped and the second one then played. Make sure to keep in mind what has been said regarding the formats <code>.mp3,.wma & .ogg</code>; they are all treated the same with the {{mIRC|/splay}} command, so only one of those types may play at a time.
  
−
= Synopsis =
+
== Synopsis ==
 
  <source lang="mIRC">/splay -cwmpq [filename | stop | pause | resume | seek | skip] [pos]</source>
 
  <source lang="mIRC">/splay -cwmpq [filename | stop | pause | resume | seek | skip] [pos]</source>
  
−
'''Example'''
+
=== Switches ===
 +
* <code>-wmp</code> - Indicates that the feature (only Stop or Skip features may be used with these flags) will be done on the specified media format that is currently playing.
 +
** <code>-w</code> - '''WAVE format'''
 +
** <code>-m</code> - '''MIDI format'''
 +
** <code>-p</code> - '''MP3/OGG/WMA formats'''
 +
'''Note:''' You may specify more than one of the above switches at the same time for the Stop feature, but not for Skip.
  
−
When you are ready to play a sound, you would simply use the following, basic commands:
+
=== Parameters ===
 +
* <code>-q</code> - Adds the file to the queue for that format. The first file in the queue, for that format, is played when a song of that format ends its playback.
 +
* <code>[filename]</code> - The file name for the sound file you wish to use. Typically, this only needs to be specified when you want to play or queue a file; other than those times, you would only use the flag for the sound file's type for manipulating how it acts.
 +
* <code>[stop|pause|resume|seek|skip]</code> - Allows further control over a sound file that is currently playing. These flags' titles are their respective functions. These are discussed, in more detail, further down.
 +
* <code>[pos]</code> - This optional parameter is used to point out the location in the music file, in milliseconds, for your sound to either start from or seek into.
  
−
<source lang="mIRC">/splay C:\Directory_To_Music_File\MusicFile.mp3</source>
+
== Music Playing, Now What? ==
−
If the file is not in the mIRC directory, a full file path is required (quotes are not needed).
+
After the music is playing, you have a few options available for manipulating the playback. If you are making a full Music Player, for example in a dialog form, these options are really helpful.
  
−
== Flags ==
+
=== Playback Options ===
−
* -wmp - Indicates that the function (stop, pause, resume, seek, skip) will be done on the wav (-w), midi (-m), and/or mp3 (-p) file that is currently playing.
+
* '''Pause''' - <code>/splay pause</code> is used to pause the playing music
−
* -q - Adds the file to a queue, first file in the queue for that format is played when a song of that format ends its playback.
+
* '''Resume''' - <code>/splay resume</code> allows you to resume the paused music file
−
* [filename] - The file name for the mIRC file.
+
* '''Stop''' - <code>/splay stop</code> will stop the current music file.
−
* [stop|pause|resume|seek|skip] - Allows further control over existing playing file; their titles are their respective functions. These are discussed, in more detail, further down.
+
* '''Seek''' - <code>/splay seek [pos]</code> will go to a certain point in the music
−
* [pos] - This optional parameter is used to point out the location in the music file, in milliseconds, for your sound to either start from or seek. For example, if you wanted to start a music file at a specific point, you would use:
+
* '''Skip''' - <code>/splay skip</code> allows you to skip the currently playing music file. If no other files are present in the queue for that particular sound type, no other file will play.
  
−
  <source lang="mIRC">/splay C:\My Music\Tool\Aenima.mp3 1500</source>
+
=== Volume Options ===
 +
You can control the volume of your system (and, therefore, of the music played in mIRC) with the /vol command.
 +
==== Synopsis ====
 +
  <source lang="mIRC">/vol -wmpvuN [volume]</source>
  
−
Take note on how <code>1500</code> is the value we've given for the optional <code>[pos]</code>; the 1500 is the position, in milliseconds, within the ''.mp3'' file where we want the splay command to start playing from.
+
==== Flags ====
 +
* <code>-w</code> - Changes the volume for WAV files only.
 +
* <code>-m</code> - Changes the volume for MIDI files only.
 +
* <code>-p</code> - Changes the volume for MP3/WMA/OGG only.
 +
* <code>-v</code> - Sets the master volume for the system, which increases volume across all levels.
 +
* <code>-uN</code> - Sets the mute setting: N = 1 turns the mute on, N = 2 turns the mute off.
 +
* <code>[volume]</code> - A number indicating the volume, range from 0 (no sound) to 65535 (max).
  
 +
== Sound Finished, Now What? ==
 +
After a sound file has finished playing, it will trigger an event. These events '''will not''' trigger for a file stopped with <code>/splay stop</code> or skipped with <code>/splay skip</code> commands, regardless of the switches/parameters used.
  
−
= Music Playing, Now What? =
+
The <code>ON MP3END, ON WAVEEND & ON MIDIEND</code> events will trigger for the <code>.mp3,.wma,.ogg</code>, the <code>.wav</code> & the <code>.mid</code> formats, respectively. The ''undocumented'' <code>ON SONGEND</code> event will trigger for any of these five formats.
−
After the music is playing, you have a few options available for manipulating the playback. If you are making a full Music Player, for example in a dialog form, these options are really helpful.
+
 
 +
=== Synopsis ===
 +
<source lang="mIRC">
 +
on <level>:mp3end|midiend|waveend|songend:<commands>
 +
</source>
 +
 
 +
The local identifier, {{mIRC|$filename}}, will return the complete file name that has finished playing.
 +
 
 +
== Any useful $identifier I can use? ==
 +
Of course! Here is the list:
 +
 
 +
* $vol(<wave | midi | song | master>) - Returns a number between 0 and 65535 for the specified type.
 +
** '''Property:''' If the .mute property is used, it returns a $true/$false value, the mute setting for that type.
 +
* $inwave, $inmidi, $insong - Return $true if the specified wave, midi, mp3/wma/ogg type is playing, $false otherwise.
 +
** '''Properties:'''
 +
** .fname - Returns the complete filename
 +
** .pos - Returns the current position in the file
 +
** .length - Returns the length of the song
 +
** .pause - Returns $true if the song is paused
 +
* $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.
 +
** '''Properties:''' .album, .title, .artist, .year, .comment, .genre, .track, .length, .version, .bitrate, .vbr, .sample, .mode, .copyright, .private, .crc, .id3, .tag, .tags
 +
** Return the corresponding value, 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:
 +
<source lang="mIRC">alias 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
 +
}
 +
}
 +
</source>
 +
 
 +
== Examples ==
 +
<source lang="mIRC">
 +
;Play the mp3 file, if an mp3 file is already playing, it is stopped before.
 +
/splay C:\Directory_To_Music_File\MusicFile.mp3
 +
 +
;Play a mp3 file at a specific point (1500 milliseconds from the beginning)
 +
/splay C:\My Music\file.mp3 1500
 +
 
 +
;Stop the wave file that is currently playing, if any
 +
/splay -w stop
 +
 
 +
;Stop the wave file and the mp3/wma/ogg file that are currently playing, if any
 +
/splay -wp stop
 +
 
 +
;Seek the mp3 file that is playing, won't work on MIDI or WAVE so -p is not required
 +
/splay seek 1000
  
−
== Playback Options ==
+
;Skip the song currently playing for the wave format
−
* Pause - <code>/splay pause</code> is used to pause the playing music
+
/splay -w skip
−
* Resume - <code>/splay resume</code> allows you to resume the paused music file.
 
−
* Stop - <code>/splay stop</code> will stop the current music file.
 
−
* Seek - <code>/splay seek [pos]</code> will go to a certain point in the music. Example: <code>/splay seek 1000</code>
 
−
* Skip - <code>/splay skip</code> allows you to skip the currently playing music file.
 
  
−
Using <code>-w,-m, or -p</code> will allow you to use the file type switches to control only specific kinds of files. For example: <source lang="mIRC">/splay -w stop</source> will stop only the ''.wav'' file that is currently playing.
+
;Set the master volume to 32200
 +
/vol -v 32200
  
 +
;Warn if song finish while having no sound on the master volume
 +
on *:songend:if ($vol(master) == 0) || ($vol(master).mute) echo -s * You should turn up the volume!
 +
</source>
  
−
[[Category:mIRC]]
+
[[Category:mIRC|playing music]]

Latest revision as of 13:58, 26 January 2024

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

Playing music in mIRC is really a very simple process, easily accomplished through the use of the /splay command. mIRC can also be enhanced by other sounds, not just songs, as well. Depending on how you want your own, custom mIRC experience to be, whether you are a newbie or an advanced scripter, sounds are often added to events in mIRC by some scripters. Creating games in mIRC is an advanced type of script where sounds can greatly enhance a user's experience.

Enabling mIRC Sounds[edit]

In order for you to be able to play music or any other type of sound in mIRC, you must first enable sounds. Sounds can be enabled simply by going to the options dialog (Alt+O), then clicking on the 'Sounds' option in the left-hand side list, and then placing a check mark into the Enable Sounds. Below is a screenshot of the options window with the Enable Sounds option ticked.

Note: Alternatively, you may use the /ebeeps command to enable sounds in mIRC: /ebeeps on

Enabling mIRC Sounds

Supported Formats[edit]

mIRC supports the following media formats: .wma,.mp3,.wav,.mid,.ogg

Note: The .mp3,.wma & .ogg formats are all considered the same format when using the /splay command.

Multiple file formats can be played at the same time. However, you cannot play multiple files, of the same format, at the same time. For instance, you can play a .wav file at the same time as an .mp3 file, but you cannot play a .wav file and another .wav file at the same time. The second .wav file will take precedence if you're not queuing the file: the first .wav file will be stopped and the second one then played. Make sure to keep in mind what has been said regarding the formats .mp3,.wma & .ogg; they are all treated the same with the /splay command, so only one of those types may play at a time.

Synopsis[edit]

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

Switches[edit]

  • -wmp - Indicates that the feature (only Stop or Skip features may be used with these flags) will be done on the specified media format that is currently playing.
    • -w - WAVE format
    • -m - MIDI format
    • -p - MP3/OGG/WMA formats

Note: You may specify more than one of the above switches at the same time for the Stop feature, but not for Skip.

Parameters[edit]

  • -q - Adds the file to the queue for that format. The first file in the queue, for that format, is played when a song of that format ends its playback.
  • [filename] - The file name for the sound file you wish to use. Typically, this only needs to be specified when you want to play or queue a file; other than those times, you would only use the flag for the sound file's type for manipulating how it acts.
  • [stop|pause|resume|seek|skip] - Allows further control over a sound file that is currently playing. These flags' titles are their respective functions. These are discussed, in more detail, further down.
  • [pos] - This optional parameter is used to point out the location in the music file, in milliseconds, for your sound to either start from or seek into.

Music Playing, Now What?[edit]

After the music is playing, you have a few options available for manipulating the playback. If you are making a full Music Player, for example in a dialog form, these options are really helpful.

Playback Options[edit]

  • Pause - /splay pause is used to pause the playing music
  • Resume - /splay resume allows you to resume the paused music file
  • Stop - /splay stop will stop the current music file.
  • Seek - /splay seek [pos] will go to a certain point in the music
  • Skip - /splay skip allows you to skip the currently playing music file. If no other files are present in the queue for that particular sound type, no other file will play.

Volume Options[edit]

You can control the volume of your system (and, therefore, of the music played in mIRC) with the /vol command.

Synopsis[edit]

/vol -wmpvuN [volume]

Flags[edit]

  • -w - Changes the volume for WAV files only.
  • -m - Changes the volume for MIDI files only.
  • -p - Changes the volume for MP3/WMA/OGG only.
  • -v - Sets the master volume for the system, which increases volume across all levels.
  • -uN - Sets the mute setting: N = 1 turns the mute on, N = 2 turns the mute off.
  • [volume] - A number indicating the volume, range from 0 (no sound) to 65535 (max).

Sound Finished, Now What?[edit]

After a sound file has finished playing, it will trigger an event. These events will not trigger for a file stopped with /splay stop or skipped with /splay skip commands, regardless of the switches/parameters used.

The ON MP3END, ON WAVEEND & ON MIDIEND events will trigger for the .mp3,.wma,.ogg, the .wav & the .mid formats, respectively. The undocumented ON SONGEND event will trigger for any of these five formats.

Synopsis[edit]

on <level>:mp3end|midiend|waveend|songend:<commands>

The local identifier, $filename, will return the complete file name that has finished playing.

Any useful $identifier I can use?[edit]

Of course! Here is the list:

  • $vol(<wave | midi | song | master>) - Returns a number between 0 and 65535 for the specified type.
    • Property: If the .mute property is used, it returns a $true/$false value, the mute setting for that type.
  • $inwave, $inmidi, $insong - Return $true if the specified wave, midi, mp3/wma/ogg type is playing, $false otherwise.
    • Properties:
    • .fname - Returns the complete filename
    • .pos - Returns the current position in the file
    • .length - Returns the length of the song
    • .pause - Returns $true if the song is paused
  • $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.
    • Properties: .album, .title, .artist, .year, .comment, .genre, .track, .length, .version, .bitrate, .vbr, .sample, .mode, .copyright, .private, .crc, .id3, .tag, .tags
    • Return the corresponding value, 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:
alias 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
 }
}

Examples[edit]

 ;Play the mp3 file, if an mp3 file is already playing, it is stopped before.
 /splay C:\Directory_To_Music_File\MusicFile.mp3
 
 ;Play a mp3 file at a specific point (1500 milliseconds from the beginning)
 /splay C:\My Music\file.mp3 1500
 
 ;Stop the wave file that is currently playing, if any
 /splay -w stop
 
 ;Stop the wave file and the mp3/wma/ogg file that are currently playing, if any
 /splay -wp stop
 
 ;Seek the mp3 file that is playing, won't work on MIDI or WAVE so -p is not required
 /splay seek 1000
 
 ;Skip the song currently playing for the wave format
 /splay -w skip
 
 ;Set the master volume to 32200
 /vol -v 32200
 
 ;Warn if song finish while having no sound on the master volume 
 on *:songend:if ($vol(master) == 0) || ($vol(master).mute) echo -s * You should turn up the volume!
Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/playing_music&oldid=102153"