Alarm Clock v1.2 by nix2k

v1.2
-Ok, not entirely sure why, but I decided to poke through this addon. When I did, I found a bunch of bugs. Well, not so much
bugs, as stuff I forgot to add. I "ported" this addon from my script, so there are a lot of shared aliases I used, that I
just did not add into this addon. And I am surprised no one even bothered to mention this to me. SOOO I fixed them. 

v1.1
-Fixed bug with the hour of 12. Because of the nature of this hour (its midday/midnight property), it was causing some bugs. Essentially,
you couldnt set the alarm for any length of 12 (noon). So anything from 12:00pm to 12:59pm was useless. If you used 12am (midnight), it
would actually trigger for 12pm (noon). Anyway, fixed.

v1.0
-First release

---------------------------
Installation
---------------------------
To install, unzip into your mIRC directory (or anywhere, if thats your thing). 
It should be in its own directory, although its not necessary. We'll use c:\mIRC\alarm\ for an example.

When unzipped, type /load -rs c:\mIRC\alarm\alarm.ini

Thats it for installation. When its installed, it will add a new menu option called "Alarm Clock" to the MAIN menu bar.

---------------------------
Usage
---------------------------

First, to start the dialog, select "Alarm Clock" from the menubar, or type /alarm

The dialog is very simple. It has two edit boxes, one for hours, one for minutes. It will give you an error if the times entered are
invalid. So if you try to enter 13:62, it will give you errors. There is a set of radio buttons on the right, to select AM and PM.

To actually use the alarm clock, you must first select an MP3 or Wave file. Click on the Select Sound button, and locate what you wish
to set. You should also set a time for it to execute (obviously). 

You can then set up a few things. First is sound ramping. Sound ramping basically means it starts your master and wave volumes at their 
lowest possible setting (the master volume is the main volume control, while the wave volume controls the volume of wave/mp3 files). When
the alarm executes, you wont hear the file play, however, it quickly gets louder. This is for people who do not wish to be startled by the
alarm (I personally use this alarm to wake me up to go to work. I dont use ramping, I just turn my speakers up really loud, and it scares
me awake). It first starts by raising the MP3 volume to its highest level, and then proceeds to push the Master volume up to its highest
level. Please note, these values are not reset after stopping the alarm. 

There is also the option to put the sound file on repeat. This is entirely obvious. 

To start the alarm, simply click on the Start button. The dialog will hide, and a timer will start. The timer is called alarm (ie 
$timer(alarm)). If, for some reason, you wish to stop the alarm before it executes, simply open the dialog again, and click the Stop button,
it will kill the timer. 

When the alarm executes, it uses /splay to play the file. To stop playing it, just press the Stop button. 

---------------------------
Comments/Questions/Bugs
---------------------------

Any bugs, comments, or questions should be sent to nix2k.

I can be reached at either nick@mircscripts.org or nick@emergeonline.org
You can also send me a private message on mircscripts.org, my username is nix2k

Thanks :)