FluidTouch

Web Installer

Version 1.0.4

ESP32 Touchscreen CNC Controller for FluidNC

🎉 Version 1.0.4

March 23, 2026
  • A-Axis Support: Full optional 4th-axis support — enable via Settings → General → Enable A-Axis (takes effect after restart)
    • Jogging: A-axis section in Jog tab, Z/A toggle on Joystick tab right slider, Zero A button in Actions
    • Settings: Configure A-axis max feed rate and step sizes in Settings → Jog
  • Configurable Jog Steps: XY, Z, and A-axis step button values are now fully customizable per machine in Settings → Jog
  • Bugfix: Resolved crash when browsing directories with large numbers of files
  • Bugfix: First touch after wake from deep sleep no longer triggers unintended UI actions
  • Improvement: Message display now filters to info/error messages only, reducing noise
  • Serial Forwarding: Commands entered in a serial terminal are forwarded to FluidNC for debugging

📜 Prior Releases

Version 1.0.3 - Advance v1.2 Support, mDNS, WCS Enhancements

February 10, 2026
  • Display Flicker Fix: Eliminated screen flicker by migrating to ESP-IDF 5.3 and optimizing display timing
  • Basic Hardware Touch Fix: Improved touch sensitivity and reliability on Basic hardware variant
  • WCS Enhancements: Added support for WCS labels and locking specific WCSs requiring confirmation before zeroing or probing
  • Advance Hardware v1.2 Support (⚠️ Untested): Added support for Elecrow CrowPanel 7" Advance v1.2 displays
  • mDNS Hostname Resolution: Connect to FluidNC by hostname (e.g., fluidnc.local) instead of IP address
  • Upload Directory Auto-Creation: Automatically creates upload directory if it doesn't exist when uploading files
  • Open Upload Folder Button: Quick access button to open the uploaded files folder on FluidNC

Version 1.0.2 - Display Rotation & Status Tab Enhancements

January 24, 2026
  • Status Tab Updates:
    • Pause/Resume and Stop Buttons - Pause/Resume/Stop from status tab
    • Position Update on Status Tab - Click positions on status tab to update
    • WCS Update on Status Tab - Click work position values to update Work Coordinate System
  • Settings Updates:
    • Display Rotation Support - Can now rotate display 180 degrees via Settings → General
  • Web Installer Version Selection - Dropdown to select from multiple firmware versions including preview builds
  • Bugfix: Fixed handling of filenames containing spaces in upload operations

Version 1.0.1 - Bugfixes & Documentation

December 4, 2025
  • Bugfix: Touch screen not working after deep sleep wake on Basic hardware (removed GT911 sleep command)
  • Bugfix: Fixed garbled screen flash on startup by delaying backlight activation
  • Documentation Updates: Product links now use affiliate codes to help support development costs
  • Hardware Recommendation: Advance display model now marked as recommended (superior IPS display, optional battery case)

Version 1.0.0 - Initial Release

November 17, 2025
  • Real-time Machine Control: Monitor position, state, feed/spindle rates with live updates from FluidNC
  • Multi-Machine Support: Store and switch between up to 4 different CNC configurations
  • Intuitive Jogging: Button-based and analog joystick interfaces with configurable step sizes
  • Touch Probe Operations: Automated probing with customizable parameters for precise work coordinate setup
  • Macro Support: Configure and store up to 9 file-based macros per machine
  • File Management: Browse and manage files from FluidNC SD, FluidNC Flash, and Display SD card
  • Settings Backup & Restore: Export settings to JSON, auto-import on fresh install, Clear All Settings option
  • Power Management: Configurable display dimming, sleep, and deep sleep modes for battery operation

🔧 Select Version & Hardware

Elecrow CrowPanel 7" Basic

4MB Flash Memory
8MB PSRAM
ESP32-S3-WROOM-1-N4R8
Display: 800×480 TN LCD
Buy on Elecrow ↗ (affiliate link)

Elecrow CrowPanel 7" Advance Recommended

16MB Flash Memory
8MB PSRAM
ESP32-S3-WROOM-1-N16R8
⚠️ ESP32-S3 ONLY (P4 not supported)
Display: 800×480 IPS LCD
Buy on Elecrow ↗ (affiliate link)
Product links support development at no extra cost to you

⚠️ Before Installing

  • Browser: Chrome, Edge, or Opera (required for Web Serial API)
  • Cable: USB-C cable with data support (not charge-only)
  • Permissions: Allow serial port access when prompted
  • Hardware: ESP32-S3 boards only - ESP32-P4 versions are NOT supported
  • Important: Installing wrong hardware firmware will result in non-functional display

🚀 Install Firmware

Selected: Elecrow CrowPanel 7" Basic (4MB Flash)

Your browser doesn't support Web Serial API.

Please use Chrome, Edge, or Opera browser.

Serial port access not allowed.

Please check your browser permissions.

1
Connecting to device...
2
Erasing flash memory...
3
Writing firmware...
4
Verifying installation...
0% complete