Happy Amiga Clock 1.0
=====================

Happy Amiga Clock is a fullscreen clock for Commodore Amiga computers.
It can display a digital clock with the date or an analog clock face.
The program is a native and independent AmigaOS implementation inspired
by HappyPlusClock.

The embedded monochrome font is drawn with the Amiga blitter, so no
external fonts are required. Happy Amiga Clock can be started from the
Shell or from its Workbench icon and is compatible with Kickstart 1.3.

Main features
-------------

- Digital and analog fullscreen modes
- Optional seconds display
- Optional hourly two-note chime
- Automatic light/dark color inversion
- Optional split-flap digit animation and mechanical sound
- Date with abbreviated weekday in digital mode
- Mouse pointer hidden after 10 seconds of inactivity
- Exit with the left mouse button, Esc, or Ctrl+C from the Shell

Installation
------------

Copy HappyAmigaClock and HappyAmigaClock.info to the desired directory.
No additional fonts, libraries, or data files are required.

Shell usage
-----------

On AmigaOS 2.0 or later, options can be supplied on the command line:

  HappyAmigaClock ANALOG=NO FLIP=YES SECONDS=YES MODE=DARK

ReadArgs() is not available on Kickstart 1.3. On that system the program
starts with its default settings and ignores Shell arguments.

Workbench ToolTypes
-------------------

The following options can be added to the icon ToolTypes:

  SECONDS=YES|NO
  INVERT=0|1..65535
  MODE=LIGHT|DARK
  DATEALWAYS=YES|NO
  CHIME=YES|NO
  ANALOG=YES|NO
  FLIP=YES|NO
  FLIPSOUND=YES|NO

ON|OFF and TRUE|FALSE can also be used in place of YES|NO.

Defaults
--------

  SECONDS=YES
  INVERT=720
  MODE=LIGHT
  DATEALWAYS=NO
  CHIME=NO
  ANALOG=NO
  FLIP=NO
  FLIPSOUND=NO

INVERT specifies the number of minutes between color inversions. A value
of zero disables automatic inversion. FLIPSOUND is used only when FLIP is
also enabled. The date is not displayed in analog mode.

Version
-------

The executable contains this standard version tag:

  $VER: HappyAmigaClock 1.0 (26.07.2026)

License
-------

Happy Amiga Clock is distributed under the MIT License. The embedded
font bitmaps are generated from Roboto Light, Copyright 2011 Google Inc.,
distributed under the Apache License 2.0.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                34952   34952 100.0% -lh0- 7323 Aug 25 22:00 HappyAmigaClock
[generic]                 1107    1107 100.0% -lh0- 68e7 Aug 25 22:00 HappyAmigaClock.info
[generic]                 2474    2474 100.0% -lh0- f7a3 Aug 25 21:34 Readme.txt
[generic]                  478     478 100.0% -lh0- cb3b Aug 25 21:58 Readme.txt.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         4 files   39011   39011 100.0%            Sep  7 01:20