README.md

Broadcast Monitoring - ACRCloud Local Service

Overview

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

Requirements

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

• Python 3

• Works on Linux

• Follow one of the tutorials to create a project and get your host, access_key.

• Recognize Music

• Recognize Custom Content

• Broadcast Monitoring for Music

• Broadcast Monitoring for Custom Content

• Detect Live & Timeshift TV Channels

• Recognize Custom Content Offline

• Recognize Live Channels and Custom Content

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 (acrcloud_config.py), fill access_key, access_secret and database info in the config file.
5. Run python3 acrcloud_local_server.py to start monitor server.
6. You can use client to refresh, get stream state, pause and restart stream, run python3 acrcloud_client.py.
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 "acrcloud_config.py".
   

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 https://get.docker.com/)

2. Run following command

   • git clone https://github.com/acrcloud/acrcloud_local_monitor

   • cd acrcloud_local_monitor

   • Change the config file "acrcloud_config.py", 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