Skip to content
v.0.0.1 Node js Shoutcast Server monitor and logger
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Shoutcast Server Monitor

A Node.js application which monitors visitor activity, logging connections to MongoDB. You'll need a shoutcast server running with access to the admin.cgi pages. I run sc_serv on an AWS micro instance running Ubuntu. This project came out of the necessity to have some form of logging/reporting for monitoring listeners of my shoutcast radio station, Hawkwynd Radio. My first node application.


  • Call to shoucast server admin returns json payload of the following:
  • Display server uptime in console log and current song playing (artist - title)
  • Geo location for city,state,country and lat/lng of IP address of visitor.
  • Capture connecttion time of visitor, as well as referer and useragent.
  • If listeners, display console log of total listerner count, then list the visitors data in a list.
  • Update/Insert data into listeners table of MongoDB (for v2 reporting functions and analytics)
  • Repeat every 30 seconds.


Edit config.sample.json and save it as config.json

    "shoutcast" : {
        "url"  : "", 
        "pass" : "yourpassword_admin",         
        "mode" : "viewjson",                   
        "sid"  : 1,                            
        "path" : "admin.cgi"                   
    "mongodb" : {
        "host"       : "localhost",            
        "port"       : "27017",                
        "db"         :  "yourdatabase",        
        "collection" : "listeners"             

Install the packages and dependencies

npm run install

Run it

npm run start

Console log report

Server Uptime: 20:03:28
Currently playing: Steely Dan - Deacon Blues
Average Listening Time: 03:31:39
Listeners: 1
10/27/2019, 10:38:12 AM||Wellesley Hills, Massachusetts US|03:31:39| DNAS|42.3104,-71.2741

Output Explanation

Datetime | IP Address | City, State Country | Connect time | Referer | Geo location (Maps lookup)

Project Dependencies

"dependencies": {
    "cli"         : "^1.0.1",
    "geo-from-ip" : "^1.2.2",
    "get-json"    : "^1.0.1",
    "lodash"      : "^4.17.15",
    "lodash.merge": "^4.6.2",
    "minimatch"   : "^3.0.4",
    "moment"      : "^2.24.0",
    "mongodb"     : "^3.3.3",
    "nodemon"     : "^1.19.4",
    "pretty-ms"   : "^5.0.0"

Inspiration for this project from


  • Web console dashboard
  • Reporting / Analytics functions for queries
  • Shoutcast Administration functions (kick/ban/reserve)
  • Multiple stream monitoring
  • Pretty stuff.

Scott Fleming

Hawkwynd Radio - Live broadcasts Friday nights 9pm CST 24/7 Classic Rock & Excellent Music

You can’t perform that action at this time.