{"id":19723957,"url":"https://github.com/wraith13/sandglass-m5stickcplus","last_synced_at":"2025-04-29T22:31:09.625Z","repository":{"id":83857420,"uuid":"502241833","full_name":"wraith13/sandglass-m5stickcplus","owner":"wraith13","description":"Sandglass application for M5StickC Plus","archived":false,"fork":false,"pushed_at":"2022-12-06T22:15:15.000Z","size":44,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T20:02:15.554Z","etag":null,"topics":["m5stickc-plus"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wraith13.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE_1_0.txt","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}},"created_at":"2022-06-11T03:41:29.000Z","updated_at":"2024-02-16T15:36:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"d0201b23-5bda-4c1f-8175-b5d6d4cf6881","html_url":"https://github.com/wraith13/sandglass-m5stickcplus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wraith13%2Fsandglass-m5stickcplus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wraith13%2Fsandglass-m5stickcplus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wraith13%2Fsandglass-m5stickcplus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wraith13%2Fsandglass-m5stickcplus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wraith13","download_url":"https://codeload.github.com/wraith13/sandglass-m5stickcplus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251592997,"owners_count":21614453,"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","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":["m5stickc-plus"],"created_at":"2024-11-11T23:24:03.643Z","updated_at":"2025-04-29T22:31:09.619Z","avatar_url":"https://github.com/wraith13.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sandglass for M5StickC Plus\r\n\r\n![image](https://user-images.githubusercontent.com/645907/173222306-3b8348a4-ee0d-4407-831d-d796709369be.png)\r\n\r\n## features\r\n\r\n- software sanglass\r\n- timer preset: 30s, 1m, 1m30s, 2m, 3m, 5m, 10m, 15m, 30m, 60m\r\n- battery gauge\r\n- auto power off\r\n- repeat mode\r\n- mute mode\r\n\r\n## requirements\r\n\r\n- [M5StickC Plus ( K016-P )](https://docs.m5stack.com/en/core/m5stickc_plus)\r\n- [Arduino IDE](https://www.arduino.cc/en/software)\r\n- [VCP Drivers](https://ftdichip.com/drivers/vcp-drivers/)\r\n- [Visual Studio Code](https://code.visualstudio.com/)\r\n- [Arduino for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.vscode-arduino)\r\n\r\n## preparation for build\r\n\r\n0. Start Arduino IDE\r\n1. `Preferences` -\u003e Set `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` to `Additional Board Manager URLs`\r\n2. `Board Manager`( `Arduino: Board Manager` command in VS Code ) -\u003e filter `esp32` -\u003e install `esp32`\r\n3. `Library Manager`( `Arduino: Library Manager` command in VS Code ) -\u003e filter `M5StickCPlus` -\u003e install `M5StickCPlus`\r\n\r\n## how to build \u0026 upload\r\n\r\n0. Start VS Code\r\n1. Run `Arduino: Board Config` Command from Command Palette. Select `M5Stick-C (esp32)` on `Select Board`.\r\n2. Connect a M5StickC Plus to your PC with USB cable.\r\n3. Run `Arduino: Select Serial Port` Command from Command Palette. Select a M5StickC Plus's Port.\r\n4. Run `Arduino: Upload` Command from Command Palette\r\n\r\n## user interface\r\n\r\n### button\r\n\r\n|button|description|\r\n|---|---|\r\n|main|change timer|\r\n|left side(power off)|power on|\r\n|left side( \u003c 1s)|reset to top|\r\n|left side( \u003c 4s)|reset to bottom|\r\n|left side( \u003e= 4s)|power off|\r\n|right siede|change mode|\r\n\r\n### battery gauge\r\n\r\n|color|description|\r\n|---|---|\r\n|blue|charging ( gyro off )|\r\n|green|normal|\r\n|yellow|low battery|\r\n|red|almost empty battery|\r\n\r\n### mode\r\n\r\n|mode|description|\r\n|---|---|\r\n|R|repeat|\r\n|M|mute|\r\n\r\n### timer preset\r\n\r\n|timer|color|\r\n|---|---|\r\n|30s|blue|\r\n|1m|red|\r\n|1m30s|green|\r\n|2m|cyan|\r\n|3m|magenta|\r\n|5m|yellow|\r\n|10m|orange|\r\n|15m|green yellow|\r\n|30m|pink|\r\n|60m|white|\r\n\r\nYou can edit timer preset in [`config.h`](./config.h).\r\n\r\n## License\r\n\r\n[Boost Software License](./LICENSE_1_0.txt)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraith13%2Fsandglass-m5stickcplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwraith13%2Fsandglass-m5stickcplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwraith13%2Fsandglass-m5stickcplus/lists"}