beep(1)

beep1

Play a beep sound

Usage

beep [-Bh] [-D duration_ms] [-F frequency_hz] [-d oss_device] [-g gain] [-r sample_rate_hz]

Overview

The beep utility is used to play a beep on the sound card.

The options are as follows:

-B

Runs the beep utility in the background.

-D duration_ms

Sets the duration of the beep in milliseconds, between 50 ms and 2000 ms inclusively. The default is 150 ms.

-F frequency_hz

Sets the center frequency of the beep in Hz. The default is 440 Hz.

-d oss_device

Sets the OSS device to use. The default is /dev/dsp.

-g gain

Sets the waveform gain, between 0 and 100 inclusively. The default is 75.

-h

Display summary of options.

-r sample_rate_hz

Sets the sound card sample rate in Hz, between 8000 Hz and 48000 Hz inclusively. The default is 48000 Hz.

Examples

Play default beep sound on /dev/dsp:

$ beep

Releases

14 releases since FreeBSD 13.1-RELEASE; the text changed 5 times.

  1. 13.1–13.2
  2. 13.3–14.2
  3. 14.3
  4. 14.4–14.5
  5. 15.0
  6. 15.1–16.0

History

The beep utility first appeared in FreeBSD 14.0.

Authors

Hans Petter Selasky ⟨[email protected]⟩

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.