![bitclock](https://private-user-images.githubusercontent.com/220799/338765391-5121ca8b-19c7-4db0-9a81-38fae36ac5df.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzg4NDU4MDcsIm5iZiI6MTczODg0NTUwNywicGF0aCI6Ii8yMjA3OTkvMzM4NzY1MzkxLTUxMjFjYThiLTE5YzctNGRiMC05YTgxLTM4ZmFlMzZhYzVkZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIwNlQxMjM4MjdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT01ZmQxMTIwMTVlOTE4NTFmYWZmZDZhZWY3MTFlMzM5ZmJmZjk3NDVkOGVhMDlmZTIzNmRlYmQ1MjNiOTQyMjJiJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.JzgHHymuQZ9yhWXEwjVOai0HHqQ32wEm3PNKcXsjsIk)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzg4NDU4MDcsIm5iZiI6MTczODg0NTUwNywicGF0aCI6Ii8yMjA3OTkvMzU3OTQwOTIyLWExYmUzODk1LTAzOTktNGU5NS04YjVmLWQ1MmM1OTc5MmEyMi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIwNlQxMjM4MjdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1jYmY4MmJmNWZiM2IxNjM4MWIwMzA4YWUxMGVjYTZjNDVkNjhiNGZiNGQxM2M3NTljMDI4ZTJkZDdhNDM0NDg1JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.oVA6qw43-zPvKSn4pJZ_Tx36Nd4fDaZ9LiOuNh6Fk2I)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzg4NDU4MDcsIm5iZiI6MTczODg0NTUwNywicGF0aCI6Ii8yMjA3OTkvMzM4NzY5NDg5LTliNzJhYjRiLWQyNTktNGUxMy05MDQ5LWM4ZjFiYTg1NjY0ZC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIwNlQxMjM4MjdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0xZDU2ODU4MGVhNjFlZDgyZWZmZjZjM2JkMjUyN2JmY2I1NGY1ZDc3NTAxZDM3Y2ExYTMwMTQ4NTMzOTEyOGIyJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.Xoi_MYotJXAv4-jGBbXvwCDm1BCeTzcdQuuSFKY_5Zg)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzg4NDU4MDcsIm5iZiI6MTczODg0NTUwNywicGF0aCI6Ii8yMjA3OTkvMzM4NzY5ODI2LWI4M2FmMDZmLTkyZTctNGYzYS05ZTQ0LTQ3N2ZhZDMzZDIyNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIwNlQxMjM4MjdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT00NDZiMmZjM2IwN2NhN2FlZWFjNzYwYzk5Y2RlNWRkMzU4ODYyNmI5NjNiOGYyYjYxMzFlYWI3YzIxMmEyY2RhJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.ojAVExb3vux_9fHqe91xCoZgD7SZ4tQ0HrncNhiMVKg)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mzg4NDU4MDcsIm5iZiI6MTczODg0NTUwNywicGF0aCI6Ii8yMjA3OTkvMzU3OTQxMTUyLTQwZGRiNjU4LWU0MmQtNDYxNy04M2I0LWE1NjM3Yzc1YTI1MC5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIwNlQxMjM4MjdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT05MTUwNTgyNWRhY2UyNGY4Yjk5OGNkYjljZTNkNmY4N2JlYzk5NjZiYzBhY2QwMWQ0NTQ0YTY0MzVjMzU2ZWU2JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.QwGK_jRGhntLiKRD009TEF0CDvSMDjBttjQuyXhygbk)
This repo uses git submodules. Make sure to use git clone --recursive
.
git clone --recursive git@github.com: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