Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Broadcast Monitoring - ACRCloud Local Service


a ACRCloud provides services such as Music Recognition, Broadcast Monitoring, Custom Audio Recognition, Copyright Compliance & Data Deduplication, Live Channel Detection, and Offline Recognition etc.


Faollow one of the tutorials to create a project and get your host, access_key and access_secret.

Local Bradcast Monitoring System is used to monitor live radio streams on your own local server. Learn More

How To Use

  1. You should register an account on the ACRCloud platform, and create a Broadcast Monitoring project with local monitoring type, you will get access_key, then add your live radio streams in your project.
  2. Clone the code in your local server.
  3. If using Mysql, install MySQL, import acrcloud_database.sql to your mysql server. $mysql -uroot -p < acrcloud_database.sql.
  4. Modify configuration file (, fill access_key, access_secret and database info in the config file.
  5. Run python3 to start monitor server.
  6. You can use client to refresh, get stream state, pause and restart stream, run python3
  7. You can use Ctrl + \ to stop monitor server (in Linux).
  8. You can get monitoring results in your MySql database.
  9. If you want to record recognize audio, you can set config["record"]["record"]=3 (default is 0 and it means not record).
    You can set config["record"]["record_dir"] to specify the save path.
    You can set config["record"]["record_save_days"] to specify the keep days of record files.
    These config can be set in "".

Python Dependency Library

  1. Twisted
  2. requests
  3. fuzzywuzzy
  4. beautifulsoup4
  5. pymysql

Run as a Docker Container

  1. Install Docker

    • If you are using MacOs: Download Docker Desktop for Mac and install.
    • If you are using Linux: Open the Terminal and input bash <(curl -s
  2. Run following command

    • git clone

    • cd acrcloud_local_monitor

    • Change the config file "", fill in your project "access_key", and mysql setting(host, port, user, passwd), if Mysql was installed in your computer, please create a remote user and set field "host" to your private IP(ifconfig in Linux or ipconfig in Windows, "host.docker.internal" in Mac OS)

    • docker build -t acrcloud/acr_local_monitor_image:v1 .

    • docker run --rm -itv /<Change to your directory>/acrcloud_local_monitor:/docker_local_monitor --name="acr_local_monitor" acrcloud/acr_local_monitor_image:v1


No description, website, or topics provided.






No releases published


No packages published