Honk 1.5 build: 9639 released: 2009-03-11

Play Windows system sounds or play wav files from the command line..

Copyright: (c) 2017 Canadian Mind Products.

C++ command line utility.
Download from: http://mindprod.com/products3.html#HONK

----

Notes:

This program can only be used from the command prompt, (or via an command
line style icon shortcut) e.g. under Windows command.exe or JPSoft
tcmd.exe, formerly called the DOS box. Just clicking the programs in a
directory listing will not do anything useful. Just typing the program
names at the command prompt will not either.

This program requires a manual install! See below.

This program works with vanilla text files, (e.g. ASCII files or UTF-8
Unicode files). You will need a text editor to create and view them, not a word
processor. e.g. notepad, Visual Slick Edit or other suitable text editor
http://mindprod.com/jgloss/editor.html. You must use a monospaced font
http://mindprod.com/jgloss/monospacedfonts.html (aka fixed pitch, aka
programmer font) to view your files, or they won't look properly aligned.

I put out an avalanche of free software into the world, and submit PAD
files to hundreds of distribution sites, but I rarely hear back from
anyone.  What's happening?  Does it all just work fine?  It is so
complicated nobody can figure out how to use it and they give up on it?
It is it useful?  Since everyone has the source, do people just fix the
programs to their liking themselves?  Did you have trouble installing?  Do
I presume you know too much?  I would be happy to hear from you about your
experiences, positive or negative and your requests for improvements.  A
one-line email to roedy@mindprod.com would be great.

===> Free <===
Full source included.
You may even include the source code, modified or unmodified
in free/commercial open source/proprietary programs that you write and distribute.
May be used freely for any purpose but military.
For more details on this restriction, see
http://mindprod.com/contact/nonmil.html
If you include any Canadian Mind Products code in your own applications,
your app too must be labelled non-military use only.
http://mindprod.com/contact/nonmil.html
All C++ source and EXE files code are included.

----

Prerequisites:

This program runs under Microsoft Windows from the command line (e.g. Win2K/XP/Vista)

----

Installing on a PC:

Download source and executable files to run on your own machine as a standalone utility.
To install, extract the zip download with WinZip
(or similar unzip utility) into any directory you please,
often J:\ --  ticking off the <span class="click">use folder names</span> option.

----

Installing on a MacIntosh:

Use Safari to download source and executable files to run on your own machine as a standalone utility.
The EXE files will not work. You will have to recompile, perhaps making minor changes to the source code.
Safari will automatically unpack the zip into ~/Downloads (version 10.5)
[or on the Desktop (version 10.4 and earlier)].
First install a recent Java JDK or JVM.
See http://mindprod.com/jgloss/installingjava.html.
You may optionally move the download tree to a permanent home.

----

Rebuilding:

The zip already contains the necessary exe, so unless you modify
the program, there is no need to recompile the source or recompile it.
Configure.java basedir="E:/" in rebuild.xml to the drive where your files are and tweak rebuild.xml.
Use ANT and rebuild.xml, not build.xml, to rebuild and link.

----

Use:

Honk Plays one or more of the Standard Windows sounds, triggered
purely from the command line.
use:
  honk
     - Plays the default system sound.
  honk  SystemStart SystemHand SystemQuestion
     - Plays the given list of standard system sounds (usually just one).
     - they are case-insensitive (you can get the case wrong and it will still work).
Possible sound names are listed in the registry under:
       HKEY_CURRENT_USER/AppEvents/EventLabels.
e.g.
ActivatingDocument
AppGPFFault
BuildComplete
BuildError
BuildWarning
ClipMate5_EmptyClipboard
ClipMate5_Glue
ClipMate5_IgnoreClipboardUpdate
ClipMate5_NewData
ClipMate5_PowerPasteComplete
Close
CriticalBatteryAlarm
EmptyRecycleBin
Incoming-Fax
LowBatteryAlarm
MailBeep
Maximize
MenuCommand
MenuPopup
Minimize
MoveMenuItem
Navigating
Open
Outgoing-Fax
RestoreDown
RestoreUp
RingIn
RingOut
ShowBand
SystemAsterisk
SystemDefault
SystemExclamation
SystemExit
SystemHand
SystemQuestion
SystemStart
SystemWelcome
...
e.g., play two standard sounds in the current theme:
  E:\sys\honk.exe SystemQuestion  SystemExit
You can view the list of possible sounds with regedit.  Not all of them
are necessarily hooked up to real sounds and not all of them will be in
your registry.  What sounds they play depends on how they are configured
in the control panel.  If you were daring you could even add your own and
configure them.  These are NOT the same as the names in the control panel
or the names of the *.wav files.
Or you can specify a specific wav file e.g.
  E:\sys\honk.exe "C:\Windows\Media\Quirky\Windows Feed Discovered.wav"
You must specify the fully qualified wav file name, and put the name in
quotes.  An can be anywhere on any drive.  Usually, it will somewhere in
the C:\Windows\Media\* tree.
The following will NOT work:
E:\sys\honk.exe "Windows Feed Discovered.wav"
Honk is much faster than using mplayer or player. Nothing appears on the
screen. It will not hang up if several copies try to play at once.
C++ source included.


----

Version History:
                1990-01-01 1.2 made library static so don't need separate Borland DLLs.
                Compile as a Borland Win32 Owl app with a static library, link no debug, and
                OWL libraries with a honk.def file.

 1.3 1998-11-07 embed new Barker address.

 1.4 2008-01-04 convert from Owl to Microsoft

 1.5 2009-03-11 update list of system sounds.

-30-