Custom front-end to track Comcast data usage, allowing you to host a simple node.js server to share with roommates/family
Switch branches/tags
Nothing to show
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.
lib Graph & DB changes May 13, 2017
LICENSE Initial commit Apr 27, 2017
Screenshot.png Restyled details panel May 8, 2017
package.json Update version May 13, 2017



Comcast forces you to go through a pretty crappy login process until they finally show you your data usage on a simple progress bar. This project uses Eric Swanson's Python script to fetch the information from Comcast and then presents it in a front-end for you.


  • Log in only once
  • Auto-loads usage data in background so you don't have to wait to check it
  • Tracks usage for the month to display a nice graph
  • Slick, mobile-friendly UI
  • Ideal for proxying through something like nginx and hosting for your family/roommates
  • Planned: add detailed statistics and use predictions




Requires Node.js, MongoDB 3.2 or later, and Python 3 with the requests library. Follow those links to install them if you haven't already.

  1. Download the repo or run git clone
  2. Create the database directory in your root folder with sudo mkdir -p /data/db && sudo chown -R $USER /data/db
  3. Inside the Comstat directory, run sudo npm install to install node dependencies.

If you'd like, you can use a different database directory, but then you must ensure that Mongo has permissions to it, and you must update the path in the pre- and post- start scripts in package.json, unless you wish to start Mongo separately from Comstat.


Enter the Comstat directory, and start the node server and database together with npm start

If you'd like to start them separately (i.e. you already use Mongo for something else), Comstat can be started with node app.js and MongoDB with mongod

You should then be able to access Comstat at http://localhost:3234.


MIT © Grant Burry