![bitclock](https://private-user-images.githubusercontent.com/220799/338765391-5121ca8b-19c7-4db0-9a81-38fae36ac5df.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzk0NTc0NDAsIm5iZiI6MTczOTQ1NzE0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY1MzkxLTUxMjFjYThiLTE5YzctNGRiMC05YTgxLTM4ZmFlMzZhYzVkZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxM1QxNDMyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0xYmI5NjExZGVhNGY2MTU3MTczMjRmYWM0ZTlkZTBjYTFiYTQ0OTBhOGQ5NmI3OTViM2IyOTg0M2IwMTcyMTQyJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.neLSykObU2uFaw9-7XbS0h_JDytlxmXG7XlSKHoCT7g)
Open source e-ink desk companion, clock, and air quality monitor.
Available for purchase in USA @ https://bitclock.io
![Bitclock photo](https://private-user-images.githubusercontent.com/220799/357940922-a1be3895-0399-4e95-8b5f-d52c59792a22.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzk0NTc0NDAsIm5iZiI6MTczOTQ1NzE0MCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQwOTIyLWExYmUzODk1LTAzOTktNGU5NS04YjVmLWQ1MmM1OTc5MmEyMi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxM1QxNDMyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wNjdjMjM2YmY3YjhkOWUzM2YzYTMwN2U1ZGQ5NWFhY2Y1ZjE4MjVkMWUzYzZmYmYzNmZjZjllMjg1ODA0YWRmJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.WIRw9fzDEUsAEGdyIeMoW6UNjVRTsqw4tVsSp1E4wm8)
Visit https://bitclock.io/connect to configure your existing device
Source code for ESP32 using the ESP-IDF development framework.
See bitclock-fw/
Next.js web app for homepage and device configurator.
See bitclock-web/
![Web configurator screenshot](https://private-user-images.githubusercontent.com/220799/338769489-9b72ab4b-d259-4e13-9049-c8f1ba85664d.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzk0NTc0NDAsIm5iZiI6MTczOTQ1NzE0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5NDg5LTliNzJhYjRiLWQyNTktNGUxMy05MDQ5LWM4ZjFiYTg1NjY0ZC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxM1QxNDMyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02NmRjYTcyYTc2NjMwNGFlOTJmYWYwMWQ2OGY5YzRmN2UwZDgzM2M1MzVlNDgzMTc4N2EwMDU4YWYwNGRmYzA5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.Az2yuXnGpDiyHnXDdBsPE6qhp3ZTKaIPutU1EQT0iQM)
OnShape design, STEP files, and instructions for 3D printing.
![Device CAD screenshot](https://private-user-images.githubusercontent.com/220799/338769826-b83af06f-92e7-4f3a-9e44-477fad33d226.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzk0NTc0NDAsIm5iZiI6MTczOTQ1NzE0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5ODI2LWI4M2FmMDZmLTkyZTctNGYzYS05ZTQ0LTQ3N2ZhZDMzZDIyNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxM1QxNDMyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0zY2Q0MTY2ZGE5ZDYzNmNiNzc4ZjM0MjlmMWVlYmQ5ZmJiMTdiNThkMmU0MTAyM2U5ZjdjYTRlN2U1OGRhZWRhJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.E9JTAaeNpmSlqLkqWcmDE3D0ywF4HwjRWW4njYDyfLc)
KiCad schematic, board, and JLCPCB ordering files.
See bitclock-pcb/
![Bitclock PCB](https://private-user-images.githubusercontent.com/220799/357941152-40ddb658-e42d-4617-83b4-a5637c75a250.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzk0NTc0NDAsIm5iZiI6MTczOTQ1NzE0MCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQxMTUyLTQwZGRiNjU4LWU0MmQtNDYxNy04M2I0LWE1NjM3Yzc1YTI1MC5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEzJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxM1QxNDMyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kYWYyMjk5YTU2Zjk1ZjcyMzExZmYxOWI5NzRlZTI0OWJkZmZkZDJlYWVmNzhhZjRmNDIyNWMzOGZjNDM4ODBiJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.eJAJxly5gU1Y_SkuaLaLLrLr9zjGC1HLgIqef8gTtqU)
This repo uses git submodules. Make sure to use git clone --recursive
.
git clone --recursive [email protected]:goat-hill/bitclock.git
If the repo was previously checked out without --recursive
, initialize the submodules.
git submodule init
git submodule update
A single pre-commit config is created for this monorepo. Set up the hooks to get linting on every commit.
brew install pre-commit
pre-commit install