Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

jnthas/clockwise

Repository files navigation

News GIF Latest version 1.4.2 released! | See full change log

Clockwise Logo


Clockwise is an open-source smart wall clock that you can easily build yourself.
It only needs:

  • 64x64 RGB LED Matrix (HUB75 or HUB75E)
  • ESP32 dev board
  • 5V 3A power supply
  • Jumpers

To simplify assembly, you can also use the WiseShield-32 DIY PCB kit β€” created in partnership with Elecrow especially for Clockwise.


Features

  • Real-time clock with customizable themes ("Clockfaces")
  • Web-based interface for configuration
  • Open-source hardware and firmware
  • Compatible with various PCBs or just simple wiring
  • Community-driven

Quick Start

1. Required Hardware

If you want to build it from scratch, you will need at least these components below. Follow the instructions on Wiki to assemble it.

  • 64x64 RGB LED matrix (HUB75 or HUB75E)
  • ESP32 Dev Board
  • 5V 3A power supply
  • Jumpers

Alternatively, we created a custom PCB that simplifies this process a lot. The kit includes not only the PCB but all components including sensors to make your clock smarter. Check the WiseShield-32 PCB kit out now!

2. Flash Firmware

For detailed instructions:
πŸ‘‰ See Wiki: Getting Started


Clockfaces Gallery

You can choose from many creative Clockfaces β€” or make your own:

Mario Bros Words World Map Castlevania Pacman Pokedex Canvas

Canvas is a special type of Clockface that is capable of rendering different themes described in a JSON file. More about Canvas Clockface: Wiki page


How to Build

You can start developing and customizing Clockwise in two different ways:

  1. PlatformIO β€” advanced usage for developers
  2. ESP-IDF β€” for full control

πŸ‘‰ Both are described in the Flashing section of the Wiki


Advanced Configuration

Clockwise offers a flexible set of options that you can adjust through its built-in Settings page:

  • WiFi settings β€” easily update your network details without reflashing
  • Timezone & NTP server β€” sync the clock accurately for your region
  • Display brightness β€” manual or automatic control (with optional LDR sensor)
  • Display rotation β€” adjust orientation to match your wall setup
  • Clockface selection β€” switch between installed Clockfaces or use Canvas themes
  • RGB order correction β€” fix color mismatch on certain LED matrices
  • POSIX timezone string β€” fine-tune timezone behavior

πŸ‘‰ See the full guide here: Advanced Configuration Wiki


Community & Contributions


License

Clockwise is released under the MIT License.

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /