Live Channel Fingerprinting Tool


  • The Live Channel Fingerprinting Tool (Download) is used for extracting and uploading features from live TV channel streams in real time.
  • After the app is integrated, our SDK can detect your channels by recording the audio for just a few seconds in real time.
  • We assume that this tool will be running on your server, which already has quick network access to the streams so that our system guarantees the Real-Time performance to detect the live channels.


  • Before using this tool, you must register on our platform and log into your dashboard.
  • Sign up now for a free 14 day trial:
  • Create a “Live Channel” bucket and add the url of your streams into it.
  • Create a console access key pairs on account page and input this key pairs to your client.conf file
  • Input your Live Bucket Name to the client.conf file.
  • Run the
  • Create a “Live Channel Detection” project and attach the bucket which contains your chosen stream urls.
  • Then you can use our SDK to detect the current stream.

Python Dependence:

python 2.x >= 2.6, not tested in python3

How to run:

1) Download the tool.

git clone live_stream_client

2) Enter the operating system you use.

cd Linux/x86-64

3) Edit the client.conf file and replace the console key pairs ( access_key, access_secret ), bucket_name with your own.

python client.conf


nohup python client.conf &

How to update/add stream url:

1) Update/add stream URL to the Live Channel Bucket on the Console

2) Kill process in your server.

ps -ef | grep | grep -v grep | awk '{print $2}'| xargs kill -9

3) Restart the

python client.conf


nohup python client.conf &

How to use playback feature?

  1. Use Buckets api to create a LivePlaybck bucket, set the bucket type “LivePlayback”.
  2. Use channle-playback api to create a channel-playback item. And you can also update/get/delete a channel-playback item from the bucket.
  3. Set ‘record_upload = 1’ in the client.conf file. the parameter ‘record_upload_interval’ is that uploading ‘record_upload_interval’ seconds audio fingerprint to the database one time.

How to check the live fingerprinting status?

  1. Login in to your account from Console
  2. Make sure you are in the region where you send the live fingerprinting
  3. Click “Live channel” under bucket
  4. Click in the bucket you build for the channels and see each status of the channel


Processing : The real-time fingerprint of stream has not yet reached the platform.

Ready: The fingerprint of live stream is ready for detection