![bitclock](https://private-user-images.githubusercontent.com/220799/338765391-5121ca8b-19c7-4db0-9a81-38fae36ac5df.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjA5MDQsIm5iZiI6MTczOTI2MDYwNCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY1MzkxLTUxMjFjYThiLTE5YzctNGRiMC05YTgxLTM4ZmFlMzZhYzVkZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMVQwNzU2NDRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mMDljNWVkMzQ0MWEwNjhlOWE3ODFiMjBmYzg2ZGY3ODg1ZjAxZmRmNGMzMmRjYThkMTg5MGY1Y2NkNGFmZTc5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.p-TXMDyDYOlI1KuKqynvNsH6dVeIV4zS-KR0aSMhpaI)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjA5MDQsIm5iZiI6MTczOTI2MDYwNCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQwOTIyLWExYmUzODk1LTAzOTktNGU5NS04YjVmLWQ1MmM1OTc5MmEyMi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMVQwNzU2NDRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02ODgwOGFiYjhiZWFiNGRlZGUxNzY5Y2JhODJkYzYxMDRiY2NjZjljY2UyNWMwZGRhYzgxMWRkYjc3MzZkOGYwJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.El6Xj6V7OP5EBoA06jWU33Z9whg-SdUGQRAJSPvayCA)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjA5MDQsIm5iZiI6MTczOTI2MDYwNCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5NDg5LTliNzJhYjRiLWQyNTktNGUxMy05MDQ5LWM4ZjFiYTg1NjY0ZC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMVQwNzU2NDRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1iODhmMzA3NzUyMDI3NjY2OTdjMzFlYjFmNTE5MTA0YzVhMTg2OThkY2RkY2MwZjg5MWNkMGI4NWI0NzE5NmFmJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.0aEf2fcmtbhR_9AUNdK8PYgvCzvksVVc45JajGfrFIQ)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjA5MDQsIm5iZiI6MTczOTI2MDYwNCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5ODI2LWI4M2FmMDZmLTkyZTctNGYzYS05ZTQ0LTQ3N2ZhZDMzZDIyNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMVQwNzU2NDRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wNjc5YmFhYjQ1MjljYjEwNmIwMGZjMTc5Yjc4YTg1MmI2MzRlZTkwZWI2YjlkZjRjZTQyNmVkZGYxOGU3ZjU5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.6rKEDB9Muso4f1sPndJFChJl9g4QMLtT_1ngYZSOUO4)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjA5MDQsIm5iZiI6MTczOTI2MDYwNCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQxMTUyLTQwZGRiNjU4LWU0MmQtNDYxNy04M2I0LWE1NjM3Yzc1YTI1MC5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjExJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMVQwNzU2NDRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kNzQ0ZWZkMGEzMTY0MGI2OGVmNGE0MTE3Mjk3MWE1ZTFiNmQ5NmZmYTEyNjBhYWFmMmFiYjg1ZDA3N2EwNjJjJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.5SmJT7yzzFlefQCEuxSY_kEO9ewZkA-ci1jF1kG8138)
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