{"id":24,"date":"2025-10-09T06:05:25","date_gmt":"2025-10-09T10:05:25","guid":{"rendered":"https:\/\/beckesch.dev\/ops\/?p=24"},"modified":"2025-10-29T04:47:27","modified_gmt":"2025-10-29T08:47:27","slug":"how-a-2010-shell-script-keeps-the-music-playing-on-your-pbx","status":"publish","type":"post","link":"https:\/\/beckesch.dev\/ops\/2025\/10\/09\/how-a-2010-shell-script-keeps-the-music-playing-on-your-pbx\/","title":{"rendered":"How a 2010 Shell Script Keeps the Music Playing on Your PBX"},"content":{"rendered":"\n

Back in 2010, telephony systems often required a practical solution for delivering music on hold. Professional hardware and software components could be costly or inflexible, but for those comfortable with Linux, simple shell scripts offered an adaptable alternative. The following blog post explores a classic Bash script that continuously feeds a telephone system with MP3 files, ensuring that callers are always greeted with music when they are on hold.<\/p>\n\n\n\n

What Does the Script Do?<\/h2>\n\n\n\n

The script is designed to play all MP3 files found in a configured directory, looping through them endlessly. The typical use case is to provide ‘waiting music’\u2014music on hold\u2014for PBX (Private Branch Exchange) systems. The shell script leverages standard Linux tools, with the MP3 player mpg321<\/code> serving as the playback engine.<\/p>\n\n\n\n

Configuration<\/h2>\n\n\n\n

All configuration options are stored in a separate file (default: \/usr\/local\/etc\/telko-musik.sh.conf<\/code>). The most important setting is mp3dir<\/code>, which specifies the directory containing MP3 files:<\/p>\n\n\n\n

mp3dir=\/usr\/local\/mp3<\/code><\/pre>\n\n\n\n
How the Script Works<\/h2>\n\n\n\n
    \n
  1. Environment Setup:<\/strong>
    The script checks for its configuration file and sources it. It then verifies if the mp3dir<\/code> exists.<\/li>\n\n\n\n
  2. Process Management:<\/strong>
    Several helper functions are defined for logging, error handling, debugging, and cleanup.<\/li>\n\n\n\n
  3. Argument Handling:<\/strong>
    It accepts arguments for verbosity, a running-check mode, and help.<\/li>\n\n\n\n
  4. File Copying:<\/strong>
    The script copies all MP3s into a temporary directory, reducing the risk of issues if files are changed during playback.<\/li>\n\n\n\n
  5. Main Playback Loop:<\/strong>
    It iterates over all MP3 files in the temporary location, playing them one by one with mpg321<\/code>. It sleeps briefly between tracks and repeats indefinitely.<\/li>\n\n\n\n
  6. Dynamic Updates:<\/strong>
    Because the script periodically re-reads the contents of the specified directory (after each loop iteration), new MP3 files will be detected without needing to restart the script.<\/li>\n<\/ol>\n\n\n\n
    How to Use the Script<\/h2>\n\n\n\n
      \n
    1. Install mpg321:<\/strong>
      Ensure the MP3 player mpg321<\/code> is installed on your Linux system.<\/li>\n\n\n\n
    2. Set up MP3 Directory:<\/strong>
      Place all hold music MP3 files in the directory specified by mp3dir<\/code>.<\/li>\n\n\n\n
    3. Configure the Script:<\/strong>
      Edit \/usr\/local\/etc\/telko-musik.sh.conf<\/code> to point mp3dir<\/code> to the correct folder.<\/li>\n\n\n\n
    4. Run the Script:<\/strong>
      Execute the script with .\/telko-musik.sh<\/code> (preferably as a dedicated service or background process).<\/li>\n\n\n\n
    5. Integration with PBX:<\/strong>
      Make sure your telephone system\u2019s hardware is set to accept the audio output generated by the script.<\/li>\n<\/ol>\n\n\n\n
      Advantages of This Approach<\/h2>\n\n\n\n