Local Monitoring Tool

Overview

This tool is used for ACRCloud Local Broadcast Monitoring Service​

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

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