RINGTONE - Play a ringtone or ringtone file. A ringtone is a RTTTL format monophonic series of notes.

When to use it

Use RINGTONE to play a custom (or system) ringtone sound, with optional vibration.

Syntax 

  RINGTONE {--vibrate} [rtttl - or - filename]

–vibrate (optional)

Vibrate in sync with the ringtone

rtttl or filename

Play the supplied RTTTL ringtone, or play a RTTTL file.

To play a custom ringtone, use the entire RTTTL ringtone as an argument.

To play a ringtone file, pass the name of the file. Ringtones are automatically played from /root/ringtones/.

Results

RINGTONE will exit with an error if another ringtone is currently playing.

Examples 

  # Play the default `alert.rtttl` ringtone, with vibration
RINGTONE --vibrate "alert"
  
  # Play a custom ringtone
RINGTONE "custom:d=16,o=4,b=200:8e4,8g4,8a#4,8d5,8b6"