saytime(1)

saytime1

Audio time check

Usage

saytime [-ch] [-d dir] [-f fmt] [-o dev] [-t output-type]

Overview

saytime speaks the current time through the computer's sound device.

Options

-v factor

Increase volume level by factor. Directly passed on to sox.

-r sec

Repeat at the specified interval in background mode.

-c

Output to stdout.

-d dir

Use sounds from alternate directory (default /usr/share/saytime).

-f fmt

Specify format of time message. (see FORMAT STRING below).

-h

Display simple help.

-o dev

Output to alternate file. If -t is not specified with -o, -t defaults to ossdsp.

-t output-type

Specify the output type (oss, alsa, etc.); this is passed directly to sox. If neither -t nor -o is specified, saytime will pick a default destination via sox -d.

Format string

A format string can be specified to control the time message. Valid format characters are:

%k

hour, 24-hour clock (00..23)

%l

hour, 12-hour clock (01..12)

%M

minutes

%P

Introductory phrase ('The time is')

%S

seconds

The default format string is %P%l%M%S.

Contributors

Jef Poskanzer (original author),

Patrick J. Edwards <[email protected]>

Charles Briscoe-Smith <[email protected]>

David C Dawson <[email protected]> (the -v and -r options)

Releases

15 releases since Debian 1.3 (Bo); the text changed 5 times.

  1. 1.3
  2. 2.0–2.1
  3. 2.2
  4. 3.0
  5. 3.1–5.0
  6. 7–13

-c since Debian 3.0 (Woody); -h since Debian 3.0 (Woody).

-d until Debian 3.0 (Woody); -f until Debian 3.0 (Woody); -o until Debian 3.0 (Woody).

Bugs

Likely a few. It doesn't handle errors gracefully.

From saytime 1.0-36 in Debian 13 (Trixie). Parsed by carta from the page's man source.