Herald 1.2 -- 14.10.2026
WHAT IT IS
Herald is a commodity that shows pop-up notifications. A program sends it
a short message; Herald puts it on screen for a few seconds and keeps it
in a notification center you can open later.
Nothing takes the focus and nothing waits for an answer. A click sends a
notification away, a double-click brings the program that sent it to the
front.
Demonstration video available at: https://youtu.be/giNNSHTGTT0
WHAT IT DOES
* Notifications from any program that can talk ARexx, or from any
Shell script through the included HeraldSend command
* A progress bar with a Stop button for a Shell command that only
prints, such as LhA or xadUnFile, through the included HeraldPipe
* Eight looks, including translucent ones on a graphics card, and six
ways for a notification to arrive
* Themes of your own: a text file, chosen in the settings window, and
the included ThemeCheck command to say what is wrong with one
* Priorities, with a sound per band and urgent ones marked
* Stacked, one at a time, or grouped per program
* Progress bars an application drives, with Pause and Stop buttons
* Emoji pictures for :shortcodes: in the text, on 16 colours or more
* A notification center that keeps what you were away for
* Do not disturb, on a hotkey or on a clock
* Snooze: shift-click a notification and it comes back later
* A settings window with context help, or the same settings as icon
tooltypes
* Scripts can ask what this Herald understands, and a program that
needs a newer one says so on screen instead of failing in silence
WHAT YOU NEED
AmigaOS 3.1 (V40) or newer, and a 68000. The server runs on a 4 KB stack.
Recommended is AmigaOS 3.9 with BoingBag 2, or newer: that is what Herald
is tested on. 3.1, also with ClassAct, is not tested.
Five of the looks want a 15, 16, 24 or 32 bit screen: the translucent
ones, and for now Paper and Kickstart. The settings window marks them
(RTG). On fewer colours they fall back to a plain look and nothing else
changes.
ARexx scripts need RexxMast, which the standard Startup-Sequence starts.
Shell scripts do not: HeraldSend and HeraldPipe talk to the port directly.
HeraldPipe reads a Shell pipe, which AmigaOS has had since 3.9.
The settings window needs the ReAction classes of AmigaOS 3.9 or newer.
Without them Herald still runs, and every setting can be made on its icon
or on the command line instead.
INSTALLING
Unpack, open the drawer and double-click Install.
Everything goes into one drawer, and one assign called Herald: is added
to S:User-Startup. The installer offers to copy Herald into SYS:WBStartup
so it starts with Workbench.
To remove it: delete the drawer, delete SYS:WBStartup/Herald,
C:HeraldSend, C:HeraldPipe and C:ThemeCheck if you installed them, and
remove the ;BEGIN Herald block from S:User-Startup.
FOR PROGRAMMERS
The ARexx port is HERALD. Any program that can address an ARexx port can
send a notification; no ARexx interpreter has to be running for it.
The complete interface is in the AmigaGuide help. The same reference
comes as one plain Markdown file in the Developer drawer, for writing
scripts with an AI assistant.
The Developer drawer also holds the whole source of the HeraldSend and
HeraldPipe commands, with a Makefile for GCC and an SMakefile for SAS/C:
a working Herald client, meant to be copied.
HISTORY
1.2 (14.10.2026)
- the center looks see-through, frosted or solid, and opens at once
- more fits on small screens; urgent notifications are marked
- translated notifications, a transparency slider, tidier settings
- line breaks from ARexx and the Shell are kept
- icons given as IMG= are drawn transparent (reported by yelworC)
- pictures keep their proportions on graphics cards
- many fixes from a full code review
1.1 (4.10.2026)
- added the looks Midnight, Paper and Kickstart
- added themes of your own, and ThemeCheck to check them
- the settings window marks the looks that need a graphics card
- added menus and an About window to the settings window
- the settings window shows its hotkey in the title bar
1.0 - initial release
LICENCE
Herald is free for private use; the LICENSE file in the archive has the
terms. The unmodified archive may be distributed through Aminet, on Aminet
CDs and on magazine cover disks without asking first, and the HeraldSend
source in the Developer drawer may be copied into your own programs.
The emoji artwork is from the OpenMoji project and is licensed CC BY-SA
4.0; its licence file travels in the Emoji drawer and must stay there.
All emojis designed by OpenMoji - the open-source emoji and icon project.
License: CC BY-SA 4.0
THANKS
Martin "Mason" Merz drew the GlowIcons. Each one shipped is Herald's own
classic icon with his colour imagery appended, so it shows his artwork on
AmigaOS 3.5 and newer and the plain icon on everything older; the
Installer offers them. He also drew Herald's own picture, which a
notification wears when it brings none of its own and the Default image
setting is on.
|
aminet net>