AiPBX
Features Install Videos Mobile Docs Live demo Contact Sponsor on GitHub UpCloud ($250 Free Credit) YouTube GitHub
ODOO Connect AiPBX with Odoo CRM & ERP — manage calls & customers in one place. Try Odoo Free →
Home / Documentation / Sounds & languages

Sounds & languages

Where sounds live

PathContent
/var/lib/asterisk/sounds/custom/sounds uploaded on Sounds (IVR, announcements, queues)
/var/lib/asterisk/sounds/tr/Turkish system prompts shipped in sounds/tr/ of the repository
/var/lib/asterisk/moh/music on hold
/usr/share/asterisk/sounds/en/English prompts (Debian package)

Debian's Asterisk searches prompts under /usr/share/asterisk/sounds. The installer links /usr/local/share/asterisk/sounds (Debian's custom directory) to /var/lib/asterisk/sounds/custom and /usr/share/asterisk/sounds/tr to /var/lib/asterisk/sounds/tr. Without these links IVRs, announcements and Turkish prompts fail with "File … does not exist in any format" and the call is hung up. The links live outside dpkg-owned files, so package upgrades keep them.

Asterisk plays 8 kHz mono WAV (16-bit PCM). Uploads (announcements, IVR prompts, music on hold) may be WAV, MP3 or another common format and are converted to that on upload. A file may be up to 64 MB; a refused upload says why (too large, or the upload broke off). Uploaded files with the same name as a shipped file are never overwritten by updates.

Queue callback announcements

Manual queue callbacks, available since 1.75.0, use two recordings selected in the queue form:

RecordingWhen it playsSuggested text
Periodic announcementRepeated while the caller waits, at the queue's configured interval“To request a callback on the number you are calling from, press 1. Otherwise, please continue to hold.”
Callback confirmation announcementOnce, after the callback request is saved; the PBX then hangs up“Your callback request has been received. Our agents will call you on this number. Thank you.”

Add the recordings on Sounds, then select them on Queues. Enabling callbacks requires both an active confirmation announcement and a periodic announcement with an interval greater than zero. The PBX does not generate the spoken confirmation from its interface label; supply the recording in the language your callers expect. A failed request does not play the success confirmation.

An announcement referenced by a queue cannot be deleted. Choose a replacement on the queue first, save and Apply, then remove the unused recording.

Languages

A call uses the language set on its inbound route. When a prompt is missing in that language Asterisk plays the English one, so a partly translated set gives mixed-language prompts.

Turkish prompts

The Turkish set ships at the repo root as one package per format, asterisk-core-sounds-tr-<format>-<version>.tar.xz (with asterisk-core-sounds-tr-<version>.SHA256SUMS), laid out like Asterisk's own asterisk-core-sounds-* packages so it can be used on any Asterisk server: extract the formats you need into the tr sounds directory.

  • One voice (Google tr-TR-Wavenet-C), generated with AiPBX Cloud TTS from 16 kHz masters: every Asterisk core prompt (same names as asterisk-core-sounds-en, including voicemail, digits, letters, phonetic, conference, queue and directory prompts) plus AiPBX's own prompts.
  • Every prompt in six formats: wav (8 kHz), ulaw, alaw, gsm and the wideband (HD) g722 and sln16. Asterisk picks the one matching the call's codec, so no transcoding is needed.
  • Tones (beep, ascending-2tone, …) come from the English set; silence/1..10 are generated.
  • Licence: CC BY-SA 4.0 (tones: CC BY-SA 3.0, Digium).

Installs and updates extract the newest package into /var/lib/asterisk/sounds/tr/, replacing the prompts it contains (and removing other-format copies of the same names); other files in that directory are left alone.

To change a text, edit sounds/core-sounds-tr.txt (name|text), regenerate the masters (Google must be configured under AI → Cloud TTS) and rebuild the package:

sudo php web/bin/generate_tr_sounds.php --out=/tmp/tr-master             # all prompts
sudo php web/bin/generate_tr_sounds.php --out=/tmp/tr-master vm-intro    # or only some
scripts/build_tr_sounds.sh /tmp/tr-master 1.0.1

build_tr_sounds.sh needs every prompt's master in the directory; to rebuild with only a few changed prompts, first extract the current package's .sln16 files back to WAV masters (sox -t raw -r 16000 -e signed -b 16 -c 1 NAME.sln16 NAME.wav).

Asterisk has no Turkish number/date grammar, so SayNumber, dates and voicemail message counts follow English word order; the texts are worded to stay natural in that order (e.g. vm-youhave = "Posta kutunuzda").

View or edit this page on GitHub

On This Page