Skip to content

mwood77/winderoo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

95 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Product Links Markdown Link Checker

Winderoo

Open source firmware for microcontolled watch winders

Winderoo - The Open Source Watch Winder

Winderoo is open source firmware which adds smart functionality to your OSWW build or microcontroller equipped watch winder. Smart functionality includes a Web UI (fully-translated in 5 languages!), OLED screen support, start timer, and more!

Note

OSWW is an open source modular watch winder, which you can read more about on GitHub or Printables.

Key Features

  • Settable RPD (rotations per day) between 100 - 960rpd
  • Single direction (clockwise / anti-clockwise) or bi-directional winding.
  • Settable start time. Have it wind while you're asleep, or while you're away, or anytime for that matter.
  • Manual cycle start / stop.
  • 3 seconds of rest after 3 minutes of rotation, in every mode.
  • Estimated cycle duration (how long it'll take to wind your watch).
  • Cycle progress display (how far along the current winding routine is).
  • Software or optional physical button to trigger ON/OFF state, so you can disable the winder completely.
  • OLED screen support
  • Simple setup. Flash the firmware and File System with a few clicks, then connect your phone (or other device) to the winder's setup wifi network & add it to your home network.
  • There's no app required! You control it from a web browser.
  • Minimal electronics / programming experience required
  • Web UI is fully translated into 5 languages (more are welcome!)

Winderoo Requires a Different Microcontroller

  • You must replace the Pi Pico, as spec'd in the OSWW build guide, with an ESP32. This project will not run on a Pi Pico!

User Manual

Prerequisites

Important

This project is an add-on to your already built Open Source Watch Winder (OSWW)

Download and install the following on your computer:

  1. Visual Studio Code
  2. PlatformIO
    • Note: the "extensions" button has changed since Platformio has created their install guide. You can access the extensions pane with the following key combinations:
      • Windows: Ctrl+Shift+X
      • macOS: Command+Shift+X
  3. You may or may not need these drivers, but some 'knock off' ESP32 dev boards require them.

Build Instructions

  1. Bill of Materials (what you need to buy)
  2. Software Installation
  3. Winderoo Wiring Diagram

Contributing

This project welcomes contributions. Please follow the regular git workflow; fork + PR to contribute.

Translations / Localization

Winderoo has multi-language support, and we welcome adding more languages.

To add another language:

  1. Duplicate one of the current localizations, and translate the text:
    • src/angular/osww-frontend/src/assets/i18n/ stores the current localizations.
  2. Add a new language menu item here to enable your language:
    • src/angular/osww-frontend/src/app/header/header.component.html
  3. Open a Pull Request

Frontend

Backend

  • C++ based API with mDns, a web server, local file system, and a bunch of other things.

API Specification

The API has 4 endpoints. You can explore them in the attached Open API definition.