{"id":24976281,"url":"https://github.com/mwood77/winderoo","last_synced_at":"2025-07-29T01:05:43.777Z","repository":{"id":169353686,"uuid":"589766067","full_name":"mwood77/winderoo","owner":"mwood77","description":"Winderoo - Supercharge your Open Source Watch Winder (OSWW) build!","archived":false,"fork":false,"pushed_at":"2025-07-06T05:24:17.000Z","size":51623,"stargazers_count":40,"open_issues_count":7,"forks_count":8,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-07-12T08:02:07.453Z","etag":null,"topics":["arduino","cc-by-sa","esp32","hardware","homeassistant","homeassistant-integration","watches"],"latest_commit_sha":null,"homepage":"https://winderoo.com","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mwood77.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["mwood77"],"patreon":null,"open_collective":null,"ko_fi":"mwood77","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.paypal.com/paypalme/kklarkson"]}},"created_at":"2023-01-16T22:08:19.000Z","updated_at":"2025-07-06T13:38:06.000Z","dependencies_parsed_at":"2024-04-08T16:11:41.125Z","dependency_job_id":"911688aa-292c-4ea5-a652-1072a7ce6221","html_url":"https://github.com/mwood77/winderoo","commit_stats":null,"previous_names":["mwood77/winderoo"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/mwood77/winderoo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mwood77%2Fwinderoo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mwood77%2Fwinderoo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mwood77%2Fwinderoo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mwood77%2Fwinderoo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mwood77","download_url":"https://codeload.github.com/mwood77/winderoo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mwood77%2Fwinderoo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267612925,"owners_count":24115552,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","cc-by-sa","esp32","hardware","homeassistant","homeassistant-integration","watches"],"created_at":"2025-02-03T22:00:09.676Z","updated_at":"2025-07-29T01:05:43.747Z","avatar_url":"https://github.com/mwood77.png","language":"C++","funding_links":["https://github.com/sponsors/mwood77","https://ko-fi.com/mwood77","https://www.paypal.com/paypalme/kklarkson"],"categories":[],"sub_categories":[],"readme":"[![Product Links](https://github.com/mwood77/winderoo/actions/workflows/selenium-web.yml/badge.svg)](https://github.com/mwood77/winderoo/actions/workflows/selenium-web.yml)\n[![Markdown Link Checker](https://github.com/mwood77/winderoo/actions/workflows/lint-markdown.yml/badge.svg)](https://github.com/mwood77/winderoo/actions/workflows/lint-markdown.yml)\n\n\u003cdiv align=\"center\"\u003e  \n  \u003ch2\u003e\n    Winderoo\n    \u003cp\u003e\u003ci\u003eOpen source firmware for microcontolled watch winders\u003c/i\u003e\u003c/p\u003e\n  \u003c/h2\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e \n  \u003ca href=\"https://www.youtube.com/watch?v=BJKpY6Zp8BI\" target=\"_blank\"\u003e\n    \u003cimg src=\"./docs/images/winderoo-splash.png\" alt=\"Winderoo - The Open Source Watch Winder\" width=\"600\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003cp\u003e\n    Winderoo is open source firmware which adds \u003ci\u003esmart functionality\u003c/i\u003e to your \u003ca href=\"https://github.com/mwood77/osww\" target=\"_blank\"\u003eOSWW build\u003c/a\u003e or microcontroller equipped watch winder. \u003ci\u003eSmart functionality\u003c/i\u003e includes a Web UI (fully-translated in 5 languages!), OLED screen support, start timer, and more!\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003e [!NOTE]\n\u003e OSWW is an open source modular watch winder, which you can read more about on [GitHub](https://github.com/mwood77/osww) or [Printables](https://www.printables.com/model/421249-osww-the-open-source-watch-winder).\n\n### Key Features\n* Settable RPD (rotations per day) between 100 - 960rpd\n* Single direction (clockwise / anti-clockwise) or bi-directional winding.\n* Settable start time. Have it wind while you're asleep, or while you're away, or anytime for that matter. \n* Manual cycle start / stop.\n* 3 seconds of rest after 3 minutes of rotation, in every mode.\n* Estimated cycle duration (how long it'll take to wind your watch).\n* Cycle progress display (how far along the current winding routine is).\n* Software or optional physical button to trigger ON/OFF state, so you can disable the winder completely.\n* OLED screen support\n* 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 \u0026 add it to your home network.\n* There's no app required! You control it from a web browser.\n* Minimal electronics / programming experience required\n* Web UI is fully translated into 5 languages (more are welcome!)\n\n\n### Winderoo Requires a Different Microcontroller\n* **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!**\n\n# User Manual\n* [Click Here to see the user manual](./docs/user-manual.md)\n\n## Prerequisites\n\u003e [!IMPORTANT]\n\u003e This project is an add-on to your already built [Open Source Watch Winder (OSWW)](https://github.com/mwood77/osww)\n\n#### Download and install the following on your computer:\n1. [Visual Studio Code](https://code.visualstudio.com/)\n1. [PlatformIO](https://platformio.org/install/ide?install=vscode)\n    - Note: the \"extensions\" button has changed since Platformio has created their install guide. You can access the extensions pane with the following key combinations:\n        - Windows: Ctrl+Shift+X\n        - macOS: Command+Shift+X\n1. You may or may not need these drivers, but some 'knock off' ESP32 dev boards require them.\n    - [CP210x Drivers](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads) \n    - If the CP210x drivers don't work:  [CH340 Drivers](https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers) \n\n\n## Build Instructions\n1. [Bill of Materials (what you need to buy)](./docs/bom-requirements.md)\n1. [Software Installation](./docs/install-software.md)\n1. [Winderoo Wiring Diagram](./docs/wiring-diagram.md)\n\n\n## Contributing\nThis project welcomes contributions. Please follow the regular git workflow; fork + PR to contribute.\n\n### Translations / Localization\nWinderoo has multi-language support, and we welcome adding more languages.\n\nTo add another language:\n1. Duplicate one of the current localizations, and translate the text:\n    - `src/angular/osww-frontend/src/assets/i18n/` stores the current localizations.\n1. Add a new language menu item here to enable your language:\n    - `src/angular/osww-frontend/src/app/header/header.component.html`\n1. Open a Pull Request\n\n### Frontend\n- Angular with Angular Material\n- [Frontend Readme](./src/angular/osww-frontend/README.md)\n\n### Backend \n- C++ based API with mDns, a web server, local file system, and a bunch of other things.\n\n### API Specification\n\nThe API has 4 endpoints. You can explore them in the attached Open API definition.\n- [Open API Definition](./openapi.yml)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmwood77%2Fwinderoo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmwood77%2Fwinderoo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmwood77%2Fwinderoo/lists"}