aos subtitle

Narrate what an agent is doing, on screen, without taking focus

3 commands. Run aos subtitle --help for the same list from the binary, or see every group.

A film-style caption over the screen, bottom-center by default, for narrating what an agent is doing without taking focus. A new caption replaces the last one; stop clears it; test shows a sample. See subtitles.

Commands

aos subtitle show

Show a film-style caption over everything (or over one app’s window) for a few seconds

needs a display

aos subtitle show <text...> [--seconds=<n>] [--app=<name> | --title=<s> | --monitor=<n> | --rect=<x,y,w,h>] [--position=bottom-center|top-center|center|left|right|top-left|top-right|bottom-left|bottom-right] [--margin=<px|N%>] [--offset=<dx,dy>] [--size=S|M|L|XL|<px>] [--color=<text colour>] [--bg=auto|none|<colour>] [--font=<name>] [--weight=regular|bold] [--align=left|center|right] [--max-width=<px|N%>] [--detach] [--wait] [--preview=<out.png>] [--json]

flag	values	meaning
<text...>		Required positional argument
--seconds	<n>	Optional
--app	<name>	Optional
--title	<s>	Optional
--monitor	<n>	Optional
--rect	<x,y,w,h>	Optional. comma-separated
--position	bottom-center, top-center, center, left, right, top-left, top-right, bottom-left, bottom-right	Optional
--margin	px, N%	Optional
--offset	<dx,dy>	Optional. comma-separated
--size	S, M, L, XL, <px>	Optional
--color	<text colour>	Optional
--bg	auto, none, <colour>	Optional
--font	<name>	Optional
--weight	regular, bold	Optional
--align	left, center, right	Optional
--max-width	px, N%	Optional
--detach		Optional
--wait		Optional
--preview	<out.png>	Optional
--json		Optional

aos subtitle show "installing dependencies"
aos subtitle show "Now I'm opening Safari" --app=Safari --position=bottom
aos subtitle show "running the migration" --seconds=30 --position=top
aos subtitle show "step 1 of 3" --seconds=4 --wait
aos subtitle stop
# white on a translucent dark pill, bottom-center, 8% up; a new caption replaces the last

aos subtitle stop

Remove the caption on screen

needs a display

aos subtitle stop

aos subtitle stop

aos subtitle test

Show a short sample, to check subtitles work on this machine

needs a display

aos subtitle test

aos subtitle test