Striking chiming talking Tray Clock Version 2.3
-------------------------------------------------------------------
	Yuri Salnikov
	Moscow, Russia.
	March, 1999

	Striking Tray Clock is copyright
	 1999 by Yuri Salnikov.

	mailto: yura.salnikov@usa.net
-------------------------------------------------------------------

	EXPOSITION

The system task bar (also known as the "tray") provides a location for programs to display icons. But the only system time stays there in text form. This program corrects such inequality and adds some more features.

Tray Clock is a 32-bit win95/98/NT freeware program that displays clock icon in the task bar. It can be configured to strike hours and to voice hours, or to be silent. The program can record sounds and voices from microphone or other input lines. It has a sound reminder, i.e. editable time-table to play additional sound and voice files at planned time every day, day of week or day of year.
Voice messages may have different levels of importance (# see below):
discarding message causes removing the voice file when done playing or when missed the time,
time message is played only at planned time,
important message is queued if missed the time,
dialog message waits for voice answer, e.t.c.

In version 2.3 there is a new feature for indicating time in various time zones of the world. As an example setup page of properties has three records for Moscow, Singapore and San Francisco time zones. Also in this version voices AM and PM may be switched if your computer got mixed with days and nights.

	INSTALLATION

To install Tray Clock unpack archive TrayClock23.zip to the directory of your choice, e.g. C:\WINDOWS. If you have previous versions of Tray Clock installed on your computer and it is running, then you should close it (not uninstall), as described below, and replace file TrayClock.exe with those from archive TrayClock23.zip. Replace also this text file. There are only three files in the archive: TrayClock.exe, TrayClock.txt (this file) and TrayClock.gif (banner). When installation completes run TrayClock.exe and a clock icon will appear in the task bar, a shortcut to the program will be created in your Programs menu. No splash nor other nag screens at all.

Changes Made to System by Installation:
The program installs one executable file TrayClock.exe and one text file TrayClock.txt to the directory you specify in the installation.
The program creates C:\WINDOWS\Striking Tray Clock.lnk file and an entry in the HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run registry key to run Tray Clock when Windows starts. The program creates TrayClock.wav for recording sounds, TrayClock.ini (TrayClock.bak) for options and time-table configuration. Tray Clock uninstallation will remove all of these changes in most cases.

	UNINSTALLATION

To remove Tray Clock right-click on its icon in the taskbar and select Properties from pop-up menu or double-click the icon. Check Uninstall Tray Clock and click OK button.

	USAGE

In order to activate menu of the program just click right button of the mouse. The menu consists of three items: Properties, Be silent and Close.
Also the menu may include several items indicating time in places of different time zones. This feature can be easily configured in Tray Clock Properties. Tray Clock Properties are accessed by either right-clicking on its icon in the system task bar and selecting Properties or by double-clicking on the icon. Properties include tab control of three pages.

In the first page (Setup):
- Striking and voices causes the program to be
	silent when unchecked.
- Multistrike hours specifies striking each n's hour
	n times when checked.
- Strike half hour specifies striking each half hour
	when checked.
- Voice hours specifies voicing each hour
	when checked.
- Voice half hours specifies voicing each half hour
	when checked.
- Test 2:00 and Test 17:30 causes the program
	to test sounds.
- Switch AM and PM voice messages.
- Hide icon removes icon from the system task bar.
- Close Tray Clock exits the program.
- Uninstall Tray Clock removes the program
	from the system.
- Time zones has an example of various time zones
	for indication of current time in menu:
	+9 in Singapore
	-7 in San Francisco
	+4 in Moscow

The second page (Table) allows to record new sounds and voices from microphone or other input lines and edit time-table for playing additional sound and voice files at planned time. File TrayClock.wav is used as temporary file for saving recorded sounds. The time-table is saved in TrayClock.ini file in the following format:
[weekday, month DD] - section format
<HH:MM>=<FilePath> - item format for wav or mid file to play at HH:MM
Section format may varies as following:
[Everyday] - section to be played every day
[Today] - section to be played only this day
[Tomorrow] - next day this section becomes [Today] section
[PowerOn] - in this section time counts out from power on
[DD] - section to be played only on DD day every month
[Monday] - section to be played only on mondays
[Friday, 13] - section to be played when current day coinsides with stated
[August] - section to be played every day in august
[December, 31] - section to be played on stated day
[Friday, April] - section to be played on fridays in april

TrayClock.ini file looks like following example:
- - - - - - - - - - - 
[Main] - program's settings (don't change it)
Flags=...

[Everyday]
08:45=C:\Windows\Good_morning.wav
17:00=C:\Windows\Five_o_clock.wav
17:01=C:\MEDIA\Sonata.mid

[Friday]
17:30=C:\WAVMSG\CallJohn.wav
17:55=C:\WAVMSG\EnjoyWeekend.wav

[Monday]
10:00=C:\WAVMSG\HowWeekend.wav

[01]
10:00=C:\Windows\NewMonth.wav
10:05=CleenScreenIDontSeeYou.wav

[September 22]
10:00=C:\Windows\Birthday.wav
10:01=C:\MEDIA\Birthday.mid
- - - - - - - - - - - 
It is quite clear that every day at 8:45 the program will play Good_morning.wav, at 17:00 - Five_o_clock.wav and in a minute Sonata.mid. Every friday the program will play CallJohn.wav, every first day of month - NewMonth.wav, etc.
To get pop-up menu for editing time-table right-click tree window in page Schedule.This file may be modified manually. To modify time-table drag and drop feature is also available.

The third page (Help) contains reliable copy of TrayClock.txt file. The file TrayClock.txt might be corrupted or modified by incident or premeditately.

	COMMENTS

If you have any questions, comments, or suggestions about Tray Clock, or if you want the program speak other language, then feel free to contact me at yura.salnikov@usa.net.

	DISCLAIMER

Tray Clock is available free of charge. Please copy it, send it to others, and use it where-ever you will.
This program may not be sold for profit. The program is provided "as is" with no guarantee. Use Tray Clock at your own risk. No responsibility will be taken for any special, incidental, indirect, or consequential damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use the program.

	MORE INFORMATION 

Tray Clock is a simple program. It can hardly make me a lot of money. But a little income would be nice and rather helpful. To register please notify me at email yura.salnikov@usa.net that you have sent $5.00 (U.S.) to:

SAVING OF THE RUSSIAN FEDERATION
MOSCOW BANK
ZHELEZNODOROZHNOYE BRANCH
N 8180/01518
ACC: 30301840838000603808
ACC: 42301.840.8.3808.1200221
SALNIKOV YURI VALENTINOVICH

or to my address:

Marshal Fedorenko st. 10-2-314
Moscow 127599 Russia

Reliable copy of my account or address should be taken from About page in properties dialog. Registration will ensure that you are notified of all updates and my new programs. Next version of the Tray Clock program will speak Russian, have an ability to record sounds in different formats.
# Levels of importance for messages will be available in next version of Striking Tray Clock.
-------------------------------------------------------------------
Yuri Salnikov
Programmer ++
