# ESP3D-WEBUI **Repository Path**: pager/ESP3D-WEBUI ## Basic Information - **Project Name**: ESP3D-WEBUI - **Description**: A Web UI for ESP8266 or ESP32 based boards connected to 3D printers / CNC - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: 2.1 - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2023-06-06 - **Last Updated**: 2025-07-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ESP3D-WEBUI 2.X [![All Contributors](https://img.shields.io/badge/all_contributors-33-orange.svg?style=flat-square)](#contributors-) [Latest stable release ![Release Version](https://img.shields.io/github/v/release/luc-github/ESP3D-WEBUI?color=green&include_prereleases&style=plastic) ![Release Date](https://img.shields.io/github/release-date/luc-github/ESP3D-WEBUI.svg?style=plastic)](https://github.com/luc-github/ESP3D-WEBUI/releases/latest/) [Latest development version ![Development Version](https://img.shields.io/badge/Devt-v3.0-yellow?style=plastic) ![GitHub last commit (branch)](https://img.shields.io/github/last-commit/luc-github/ESP3D-WEBUI/3.0?style=plastic)](https://github.com/luc-github/ESP3D-WEBUI/tree/3.0) [![github-ci](https://github.com/luc-github/ESP3D-WeBUI/workflows/build-ci/badge.svg)](https://github.com/luc-github/ESP3D-WEBUI/actions/workflows/build-ci.yml) [![Project Page ESP3D 3.0](https://img.shields.io/badge/Project%20page-ESP3D%203.0-blue?style=plastic)](https://github.com/users/luc-github/projects/1/views/1) [Project board](https://github.com/users/luc-github/projects/1/views/1) > [!WARNING] >### Disclaimer > 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. >It 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. ## What is that ? A web configuration tool for ESP3D 2.1 Originaly based on great UI from Jarek Szczepanski (imrahil): [smoothieware-webui](http://imrahil.github.io/smoothieware-webui/) to get a multi firmware support for [Repetier](https://github.com/repetier/Repetier-Firmware), [Repetier for Davinci printer](https://github.com/luc-github/Repetier-Firmware-0.92), (Marlin)[https://github.com/MarlinFirmware], [Marlin Kimbra](https://github.com/MagoKimbra/MarlinKimbra) and of course [Smoothieware](https://github.com/Smoothieware/Smoothieware) ## Why doing it ? Original I ported [smoothieware-webui](http://imrahil.github.io/smoothieware-webui/) to support [ESP3D firmware](https://github.com/luc-github/ESP3D) and it was working pretty well and gave :[smoothieware-webui-for-ESP3D](https://github.com/luc-github/smoothieware-webui-for-ESP3D) But this UI has a 2 big limitations: 1 - you need internet access to get all libraries available to download, which may not happen when ESP is in AP mode for configuration if you do not have all js/css in your browser cache, or if you want to use in local environement, in that case not only ESP AP mode is not displaying UI properly but also STA mode - so it make the ESP useless 2 - it rely on server availability and certificat check, I got several certificat failure for unknown reason that made the UI not working So the solution was to make all resources available - easy no ? Yes but! ESP webserver is a convenient but it is also a very light webserver, allowing no more than 5 active connections at once and with a pretty limited filesystem space, so even concatenated all resources like bootstrap icon, angular and others libraries do not work as expected and do not fit the available space. So I came with a full rewrite using pure javascript and resized resources: 1 - a compressed css based on [bootstrap](http://getbootstrap.com/css/) 2 - a local limited version of svg based of [Glyphicons Halflings](http://glyphicons.com/) to get a small footprint. 3 - a customized version of [smoothiecharts](http://smoothiecharts.org/) is used to display temperatures charts, it is simple and perfectly sized for the current purpose The result is a monolitic file with a minimal size allowing almost full control of ESP3D board and your 3D printer ## Sponsors
Support ESP3D Webui Development - Become a Sponsor
## Features - It supports several firmwares based on Repetier, Marlin, Smoothieware and GRBL. - It allows to fully configure ESP wifi - It has a macro support to add custom commands in UI by adding buttons launching some GCODE files from SD or ESP - It supports several languages, check list [here](https://github.com/luc-github/ESP3D-WEBUI/wiki/Translation-support) - It allows to display a web camera in UI or detached - It allows to edit the Repetier EEPROM, Smoothieware config file, Marlin and GRBL settings - It allows to update the ESP3D by uploading the FW - it allows to control and monitor your 3D printer in every aspect (position, temperature, print, SD card content, custom command Please look at screenshots: https://esp3d.io/ESP3D-WebUI/Version_2.X/showcase/ ## Installation Please use the latest [ESP3D firmware](https://github.com/luc-github/ESP3D/tree/2.1.x) and follow the installation process : https://esp3d.io/ESP3D-WebUI/Version_2.X/installation ## Contribution / development Check: https://esp3d.io/ESP3D-WebUI/Version_2.X/documentation/compilation/ ## Issues / Questions You can submit ticket [here](https://github.com/luc-github/ESP3D-WEBUI/issues) or open discussion if it is not an issue [here](https://github.com/luc-github/ESP3D-WEBUI/discussions) or Join the chat at [![Discord server](https://img.shields.io/discord/752822148795596940?color=blue&label=discord&logo=discord)](https://discord.gg/Z4ujTwE) ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
 Alexandre
Alexandre

πŸ’»
RenΓ© Pasold
RenΓ© Pasold

πŸ’»
aaron GitHub
aaron GitHub

πŸ’»
Pavulon87
Pavulon87

πŸ› πŸ’»
Mitch Bradley
Mitch Bradley

πŸ€” πŸ’»
Patrice CΓ΄tΓ©
Patrice CΓ΄tΓ©

πŸ’»
E2D
E2D

🌍
Cedrik Theesen
Cedrik Theesen

🌍
royfocker19
royfocker19

πŸ“–
Bart Toersche
Bart Toersche

πŸ’»
vivian-ng
vivian-ng

πŸ’»
drzejkopf
drzejkopf

🌍
Luciano Charles Moda
Luciano Charles Moda

🌍
AxelB
AxelB

🌍
Zefram88
Zefram88

🌍
3d-gussner
3d-gussner

🌍
Alex Ganov
Alex Ganov

πŸ€” πŸ’» πŸ§‘β€πŸ«
bdring
bdring

πŸ’΅ πŸ› πŸ“¦
n4d01
n4d01

🌍
Jean-Philippe CIVADE
Jean-Philippe CIVADE

🌍
kondorzs
kondorzs

🌍
Carlo
Carlo

🌍
zrwd01
zrwd01

🌍
Wesie
Wesie

🌍
DusDus
DusDus

🌍
nyarurato
nyarurato

🌍
Terje Io
Terje Io

πŸ€” πŸ’» 🌍
Ryan V1
Ryan V1

πŸ’΅
James Pearson
James Pearson

πŸ’» πŸ€”
David Buezas
David Buezas

πŸ’» πŸ›
rondlh
rondlh

πŸ’» πŸ‘€
Jason Yeager
Jason Yeager

πŸ’΅
makerbase
makerbase

πŸ’΅ πŸ“¦
abcpibot
abcpibot

πŸ’΅ πŸ“¦
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!