Moo Man 1.00
-------------
Copyright (c) 2004 Piotr Chodzinski


Description
============
Moo Man is a very easy to use program. It's designed to make Distributed.net's participants life much better. This application can play a random sound every time Distributed.net client finishes a packet from RC5-72 or OGR project. Using default set of sounds you can turn your boring set of electronic circuits that makes your PC into your personal cow that loves you and moos time-to-time especially for you :). And that's really something for 'cow projects' fans ...

Features
=========
First releases of Distributed.net client had similar functionality embedded. But in the next versions mooing option was removed from the main exe file of the client to make it a bit lighter in size. Many people didn't like the change so there was made a program called Moo Sounds, to repair this lack in the client. Moo Man is much better than original Moo Sounds because of these features:
* Moo Man supports newest version of the client, so both RC5-72 and OGR-25 projects are supported,
* this program was very carefully written and tested, so it will not use too much of memory or system resources, so the main client can work as smooth as it's possible,
* you can choose which project this application should monitor or even temporary disable monitoring,
* this program stays hidden in the System Tray. You can hide this icon so the presence of the program won't be noticeable at all,
* Moo Man can be easy configured to suit your needs by changing frequency of the client's folder monitoring operation (see How does it work section for more details),
* this application automatically detects client's directory. You can also specify it manually in special situations,
* there's a possibility to replace sounds shipped with the program with other.

License
========
Moo Man is a program distributed as Freeware. That means that you can use it for free for private and commercial purposes (e.g. you can use it in office). If you like it you can send me - as a token of gratitude - a postcard of your town, small amount of money, or if you work in some company a small gadget from it. You must remember then that you are doing this only from your own will, because this program is totally free.
This software was tested carefully, but the author doesn't take any responsibility for any possible damages in user's data, software, hardware or reputation.
You musn't decompile, disassemble it or take any other actions aiming at program modification.
If you're going to publish this software on any CD or website you must contact me first to get my permission !!!
Moo Man copyright (c) 2004 Piotr Chodzinski. All rights reserved.

Installation
=============
Installation procedure is very easy. Just follow these steps:
* extract all the files from mooman.zip archive to a newly created folder of your choice (e.g. C:\Program Files\Moo Man\),
* run file called MooMan.exe,
* using your right mouse button over the new cow-icon placed in the system tray, bring up a pop-up menu. Choose Configuration from this menu,
* next click Path to client > Detect and Startup > Add buttons,
* finally confirm these changes using OK button,
* that's all, now on every system boot-up Moo Man will be started automatically.
If you want you can make other changes in the Configuration dialog (see next section).

Configuration
==============
You can bring up Configuration dialog by choosing Configuration option from the pop-up menu of the tray icon. Here're the options you'll find there:
* Path to client - this label shows a directory where distributed.net client is installed in. If the whole text is not visible just hover your mouse cursor over it for a while,
* Path to client > Detect - after using this button path to the client will be automatically detected by reading specific key from the registry,
* Path to client > Choose - this button allows you to choose client's directory manually, this can be useful if automatic detection failed,
* Check files every > x seconds - entered number is a time between each run of files checking procedure (see also How does it work section). This number should be from 1 to 999 seconds, but entering a value from 1 to 10 is not recommended,
* System Tray > Show icon - if this checkbox is checked then there will be a small cow icon visible in the System Tray (near the clock). This icon gives you access to a pop-up menu (just right-click the icon to see the menu). In this menu you will find few options:
   - Mooooo - guess what it can do :),
   - Configuration - shows Configuration dialog,
   - About - shows aboutbox with informations about program version and contacting me,
   - Close - closes this application,
* Monitor projects > RC5-72/OGR - these two checkboxes allows you choose which projects should be monitored by the program at the time,
* Startup > Add/Remove - using these two buttons you can add or remove shortcut to Moo Man from Startup group. This allows the program to run every start of your operating system,
* OK - confirm and save changes,
* Cancel - cancel and undo all changes.

How does it work
=================
If you're curious how does this program works, it's rather very simple thing. Just after starting Moo Man searches for two files named 'buff-out.r72' and 'buff-out.ogr' in the specified directory. These files are used by the client to store finished packets. Next Moo Man  application writes down size of those files and periodically checks it. If the size differs from the earlier, that means client wrote finished packets to one of these files or emptied it to send all the packets. In such case application plays a random sound. Note that the list of the sounds is built every played sound to avoid error handling for removed sound etc.

FAQ - Frequently Asked Questions
=================================
Q: I've unchecked Show icon option but I want to change configuration. How can I do this when there's no cow icon in the tray ? 
A: Just delete MooMan.ini file located in the program directory and restart this application. All options will be switched to default.
Q: Did you hide an Easter Egg here ?
A: Of course, as always :). Try to find it.

Version history
================
* Version 1.00 (31st March 2004) - initial public release. All options are working.

Special thanks
===============
Here're special thanks that goes to:
* my sister Justyna for correcting this help file and for big moral support,
* author of the Moo Sounds for sharing with source, that was very useful to me when writing this software.

Contact
========
If you have any questions, you have found a bug, or just want to write me, you can send mails to the below address. I'll answer to every e-mail !  Remember to write me only in English or Polish !!!

aionel@poczta.onet.pl

If you know Polish you can visit my homepage wit other great programs:

http://www.republika.pl/programyaionela

Send postcards (see License for more details) to the below address:

Piotr Chodzinski
ul. Jasna 4/3
44-100 Gliwice
POLAND

If you don't know what are projects like RC5 or OGR you should check the cooridnators' page:

http://www.distributed.net

or read articles concering RC5-64 and RC5-72 projects on my homepage (sorry, only in Polish).

Thank you for reading this help file to the end.
I'm sure that you'll be able to use all features of my program now.
Happy moooing in Distributed.net's projects with this tool.

No cow was harmed during production of this program :).


Program and help file completed on 1st April 2004 at 19:01:12