{"id":15142108,"url":"https://github.com/makerm0/magiclick-esp32s3","last_synced_at":"2025-04-05T19:13:15.463Z","repository":{"id":192264600,"uuid":"656571359","full_name":"MakerM0/MagiClick-esp32s3","owner":"MakerM0","description":"A Mechanical Macro Keyboard with Disp, based on ESP32-S3 Ver2.x","archived":false,"fork":false,"pushed_at":"2024-10-15T05:03:23.000Z","size":85784,"stargazers_count":137,"open_issues_count":0,"forks_count":5,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-29T21:55:21.249Z","etag":null,"topics":["arduino","circuitpython","esp32","keyboard","macropad"],"latest_commit_sha":null,"homepage":"https://www.elecrow.com/magiclick-open-source-multifunctional-programmable-mechanical.html","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MakerM0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-06-21T07:59:49.000Z","updated_at":"2024-10-28T09:31:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"546dd95c-0e97-4be3-aaa5-c4bb84f2ad30","html_url":"https://github.com/MakerM0/MagiClick-esp32s3","commit_stats":{"total_commits":96,"total_committers":2,"mean_commits":48.0,"dds":0.01041666666666663,"last_synced_commit":"6d9fb89dbbbdbc81473f8a48681939e664dc9463"},"previous_names":["makerm0/magiclick-esp32s3"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerM0%2FMagiClick-esp32s3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerM0%2FMagiClick-esp32s3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerM0%2FMagiClick-esp32s3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerM0%2FMagiClick-esp32s3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MakerM0","download_url":"https://codeload.github.com/MakerM0/MagiClick-esp32s3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247386265,"owners_count":20930619,"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":["arduino","circuitpython","esp32","keyboard","macropad"],"created_at":"2024-09-26T09:22:55.860Z","updated_at":"2025-04-05T19:13:15.457Z","avatar_url":"https://github.com/MakerM0.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"https://avatars.githubusercontent.com/u/117961102\" width=\"150\"/\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e   \n    \u003cimg alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/MakerM0/MagiClick-esp32s3\"\u003e\n    \u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/MakerM0/MagiClick-esp32s3\"\u003e  \n\u003c/p\u003e\n\n\nhttps://github.com/user-attachments/assets/02206fc1-4ecb-459a-b24e-a9fd3fc22468\n\n# MagiClick S3\n\nThis is a versatile, single-button keyboard based on the ESP32-S3 microcontroller, featuring a 0.85-inch color display and customizable functionality, perfect for educational purposes, macro keyboard creation, and desktop decoration.It supports multiple programming languages.\n\n\n\n# Specifications\n\n- **Dispaly**: 0.85-inch RGB, 128x128 resolution\n- **MCU**: ESP32-S3 , Wi-Fi \u0026 BLE\n- Main operation via central mechanical buttons, with auxiliary buttons on the sides\n- Pluggable mechanical switch design, choice of silent or other types\n- speaker\n- motion sensor\n- Expansion port \n- USB Type-C interface\n- Reset button at the bottom\n-  RGB LEDs\n- more\n\n\n\n\n# Purchase\n\n[Browse products ](https://www.elecrow.com/store/MakerM0)\n\n\u003ca href=\"https://www.pcbway.com/project/shareproject/MagiClick_S3_Single_506b8396.html\"\u003e\u003cimg src=\"https://www.pcbway.com/project/img/images/frompcbway-1220.png\" alt=\"PCB from PCBWay\" /\u003e\u003c/a\u003e\n\n\n\n# Hardware \n\n![20240819_164759](https://github.com/user-attachments/assets/72df055e-1152-4552-a693-6c6f89c9b059)\n\n| Version |                                                   |\n| :------------------: | :-----------------------------------------------: |\n|                   |                                                   |\n| [2.4](hardware)  | \u003cimg src=\"documents/images/2.4@1x.png\" width=800\u003e |\n| [2.3c](hardware)  | \u003cimg src=\"documents/images/7.png\" width=800\u003e      |\n| [2.3b ](hardware) | \u003cimg src=\"documents/images/19_1.png\" width=800\u003e   |\n| [2.0](hardware)   | \u003cimg src=\"documents/images/1.jpg\" width=400\u003e     |\n|                      |                                                   |\n\n\n\n\n### Difference \n\n|                                          |                             v2.0                             |                             v2.3                             |                             v2.4                             |\n| ---------------------------------------- | :----------------------------------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: |\n| Supported MCU or Module                  |          ESP32-S3-MINI-1-N4R2 or ESP32-S3-MINI-1-N8          |                         ESP32-S3FN8                          |                          ESP32-S3R8                          |\n| FLASH                                    |                          4MB or 8MB                          |                             8MB                              |                             16MB                             |\n| PSRAM                                    |                           2MB or ❌                           |                              ❌                               |                             8MB                              |\n| Display Driver                           |                            GC9107                            |                            NV3023                            |                            NV3023                            |\n|                                          | \u003cimg src=\"https://github.com/user-attachments/assets/523d0a3c-ad5c-45c5-bae5-af37dbe8f4df\" alt=\"GC9107\" height=150 /\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/cd7b9db4-63ff-4de5-b79d-df9c267f4ca3\" alt=\"NV3023\" height=150 /\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/cd7b9db4-63ff-4de5-b79d-df9c267f4ca3\" alt=\"NV3023\" height=150 /\u003e |\n| Battery(with a protection circuit board) |                            801230                            |                       602025 or 802025                       |                            602025                            |\n|                                          | \u003cimg src=\"https://github.com/user-attachments/assets/7210dbef-53c5-4370-846a-e92d67251280\" alt=\"18\" height=150 /\u003e |                                                              |                                                              |\n| Keyboard switch                          | \u003cimg src=\"https://github.com/user-attachments/assets/591edf82-1dd9-41aa-b90f-4f15ff3cf00b\" alt=\"16-09-2024 13 45 53\" height=150/\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/6c8d2646-7472-4314-a1af-7253ca38c896\" alt=\"16-09-2024 13 45 38\" height=150 /\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/6c8d2646-7472-4314-a1af-7253ca38c896\" alt=\"16-09-2024 13 45 38\" height=150 /\u003e |\n| Audio                                    |                           max98357                           |                            ns4168                            |                            es8311                            |\n| Microphone                               |                              ❌                               |                              ❌                               |                              1x                              |\n| Motion Sensor                            |                         lsm6ds3tr-c                          |                         lsm6ds3tr-c                          |                           lis2dh12                           |\n\n\n\n# Software\n\nSupports development using Arduino, CircuitPython, and MicroPython.\n\n\n\nThe \"software\" and \"firmware\" folders in this repository primarily contains the source code related to the hardware version 2.0. \n\nWhen you update the circuitpython firmware of the 2.0 hardware to version 9.x, the contents of the 2.3 software [here](https://github.com/MakerM0/MagiClick-S3-Single) folder can then be used by the 2.0 hardware.\n\n\n\nFor version 2.3, please click  [here](https://github.com/MakerM0/MagiClick-S3-Single).\n\n### Guide\n\n1. Use the Flash Download Tool to burn the Combined .bin in the Firmware folder to the board\n2. After rebooting, Then copy the **.uf2** file to a USB stick\n3. After rebooting, copy the contents of the softerware folder to the displayed USB stick\n\n [help](documents/如何下载固件.pdf) \n\n\n##### Settings.toml \n\nmodify your wifi information, know the weather key (need to go to the official website to apply) and city\n\nThe main button is used to access the function options\n\nThe side button or flip button can exit the current function and return to the home page\n\n##### How to add new features\n\nAdd the .py file to the app folder\n\n\n\n# Mechanical\n\n#### 3D Printings\n\nMakeronline\n\n- [2.3](https://www.makeronline.com/en/model/magiclick%20macropad%20keyboard%20%E7%A5%9E%E5%A5%87%E6%8C%89%E9%92%AE/113241.html)\n- [PACKAGING BOX](https://makeronline.com/en/model/product%20packaging%20box/48433.html)\n- [PACKAGING BOX_2](https://makeronline.com/en/model/product%20packaging%20box/48433.html)\n\n\n\nMakerworld\n\n- [2.0](https://makerworld.com/zh/models/404976#profileId-306794)\n- [2.3](https://makerworld.com/zh/models/440612#profileId-346290)\n- [2.3](https://makerworld.com/zh/models/584488#profileId-505582)\n\n\n\n\u003cimg src=\"documents/images/172822164043371300-670291c869e3_thumbnail.jpg\" alt=\"172822164043371300-670291c869e3_thumbnail\"   width = 600/\u003e\n\n\n\n## How to contribute\n\nPlease use PR to submit contributions\n\nIn the **thirdparty** folder, create a project folder according to your own content, the naming needs to be intuitive and easy to understand, and the open source license should be added according to your own wishes\n\nPlease add a summary of the contributions in the file **contributer.md**, Add it at the end\n\n\n\n## Images\n\n| ![4](documents/images/11.jpg)                                | ![5](documents/images/15.jpg)                                | ![6](documents/images/12.jpg)                                |\n| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| ![9](documents/images/16.jpg)                                | \u003cimg src=\"extention/MLX90640/images/5.jpg\" alt=\"5\" style=\"zoom:80%;\" /\u003e | ![20240929_153110_mini](documents/images/20240929_153110_mini.jpg) |\n| ![7](documents/images/13.jpg)                                | ![8](documents/images/14.jpg)                                | \u003cimg src=\"extention/MLX90640/images/6.jpg\" alt=\"6\" style=\"zoom: 80%;\" /\u003e |\n| ![172822164043371300-670291c869e3_thumbnail](documents/images/172822164043371300-670291c869e3_thumbnail.jpg) | ![resin](documents/images/resin.jpg)                         | ![20241128_151456](documents/images/20241128_151456.jpg)     |\n| ![20241128_151031](documents/images/20241128_151031.jpg)     | ![20241128_151131](documents/images/20241128_151131.jpg)     |                                                              |\n\n\n\n\n\n\n\n# Extra\n\nThe most icons is from https://icons8.com/.\n\nOther resource files come from the internet. \n\nIf there are copyright issues involved, please contact me to delete them.\n\n\n\n# License\n\n(documents/hardware/mechanical)[Creative Commons — Attribution-NonCommercial-ShareAlike 4.0 International — CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerm0%2Fmagiclick-esp32s3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakerm0%2Fmagiclick-esp32s3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerm0%2Fmagiclick-esp32s3/lists"}