Local Monitoring Tool

Search…
Overview
This tool is used for ACRCloud Local Broadcast Monitoring Service​
Local Broadcast Monitoring System(GitHub) is used to monitor live radio streams on your own local server. 
Requirements
Python 2.7
Works on Linux/Windows
Follow one of the tutorials to create a project and get your host, access_key.
​Broadcast Monitoring for Music​
​Broadcast Monitoring for Custom Content​
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.
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 python acrcloud_local_server.py to start monitor server.
6.
You can use client to refresh, get stream state, pause and restart stream, run python 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.
​MySQL-Python​
Install on Windows
1.
Install Windows Runtime Library
X86: download and install Library(vcredist_x86.exe)​
x64: download and install Library(vcredist_x64.exe)​
2.
Install Mysql on your windows
3.
Create Databases(in acrcloud_local_monitor direction and run this command)
mysql -uroot -p < acrcloud_database.sql
4.
Install Python​
5.
Install Python Dependency Library(in acrcloud_local_monitor direction and run the script)
.\install_python_packages_for_windows.bat
6.
Install MySQL-python​
Open https://www.lfd.uci.edu/~gohlke/pythonlibs/​
Find and Download:
MySQL_python‑1.2.5‑cp27‑none‑win32.whl (or MySQL_python‑1.2.5‑cp27‑none‑win_amd64.whl)
python -m pip install MySQL_python‑1.2.5‑cp27‑none‑win32.whl
python -m pip install mysql-python        
7.
Copy the ACRCloud Library into the acrcloud_local_monitor direction according to your system.
X86: copy from winlibs/win32/acrcloud_stream_decode.pyd to acrcloud_local_monitor direction
X64: copy from winlibs/win64/acrcloud_stream_decode.pyd to acrcloud_local_monitor direction
8.
If you have created Local Project and add some streams, config the acrcloud_config.py with your access_key, and mysql information, then start the local server
python acrcloud_local_server.py
9.
Stop the local monitor server
python acrcloud_stop.py and Ctrl-C
Run as a Docker Container
1.
Install Docker
If you are using Windows: Download Docker Desktop for Windows and install.
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
Tools - Previous
Audio File Fingerprinting Tool
Next - Tools
Live Channel Fingerprinting Tool
Last modified 3mo ago
Copy link
Contents
Overview
Requirements
How To Use
Python Dependency Library
Install on Windows
Run as a Docker Container