Copyright: Copyright ® Corona Software 1994


Contents
Corona Software

TimeKeeper    ver 3.1

Description

Installing

Using the Clock

Control Panel

Alarms Screen

Alarm Display Window

Saving the settings

Registration

Package Contents


Control Panel

The control panel has several options to choose from.  All of the options take effect immediately so you can see the results of your actions without having to get in and out of control panel.  All the settings are recorded immediately upon leaving the Control Panel via the OK button.

Repeat Alarms until answered

Selecting this option will cause the Alarm Window to repeat the WAV file playback of the alarms until you respond to the alarm by clicking OK.  Also the window title and the icon (if minimized) will flash.  The time period used to repeat the alarms is the same as the Snooze minutes setting.

Always on top

Selecting this option will cause the clock window to always be visible.

Update Interval

This determines how often the clock will update itself and check the status of the alarms.  An interval of 1000 milliseconds should be fine when viewing seconds and an interval of 10,000 milliseconds should be fine when the second display is not needed.  The longer the interval the less overhead on the system.

Snooze Minutes

Enter the number of minutes to hide the alarm window when you hit the snooze button.

Hourly Chime

Enter the name of a WAV file that you wish to play at the change of hour.  If you do not want an hourly chime then leave this blank.  This must be a WAV file.  If you cannot play WAV files, this feature is useless.

Clock Settings / Alarm Window Settings

Select the radio button for the item you wish to change.  The Font selections
and color selections that are then chosen will apply to the selected item.

Font Name

The font used for the text can be changed.  You are given a list of all available screen fonts on your system to choose from.

Font Size

The font size for the text can be changed.  You can specify any size between 1 and 2048.  The font selected will try to accomodate.

Bold / Italic

These options are for the Clock only.  They will change the font to Bold and/or Italic when selected.

Set Colors

You can change the foreground and background colors of the text.  Select the foreground option then click on the color you want for the text.  Select the background option then click on the color you want the text background to be.

Time Format

Selecting SECONDS toggles the display of seconds on and off.  Selecting 24 HOUR toggles between a 24hour display and a 12 hour AM/PM display.  To display the "AM/PM" characters select the AM/PM display option.

Day format

You may select between a 3 character day display, a full word day, or no day of week display.

Date Format

Allow the user to customize the way the date is displayed.  Select one of the options to see the date in that format.  The top option can be changed by you several different ways.

Examples and Syntax

About Button

This will show the version information for the program and a reminder to register the program.  Use this option often.

Alarms Button

This button will bring up the alarm maintenance window.  See ALARM SCREEN later in this document.

Stop Clock Button

This button will end TimeKeeper!  All settings will be saved and the program will end.


About Form

Click on the ENTER PASSWORD button to enter the password.  To find out how to register click below.

How do I register?

Click on the Registration form button to open the file TIMEREG.WRI.  This file must be in the same directory as TimeKeeper to open.  Fill this out and send it to register the product.


Set Alarms Screen

The alarm panel displays the setting for the alarms, one alarm at a time starting at #1.  To page through the alarms use the scroll bar at the top.  When you switch to a new alarm the current alarm is checked for errors then saved.

List All

This will open a list of all the alarms.  The list will show the alarm number and the message text associated with it.  To go right to a specific alarm just double-click on it.

Add an Alarm

This will add another alarm.  It will put a blank alarm at the end of the list.

Delete this Alarm

The currently displayed alarm will be deleted and the rest of the alarms will be moved down.  For instance, if alarm 5 is deleted then alarm 5 will take on the setting of alarm 6, alarm 6 will take on the settings of alarm 7, etc.  You must always have at least 1 alarm.  NOTE: you can not delete any alarms while you have alarms in "snooze".

Alarm Enabled

This setting will disable or enable the alarm.  When disabled none of the alarm information will be lost, it will just be on hold until it is enabled.

Time

Enter the time for the alarm to go off.  Use hh:mm:ss in a 12 hour format with the correct AM/PM button selected.  Seconds need not be specified.
+10, +30, +60 buttons will add 10, 30, 60 minutes to the currently entered time.  If there is no time set then it will add to the current time of day and put that result into the time field.

Beeps

Select how many BEEPS you want to hear for this alarm.  It will play back at about 1 beep per second.  This does not affect the WAV file playback.

WAV Filename

The file name of the WAV file to be played when the alarm goes off.  Windows 3.1 and a sound board is required.  You can play WAV files through you PC speaker with a sound driver available as SPEAK.ZIP on AOL and other bulletin boards.

Test WAV

Immediately plays the wav file for verification.

Browse

This lets you use a file list dialog to select the wav file name.

Daily option

Causes the alarm to go off every day.  When selected it will check off all 7 days check-off boxes.

Select Days option

Using this option will allow you to select whichs days of the week you want this alarm to go off.  Select the days by checking the MON-SUN check-off boxes.

On Date option

Use this option to specify a future date that you wish this alarm to go off.  Selecting this option will un-select all of the 7 day-of-week check-off boxes.  Use mm-dd-yyyy format.  You must select a date >= today's date.

To select a date using the pop-up calender just double-click on the date field.  This will display the calender.  To select a date just click on it and it will be entered into the date field.

Any alarm set to go off on a specific date will catch up.  That means if the computer was off or TimeKeeper was not running when the alarm was scheduled to run it will run when TimeKeeper starts up next time.  This only works with alarms that were set up to go off on a specific date.  No wildcards!

Use 99 as a wildcard for the month if you want the alarm to play any month.
Use 9999 as a wildcard for the year if you want the alarm to go off on any year.

If you want an alarm to go off on the same date every month then use 99 for the month and 9999 for the year.  The alarm will then go off on that date specified regardless of month and year.  Remember that if you set the date to 29,30,31 it will not run in months that don't have those dates, like February.

If you want an alarm to go off every May 22 for instance ( wife's birthday) then set the date like this:  05/22/9999.  Then you won't miss it and have to sleep on the couch.  (Better yet set it for 05/21/9999.)

Message

Enter the text that you want to see when the alarm goes off.  A window will be displayed containing this text when the alarm goes off.  For an "auto-delete" alarm there will be an asterisk * before the alarm message in the pop-up message window.

Auto-delete alarm after running

When this option is selected for a given alarm it will automatically be deleted after it goes off.  This feature is very useful if you often setup one-time alarms and don't want to have to go back in and clean up your old alarms.  The alarm will only be deleted when you hit OK from the Alarm Display window that  displays your message text.  It will not be deleted when you hit snooze and it will not be deleted if it has no message text.  The message displayed in the alarm message window will have an asterisk * before it to remind you that this alarm is going to be deleted.

Program

This is where you can enter the name of the program that you want to run when the alarm goes off.  It must be a EXE, PIF, COM, BAT file.  The file's existance is checked when entered and you get an error if the file doesn't exist.  You will also get an error message when TimeKeeper tries to run a program that no longer exists.  You can use parameters.

Ex.   C:\WINDOWS\WRITE.EXE C:\DOCS\TIMEKEEP.WRI

==>  A good idea for this feature might be to run a batch file that copies all the  *.INI, *.GRP files to a backup directory every friday afternoon.  Also it could be used to start up your FAX software for the evening.

Browse

This lets you use a file list dialog to select the program name.

Erase Button

This will clear out this alarm's settings back to the defaults.


Set Colors Form
Set Colors

Select foreground and background colors.

Select the option button for foreground or background, then click on a color to select it.  The display below will show you how the colors will look.  When you get a combination that you like, then click on OK.

Double-clicking on a color will bring up the Windows color selection screen.  You can create your own colors by selecting Define custom colors.  Select a color and it will replace the color you double-clicked on.


Browse

Select a file.

How to select a directory using the keyboard:

Tab to the directory list box,  move the highlight up or down with the arrow keys and hit spacebar to select it.

When selecting a WAV file, the form will only show files with the extention of WAV.


Alarm Message Display
Alarm Display Window

This window displays the text for any alarms that have gone off that you have not yet responded to.  This window is always a STAY ON TOP window.  If any of the alarms had WAV file playback you can push the REPLAY WAV button to hear them all again.  If the window has been minimized and another alarm goes off then the window will be restored to its original size.

Snooze button

When you push the snooze button the alarm window will be hidden for the specified amount of time entered on the control panel.  If another alarm comes up during the snooze period the alarm window will reappear.  When the snooze period is up all the WAV files will be replayed.  NOTE: you can not delete any alarms while there are alarms in "snooze".

OK button

This button closes the window and deletes any auto-delete alarms.

Changing the size of the window

To change the size of the ALARM window just resize it as you would any other window.  When you click on OK the window's size and position will be saved.


Date Format

You may select a custom date format, a mm/dd/yy type of date, a 3 char month, dd, yyyy display, a full word month, dd, yyyy display or no date displayed.  Follow these rules when changing the custom date format:

d	zero suppressed day
dd	day with leading zero
ddddd	same as the short date format from Windows Control panel.
dddddd	same as the long date format from Windows Control Panel

w	weekday number displays 0 for sunday, 1 for monday, etc.
ww	the week number of the year

m	zero suppressed month
mm	month with leading zero
mmm	month name as abbreviation
mmmm	full month name

y	day of year as a number 1-366
yy	2 digit year
yyyy	4 digit year

q	quarter

"xxx"	any static text goes in quotes
/ . -	used as a delimeter

Examples:      date format	results
 yy.y	94.89
d/m/yy	30/3/94
mmm dd ww	MAR 30 14
"year " yyyy	year 1994
d-mmm-yyyy	30-MAR-1994


Registration

Please register and I will provide you with a fix to eliminate the dreadful pester screen.  This will also give you the right to all future releases of  Timekeeper.

Registration for TimeKeeper :  $8.00

Add $2.00 shipping if you want a diskette.  You will be sent the latest version which will also be available on AOL.

Make check out to:

James S. Olendorf
107 Daniels Ave.
Schenectady, NY 12304-1605

Please print TIMEREG.WRI, fill it out and send it with the check.

If you have questions you can send E-Mail to address: OLENDORF on America Online.	INTERNET address is  OLENDORF@AOL.COM


Description

TimeKeeper is a clock program with several alarm settings.  Each alarm can be given a message and/or a program to be run.  Also each alarm can play back any WAV file provided you have a sound card and WIN3.1 or the speaker driver.  TimeKeeper also has a feature that allows the clock to always be visible.

This program can be set up to run other programs daily, weekly, monthly
on a date in the future, mon-fri, mon-wed-sat,etc.

TimeKeeper is shareware, not FREE!  Please register and I will keep making improvements.  Registered users can use all future versions of TimeKeeper.


Installing

**  Note **    This program is a Visual Basic program and therefore requires the RunTime module VBRUN300.DLL (available on fine BBSs everwhere).  This module should be put into the WINDOWS\SYSTEM directory.  You must have this file before running TimeKeeper.  If you received a diskette direct from Corona Software then this file will be provided.

1)   Unzip the file TIMEK310.ZIP that you downloaded. (unless you are installing from a Corona Software diskette).  I assume you did this to read this file.  You may want to unzip this to a diskette for future  use.

2)  Copy these files to the WINDOWS\SYSTEM directory.

                  CMDIALOG.VBX
                  COMMDLG.DLL
                  MMSYSTEM.DLL
                  SPIN.VBX
                  THREED.VBX

3)  Copy these files to C:\TIMEKEEP directory.  You can create this directory by typing  MD C:\TIMEKEEP  from a DOS prompt.  You can put these files in another directory if you wish but keep them together.

                  TIMEKEEP.EXE
                  TIMEKEEP.HLP
                  TIMEREG.WRI
                  README.TXT

4)  Add TIMEKEEP.EXE to the Windows STARTUP group. See Windows' documentation for how to do this.

5)  Double-click on the timekeeper icon to start the program.

***************************
* OPTIONAL STEPS          *
***************************

>> Recommended:  If you would like TimeKeeper to start up automatically
 when Windows comes up, put the TimeKeeper ICON into the
 STARTUP group of PROGRAM MANAGER.

If you decide to move files around later, then remember that TIMEKEEP.HLP
must be in the same directory as TIMEKEEP.EXE.

If you want to put the INI file elsewhere then start the program with the
INI file name on the command line.  See your Windows documentation for
instructions on how to change the command line for an ICON in Program
Manager.

      Example:   C:\WINAPP\TIMEKEEP.EXE C:\WINAPP\TIMEKEEP.INI
                                                                   ^                       ^
where the program is located ____|                        |
                                                                                             |
the location and name of the INI file __________|


Package Contents

The following files are included in the authorized package:

SPIN.VBX	Visual Basic spin control
MMSYSTEM.DLL	Multimedia routines
THREED.VBX	Visual Basic 3D effects
CMDIALOG.VBX	Visual Basic common dialog control
COMMDLG.DLL	Windows common dialog routines
TIMEKEEP.EXE	The program
CUCKOO.WAV	A wav file for your amusement (diskette version)
README.TXT	Revision history
TIMEKEEP.HLP	Help file
TIMEREG.WRI	Registration form

VBRUN300.DLL	Visual Basic runtime library (only included in the diskette version)

You are free to distribute this package only if all of the above files are kept
intact, unchanged and are distributed together!

Corona Software assumes no liability for the use of TIMEKEEPER.


Saving the Settings

All settings are saved when selecting OK from the Control Panel, when Exitting the program, or when the clock is moved.


Using the Clock

To bring up the Control Panel you simply double-click on the clock or hit CTRL+C.

To bring up the Set Alarms screen you can double-click while holding the CTRL, ALT, or shift key down.  Or you can double-click with the right mouse button.  Or you could hit CTRL+A.

You can position the clock anywhere on the screen by dragging it with the mouse.

You can also move the clock by using the arrow keys.  The clock has to have the focus (be the active window) to accept keystokes.  You can make the clock the active window by holding ALT and hitting TAB until it says TIMEKEEPER then release all the keys.

Hold down the arrow key to move the clock small increments or use the CTRL+arrow combination to move the clock in larger increments.

You can stop the clock by hitting ALT+F4.

Hit F1 anywhere in the program to bring up the HELP for TimeKeeper.