![bitclock](https://private-user-images.githubusercontent.com/220799/338765391-5121ca8b-19c7-4db0-9a81-38fae36ac5df.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkxNjc2NDAsIm5iZiI6MTczOTE2NzM0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY1MzkxLTUxMjFjYThiLTE5YzctNGRiMC05YTgxLTM4ZmFlMzZhYzVkZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMFQwNjAyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT05ZThjYzQ3YmVmMzhhYzM2NWRlYjk0NDg2YTA2MzQ5NWQzNTkwYzdmMDEzMGUwYzQ2YWMzMTJiYmRhY2JiNDYxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.gPOQ2XK529k0rGZl5A38phmG7CwtHB0FjXFGdc0ZmOk)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkxNjc2NDAsIm5iZiI6MTczOTE2NzM0MCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQwOTIyLWExYmUzODk1LTAzOTktNGU5NS04YjVmLWQ1MmM1OTc5MmEyMi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMFQwNjAyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02YjdjYmIyZDExNzJmY2MwMjViNWEyNWM0NTU3MDMzZDdlZTU3YmZmMDkzZDRkMjliOWJkOTg0NjcyNWIyMzE2JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.t6GP-K27cUn_3zquxHonOW1TgRruJDeHzTMadhaHInM)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkxNjc2NDAsIm5iZiI6MTczOTE2NzM0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5NDg5LTliNzJhYjRiLWQyNTktNGUxMy05MDQ5LWM4ZjFiYTg1NjY0ZC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMFQwNjAyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT01NTliNTkyYzcwNjk5MWRkNjlmOWY1MjlmOGNlNTk5NTAxYmM4YzQyYzJkMTk3N2Q2ZjU3MWQ0MTg0MzRmNjYwJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.0FLdVwqKPDcv4oWNFeNrFhOaC5L9Jj-lnEIeNfeNcic)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkxNjc2NDAsIm5iZiI6MTczOTE2NzM0MCwicGF0aCI6Ii8yMjA3OTkvMzM4NzY5ODI2LWI4M2FmMDZmLTkyZTctNGYzYS05ZTQ0LTQ3N2ZhZDMzZDIyNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMFQwNjAyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lZGJlMjM0Mjk4NWEwNWRkNDIzZTNmZjkyNjNjZDNkYTAxMGNlNzJjZDAyOGZhNTA4MWM3OWJiMTcwYTRiY2JkJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.AgNcwEIrvJxd6k6dbg2K3D8_5CMoqxxZI8FUwogodO0)
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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkxNjc2NDAsIm5iZiI6MTczOTE2NzM0MCwicGF0aCI6Ii8yMjA3OTkvMzU3OTQxMTUyLTQwZGRiNjU4LWU0MmQtNDYxNy04M2I0LWE1NjM3Yzc1YTI1MC5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMjEwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDIxMFQwNjAyMjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT03ZmY1NzlmZTNmNzg0NGRiYjZjNDg5NTQ4NTYwZTI2N2E1MzYzZGM1OTIxMzU0YjVjNjI5N2NmOWNkM2NiNTcyJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.eP_27ctzcixStxY5aJzJcOugpFVq5JJ9mrDAzCi3rMI)
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