Skip to main content

Lightweight status dashboard for Bitcoin nodes.

Project description

BTCnDash is a web-based dashboard displaying information about the status of a bitcoin node such as currently connected peers, recent transactions forwarded, bandwidth usage, and network stats like hash rate. Most items are generated automatically or retrieved from the bitcoind server itself via RPC calls.

BTCnDash is meant to be lightweight, and with the assumption that there will be very low traffic to the dashboard. As such, it does not use a full webserver like Nginx or apache. It uses the Bottle microframework and generates static status pages on a schedule. Python’s WSGI reference server is used as the actual webserver, but Bottle (and therefore BTCnDash) can be served by lots of different servers. You could also simply serve the statics pages only.

Python 2.7 is required. Python 3.5 works, but is not as well tested! Bitcoin Core v0.12 through v0.14 appear to work, but the latest v0.14 has not been thoroughly tested.

Author and Acknowledgements

BTCnDash is written and maintained by Matt Doiron <> and is released under the GPL v3 license. The source can be found on the Bitbucket page. Hope you find it useful! If so, please consider donating Bitcoin to 1AHT2Zq7JneADw94M8uCdKRrqVZfhrTBYM

Thanks to those who make great tools like these that make BTCnDash possible:

Other Resources


v2.3.6, May 14, 2017

  • Broader exception handling to ensure pages are still cached when there are errors.

v2.3.3-5, April 10, 2017

  • Fix to catch some exceptions related to HTTP errors

  • Ensure that donate address is included in footer

  • Appears to work with Bitcoin Core v0.14 but some RPC calls have changed and have not been tested

  • Define default states for variables in case of banks or invalid responses.

  • Move documentation to Readthedocs

v2.3.2, November 11, 2016

  • Fix issues related to upgrade to new version of python-bitcoinlib

  • Add support for reporting NODE_WITNESS service bit

  • Add default value for pingtime because it’s not always available

  • Fix conversion of service bit to int

v2.3.1, November 11, 2016

  • Fix issue with partially retrieved data causing worker to crash

  • Version bump for dependencies

v2.3.0, April 3, 2016

  • Documentation updates

  • Allow name of node to be customized

  • Make location variables accessible to templates directly

  • Move formatting into the templates themselves

  • Fixed some Python 2/3 issues

  • New tiles: bitnodes data and fee summary

  • Always load default config first, then overwrite with any custom config

v2.2.0, March 26, 2016

  • Added interactive tables to the transactions and peers pages

  • Added several new tiles and reformatted others. Made the new ones the default, but originals are still present if desired.

  • Some code cleanup and fixes

  • Allow an argument to RPC commands

  • Make some logging less verbose

  • Documentation updates

v2.1.0, March 20, 2016

  • Return config file to plain text, this time json

  • Add command line options:

    • Specify location of config file

    • Clear page cache on startup

  • Update js libraries (Highcharts and jQuery)

  • Add config options to add additional locations for views and static files

  • Add a file and publish to PyPI

  • Updated documentation and use Sphinx to make it pretty

v2.0.0, March 16, 2016

  • Significant refactoring under the hood

  • Allow reordering, disabling and adding custom tiles

  • Config file now python to allow more powerful customization

  • Preliminary support for Python 3.5

  • Remove CherryPy as a dependency (default to wsgiref instead)

  • Add config variable for header title

  • Bug fixes

v1.0.1, March 8, 2016

  • Fixed a bug with float data type

v1.0.0, March 8, 2016

  • Bumped version to 1.0

v0.1.1, Jan 1, 2015

  • Added a more graceful failure when the Bitcoin node is not reachable

  • Clarified Python version requirements

  • Bumped versions of dependencies

v0.1.0, May 25, 2014

  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

btcndash-2.3.6.tar.gz (641.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page