MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start your own streaming platform
    1. Change account currency
    2. Product Licensing
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Wowza Streaming Engine
        3. Flussonic Media Server
        4. Video Feature Comparison
        5. Icecast 2 / Icecast KH
        6. Shoutcast 2
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
      2. Clientexec Integration Guide
      3. Blesta Integration Guide
      4. WiseCP Integration Guide
    4. Migrate from other software
      1. Migrate From Centovacast
      2. Migrate From AzuraCast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. MediaCP System Commands
      2. Admin Tools
      3. Custom Web Service Configurations
      4. Change MediaCP domain name
      5. Port 80 / 443 Proxy
      6. Move media to another hard disk
      7. Custom Language Translations
      8. Custom Facebook App
      9. Secure your server
      10. Setup CSF Firewall
      11. Troubleshooting Login Errors
      12. Reset Admin Password
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Grant access to support team
      2. Troubleshooting Wowza Streaming Engine
      3. FTP Troubleshooting
      4. MySQL Database Troubleshooting
      5. Reporting Troubleshooting
      6. Troubleshooting Liquidsoap AutoDJ
      7. Video Relay Troubleshooting
      8. Disk Troubleshooting
    1. Introduction
    2. Administrators Dashboard
    3. System Configuration
      1. General
      2. Services
      3. Video Players
      4. Albums
      5. Email
      6. Plugins
      7. Statistics
      8. Backups
      9. Custom HTML
      10. Misc
    4. Customer Accounts
      1. Managing existing Customers
      2. Create a new Customer
      3. Deleting a Customer
      4. Login as another Customer
      5. Send email to Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Reseller Plans
      2. Create a Reseller Account
    6. Administrator Accounts
      1. Create a new Administrator
    7. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    8. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    9. Statistics
    10. Software Health
    11. Software Updates
    12. Email Templates
    13. API
    1. Introduction
    2. Audio Operation Manual
      1. Basics 101
      2. Station Overview
      3. Media Library
      4. Playlists
        1. General Rotation
        2. Jingles & Advertising
        3. Scheduling
        4. Repeat Protection
      5. Live DJ Connections
      6. Live Stream Recording
      7. DJ Manager
      8. Country Blocking
      9. Fallback, Backup and Intro Files
      10. Public Page
      11. HTML5 Player
      12. Stream Authentication
      13. Stream Proxy
      14. Widgets & Links
      15. Reporting
    3. Video Operation Manual
      1. Basics 101
      2. Service Overview
      3. File Manager
      4. Scheduling
      5. Streaming to Your Service
      6. Stream Targets
      7. GeoIP Country Locking
      8. Public Page
      9. Widgets & Links
      10. Reporting
    4. Reseller Operations Manual
      1. Reseller Dashboard
      2. Customers
      3. Media Services
    5. API
    1. Custom Domain Names
    2. Shoutcast 2 Admin Guide
    3. Wowza and Flussonic on same system
    4. Submit a feature request
    1. Getting started with Audio Streaming
    2. Icecast Live Broadcasting
    3. Shoutcast 2 Live Broadcasting
    4. Broadcasting with AutoDJ
    5. DJ Accounts
    6. GeoIP Country Locking
    7. HTML5 Audio Player
    8. Mount Points
    9. Managing Your Media
    10. Managing Media Using FTP
    11. Statistics
    12. Shoutcast 2 Premium
    1. Getting started with video streaming
    2. Live Streaming Overview
    3. TV Station Overview
    4. Ondemand Video Streaming
    5. Stream Recording
    6. GeoIP Country Locking
    7. VAST Advertising
    8. Relay & IP Camera
    9. Connecting your encoder
    10. Preparing Your Media Files
    11. Managing Media Using FTP
    12. Understanding Video Playlists
    13. Embedding player on your website
    14. Smooth Streaming and Content Transition
    15. Video Transcoding (Adaptive Bitrate Streaming)
    16. Stream Watermark​
    17. DVR Rewind
    18. Statistics
    19. Facebook Live Streaming
    20. Youtube Stream Publishing
    21. Twitch Stream Publishing
    22. Shoutcast 2 Stream Publishing
    23. Icecast Stream Publishing
    24. RTMP Stream Publishing
    1. Cloud Video Overview
    2. Admin Manual - Cloud Video
      1. Login to your cloud platform
      2. Dashboard - A First Look
      3. Branding your platform
      4. Team & Staff Members
      5. Plans & Customers
      6. WHMCS Billing Provisioning Module
      7. Activating VOD on Customer Plan
      8. API
    3. User Manual - Cloud Video
      1. Login to your video platform
      2. First Look
      3. Creating a Channel
      4. Channel Overview
      5. Broadcasting
      6. Recording
      7. Media Content
      8. Live Events
      9. Fallback Video
      10. 30 Minute Rewind
      11. TV Channels - 24x7 UGC
        1. TV Event Scheduling
      12. Video on Demand
      13. Relay Channels
      14. VOD Playlists
      15. Publishing
      16. Bandwidth Utilisation
      17. Viewing Analytics
      18. Publish Zoom Meetings
      19. Advertising
      20. Restreaming IP Cameras
    4. Video Guide Series
    5. Streaming Best Practices
    6. Feature Comparison
    7. Roadmap & Release Notes
Troubleshooting Liquidsoap AutoDJ

Last updated 7 days ago

Collect & Review AutoDJ (liquidsoap) log files

By default Liquidsoap logs are disabled as they can contain a lot of information and can grow to a large size very quickly. The log files provide valuable information when trying to troubleshoot the service. Once enabled, the log file can be located from the Log Manager from the individual Service in the control panel.

The relative location on disk would be in /usr/local/mediacp/content/user_{user_id}/{service_type}/{port}_{id}/logs/liquidsoap.log

Please note the timestamps in the log file are relative to your system time.

It is possible to enable log files by following the below procedure:

  1. Enable Log Output from System Config -> Plugins -> Liquidsoap
  2. Restart the AutoDJ service (stop and then start it)
  3. The log file should now be available within the Log Manager

Common Issues

Liquidsoap shows buffer emptied, or DJ connection drops out

The error indicates that the client is not sending enough data to the AutoDJ service and the connection is being dropped after the buffer is exhausted. We recommend reviewing the clients error logs as it may show similar errors in sending the transmission.

AutoDJ (liquidsoap) will not start

Here are some common reasons and solutions for AutoDJ failing to start.

1. Liquidsoap installation or update might have failed

You can check if liquidsoap is installed and operating normally by running the following as root user via SSH:

/usr/local/mediacp/liquidsoap/bin/liquidsoap --version

You should see a result similar to below if it is installed correctly.

Liquidsoap 2.1.4
Copyright (c) 2003-2022 Savonet team
Liquidsoap is open-source software, released under GNU General Public License.
See <http://liquidsoap.info> for more information.

Should you see an error message then we recommend to first attempting to reinstall liquidsoap by following the steps in this Knowledgebase article.

2. AutoDJ ‘DJ Listen Port’ could be in use by another process

  1. Enable Liquidsoap logging output (image right)
  2. Attempt to start AutoDJ on the service
  3. A file called liquidsoap.log should be generated in the Log Manager
  4. Open this file and search for the term “Address already in use in bind”.
  5. If you find this term then the problem is due to the port being used already and you will need to change the DJ Listen Port to another. You can simply clear the DJ Listen Port field and press save, the MediaCP will automatically select another port to use,
  6. Be sure to disable Liquidsoap logging output after troubleshooting or it will use a lot of disk space

3. AutoDJ is started but not playing any audio

In some rare circumstances we find that the shoutcast or icecast process running on the port might be from a previously “deleted” service in the MediaCP. This can occur when the shutdown process for the service previously utilising this port was not successful. In this scenario, AutoDJ is online but is unable to connect because the password is not valid.

To resolve the problem involves terminating the process running on the shoutcast/icecast port, then restarting from the control panel.

In the example below, we’re using a service on port 8000; be sure to change port 8000 to the portbase that your service is utilizing.

  1. Install netstat on the system, it will be used to see which process is running on the port:
    # CentOS / Almalinux
    yum install net-tools

    or

    # Debian / Ubuntu
    apt install net-tools
  2. Switch the service to Offline in the MediaCP
  3. Identify any processes still running on the port
    netstat -tulpn | grep 8000
  4. In this example, i can see that there is a process for icecast running on port 8000
  5. Because we already stopped the service in the control panel, we should terminate the remaining processes.
    kill -9 30199;
  6. Now restart the service from the MediaCP

4. Other issues

If you reach this step and the problem is still not solved, then there may be another error generated.

Sometimes a specific combination of settings, corrupted or incompatible mp3/aac track may cause failures to start.

You can review the end of the liquidsoap.log file (described in step 2 above) to locate any “Error” messages that may be relevant.

Reinstall Liquidsoap or Install a Custom Version

You can find the guide for reinstalling liquidsoap in our Knowledgebase. Liquidsoap reinstall – Knowledgebase

Table of Contents