{"id":28789898,"url":"https://github.com/luc-github/plugin_oled_display","last_synced_at":"2026-02-16T10:33:14.987Z","repository":{"id":280983438,"uuid":"935154003","full_name":"luc-github/plugin_oled_display","owner":"luc-github","description":"grblHAL plugin for oled display","archived":false,"fork":false,"pushed_at":"2025-03-13T12:46:19.000Z","size":12669,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T13:39:41.368Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luc-github.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-02-19T01:49:29.000Z","updated_at":"2025-03-13T12:46:23.000Z","dependencies_parsed_at":"2025-03-06T11:39:11.983Z","dependency_job_id":null,"html_url":"https://github.com/luc-github/plugin_oled_display","commit_stats":null,"previous_names":["luc-github/plugin_oled_display"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/luc-github/plugin_oled_display","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2Fplugin_oled_display","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2Fplugin_oled_display/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2Fplugin_oled_display/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2Fplugin_oled_display/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luc-github","download_url":"https://codeload.github.com/luc-github/plugin_oled_display/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2Fplugin_oled_display/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260449977,"owners_count":23010985,"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":[],"created_at":"2025-06-17T22:30:44.283Z","updated_at":"2026-02-16T10:33:14.647Z","avatar_url":"https://github.com/luc-github.png","language":"Python","readme":"# grblHAL Plugin for oled display ![Version](https://img.shields.io/badge/dynamic/json?label=Version\u0026query=$.version\u0026url=https://raw.githubusercontent.com/luc-github/plugin_oled_display/refs/heads/main/info.json)\n\n\u003e [!WARNING]\n\u003e### Disclaimer\n\u003e The software is provided 'as is,' without any warranty of any kind, expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.\n\u003eIt is essential that you carefully read and understand this disclaimer before using this software and its components. If you do not agree with any part of this disclaimer, please refrain from using the software.  \n\nCurrently only ssd1306 and equivalent (e.g: ssd1315) and sh1106 are supported with a resolution of 128 x 64 pixels.\n\n### Boot\n\u003cimg src=\"https://raw.githubusercontent.com/luc-github/Plugin_oled_display/refs/heads/main/pictures/boot.jpg\" alt=\"drawing\" width=\"200\"/\u003e\n\n### 3 Axis\n\u003cimg src=\"https://raw.githubusercontent.com/luc-github/Plugin_oled_display/refs/heads/main/pictures/3axis.jpg\" alt=\"drawing\" width=\"200\"/\u003e\n\n### 4 Axis\n\u003cimg src=\"https://raw.githubusercontent.com/luc-github/Plugin_oled_display/refs/heads/main/pictures/4axis.jpg\" alt=\"drawing\" width=\"200\"/\u003e\n\n### 5 Axis\n\u003cimg src=\"https://raw.githubusercontent.com/luc-github/Plugin_oled_display/refs/heads/main/pictures/5axis.jpg\" alt=\"drawing\" width=\"200\"/\u003e\n\n### 6 Axis\n\u003cimg src=\"https://raw.githubusercontent.com/luc-github/Plugin_oled_display/refs/heads/main/pictures/6axis.jpg\" alt=\"drawing\" width=\"200\"/\u003e\n\n### Using grblHAL Web Builder\n\nThe plugin is already part of grblHAL so just select it in 3rd party plugin\n\n### Manual Installation\nI fyou do manual compilation:\n\n* In my_machine.h\n\n`#define DISPLAY_ENABLE 33 //DISPLAY_I2C_OLED_1 `   \nthen    \n`#define DISPLAY_DRIVER 1 //DISPLAY_DRIVER_SH1106`   \nor    \n`#define DISPLAY_DRIVER 2 //DISPLAY_DRIVER_SSD1306`   \nand    \n`#define I2C_ENABLE 1`   \n\n* Copy plugin repository to  main \n\nESP32/main/plugin_oled_display\n\n* Edit ESP32/main/CMakeLists.txt\n    - Set a variable for the path of the plugin source code\n    \n```\nset(PLUGIN_OLED_DISPLAY_SOURCE\n plugin_oled_display/plugin_oled_display.c\n plugin_oled_display/oled_display.c\n)\n```\n    - Add the paths to the global source code\n    \n```\nlist (APPEND SRCS ${PLUGIN_OLED_DISPLAY_SOURCE})\n\n```\n\nSo you should get something like this:\n\n```\nset(USB_SOURCE\n usb_serial.c\n)\n\nset(PLUGIN_OLED_DISPLAY_SOURCE\n plugin_oled_display/plugin_oled_display.c\n plugin_oled_display/oled_display.c\n)\n\nif(EXISTS ${CMAKE_CURRENT_LIST_DIR}/../3rdParty.cmake)\ninclude(${CMAKE_CURRENT_LIST_DIR}/../3rdParty.cmake)\nendif()\n\nif(\"${target}\" STREQUAL \"esp32s3\")\nlist (APPEND SRCS ${USB_SOURCE})\nlist (APPEND SRCS ${I2S_S3_SOURCE})\nelse()\nlist (APPEND SRCS ${I2S_SOURCE})\nendif()\n\nlist (APPEND SRCS ${MY_PLUGIN_SOURCE})\nlist (APPEND SRCS ${NETWORKING_SOURCE})\nlist (APPEND SRCS ${KEYPAD_SOURCE})\nlist (APPEND SRCS ${TRINAMIC_SPI_SOURCE})\nlist (APPEND SRCS ${TRINAMIC_UART_SOURCE})\nlist (APPEND SRCS ${WEBUI_SOURCE})\nlist (APPEND SRCS ${SDCARD_SOURCE})\nlist (APPEND SRCS ${BLUETOOTH_SOURCE})\nlist (APPEND SRCS ${MODBUS_SOURCE})\nlist (APPEND SRCS ${SPINDLE_SOURCE})\nlist (APPEND SRCS ${EEPROM_SOURCE})\nlist (APPEND SRCS ${LASER_SOURCE})\nlist (APPEND SRCS ${MISC_PLUGINS_SOURCE})\nlist (APPEND SRCS ${EMBROIDERY_SOURCE})\nlist (APPEND SRCS ${OPENPNP_SOURCE})\nlist (APPEND SRCS ${PLUGIN_OLED_DISPLAY_SOURCE})\n```\n\n### Tools\n\nSome tools are available if you want to do more customization - only usable with manual installation.    \n\n1. **Font Converter** (`font_converter.py`) - Converts TrueType fonts to OLED-compatible bitmap font arrays\n2. **PNG Converter** (`png_converter.py`) - Converts PNG images to XBM format for OLED display, if you want to change boot screen for example.\n3. **Font Metrics Extractor** (`ttf_info_extractor.py`) - Advanced tool for analyzing font metrics and diagnosing rendering issues\n4. **Font Generator** (`font_generator.py`) - Create custom bitmap fonts by editing pixel-perfect templates\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluc-github%2Fplugin_oled_display","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluc-github%2Fplugin_oled_display","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluc-github%2Fplugin_oled_display/lists"}