Releases: Parallel-7/FlashForgeWebUI
Release list
FlashForgeWebUI v1.2.0-alpha.2 (Pre-release)
FlashForgeWebUI v1.2.0-alpha.2 (Pre-release)
Standalone web-based interface for FlashForge 3D printers.
This is an alpha pre-release build intended for testing before the next stable WebUI release.
Changes
Added
- Thumbnail previews in the Recent/Local file dialog: each file now shows a lazily loaded preview image (with a "No Preview" fallback), backed by a persistent per-printer on-disk cache (
data/Thumbnails/{serial}/) so re-opening the dialog is instant
Fixed
- TVOC air-quality reading now displays on the filtration card for every printer that reports it (e.g. the Adventurer 5M Pro), instead of only the Creator 5 Pro. The Creator 5 Pro now shows the filtration card with its controls disabled rather than hiding it entirely
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binAfter startup, open http://localhost:3000 in your browser by default.
The default password is changeme unless you override it in your config or via --webui-password.
Or use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordMore Information
- README for full documentation
- CHANGELOG for the full release history
- Compare changes since v1.2.0-alpha.1
FlashForgeWebUI v1.2.0-alpha.1 (Pre-release)
FlashForgeWebUI v1.2.0-alpha.1 (Pre-release)
Standalone web-based interface for FlashForge 3D printers.
This is an alpha pre-release build intended for testing before the next stable WebUI release.
Changes
Added
- Creator 5 / Creator 5 Pro printer support via the new
Creator5Backend, including model detection, an HTTP-only connection flow, and material station support - Multi-tool temperature card for the Creator 5 series showing per-tool, bed, and chamber targets
- Read-only TVOC air-quality display for printers that report it
ifs-stationdashboard card — a real IFS Material Station grid (4 slots, material + color swatch) that refreshes from the printer's cached station status- Manual IFS slot editor with a 14-material dropdown and 24-color swatch grid, pre-seeded from the slot's current state
- "Set from Spoolman" action that snaps a Spoolman spool's material/color to the AD5X fixed palette (CIEDE2000 color matching) before applying it to a slot
POST /spoolman/slot-configroute (zod-validated, material-station gated) that calls the library'sconfigureSlot(msConfig_cmd)ifs-paletteutility (src/webui/static/shared/ifs-palette.ts) with nearest-color and nearest-material resolution, plus Jest coverage- Authenticated camera proxy (
CameraStreamProxy) that tunnels authenticated WebUI clients to the local go2rtc API at/api/camera/ws, so browsers never reach the unauthenticated go2rtc port (1984). Auth mirrorsWebSocketManager.verifyClientvia a?token=query param; WebRTC signaling rides the same socket - Test coverage for
CameraStreamProxy, camera routes, and a sharedtest-server.tsExpress fixture helper, plus additions to thecamera-utilsandprinterSettingsDefaultssuites - URL-based printer context selection: the WebUI reads
?ip=/?serial=query params to pick the active printer on load, so it stays in sync when embedded in tools like OrcaSlicer's Device tab (#16)
Changed
- IFS Material Station and Spoolman cards are now feature-gated and added/positioned by the user through the Panel Visibility picker, replacing runtime auto-reveal to match desktop behaviour
- Replaced the previous "Edit IFS Slots" button and slot-list modal with the dedicated Material Station dashboard card
@ghosttypes/ff-apibumped to^1.3.2forconfigureSlot/SlotActionsupportjest.config.jsnow maps.jsESM specifiers to.tssostatic/module specs run under ts-jestWebSocketManagermoved tonoServermode with a newhandleUpgrade(req, socket, head)method (previously bound to the HTTP server withpath: '/ws')WebUIManagernow owns a single shared HTTP upgrade router dispatching/ws→ WebSocketManager,/api/camera/ws→CameraStreamProxy, elsesocket.destroy()- Camera API contract:
camera-routesnow returns a relativewsUrl(/api/camera/ws?src=<stream>) and no longer returnsapiPort; the frontendCameraProxyConfigResponsetype droppedapiPort - Frontend camera client appends the auth token to the relative WebSocket path, and the bundled
video-rtcplayer resolves it against the page origin - README: new "Remote Access / Port Forwarding" note — forward only the WebUI port (default 3000), never the unauthenticated go2rtc port (1984)
- Removed a dead chamber-temperature clamp (
Math.min(temperature, CHAMBER_MAX_TEMP)) insetTemperaturesince the range check already rejects out-of-range values (behavior-neutral cleanup)
Removed
- Unused Playwright E2E test suites (
e2e/ande2e-emulator/),tsconfig.e2e.json, the associated npm test scripts, the Discord webhook relay helper, and thee2e-routestest endpoints - Runtime auto-reveal of the Spoolman and IFS cards (now user-added via the picker)
Fixed
- Release workflow now generates tag-based changelog comparison links in published GitHub releases
- Mobile dashboard rendered as a non-functional gray area — removed the redundant
hiddenclass on#webui-grid-mobileinindex.html(the global.hidden{display:none}rule outranked the 768px media query'sdisplay:flex)
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binAfter startup, open http://localhost:3000 in your browser by default.
The default password is changeme unless you override it in your config or via --webui-password.
Or use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordMore Information
- README for full documentation
- CHANGELOG for the full release history
- Compare changes since v1.1.0
FlashForgeWebUI v1.1.0
FlashForgeWebUI v1.1.0
Standalone web-based interface for FlashForge 3D printers.
Changes
- Migrated camera streaming to go2rtc with bundled platform binaries and unified WebRTC, MSE, and MJPEG playback
- Added OEM camera auto-detection from printer-reported stream URLs plus intelligent fallback probing of
http://<printer-ip>:8080/?action=stream - Added standalone Discord webhook notifications for multi-printer status updates and print lifecycle events
- Added Playwright end-to-end coverage plus expanded automated testing for the standalone WebUI
- Improved build and packaging flow with bundled backend output, updated per-printer settings handling, and refreshed documentation/tooling
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binAfter startup, open http://localhost:3000 in your browser by default.
The default password is changeme unless you override it in your config or via --webui-password.
Or use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordMore Information
- README for full documentation
- CHANGELOG for the full release history
- Compare changes since v1.0.2
FlashForgeWebUI v1.0.2
FlashForgeWebUI v1.0.2
Changes
- Fixed "Cannot GET /" error — Static assets now properly embedded and served in packaged binaries
- Fixed Express 5 wildcard route compatibility (/*splat)
- Fixed and improved documentation & build commands
- Added 118 new tests covering core functionality
- Added E2E testing workflow for all binary platforms (Windows, macOS, Linux x64/ARM64/ARMv7)
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binOr use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordSee the README for full documentation.
FlashForgeWebUI v1.0.1
FlashForgeWebUI v1.0.1
Changes
- Fixed Spoolman integration not deducting filament usage at the end of prints
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binOr use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordSee the README for full documentation.
FlashForgeWebUI v1.0.0
FlashForgeWebUI v1.0.0
Standalone web-based interface for FlashForge 3D printers.
Downloads
Choose the appropriate binary for your platform:
- Windows (x64):
flashforge-webui-win-x64.exe - macOS (Intel):
flashforge-webui-macos-x64.bin - macOS (Apple Silicon):
flashforge-webui-macos-arm64.bin - Linux (x64):
flashforge-webui-linux-x64.bin - Linux (ARM64):
flashforge-webui-linux-arm64.bin(Raspberry Pi 4/5, ARM servers) - Linux (ARMv7):
flashforge-webui-linux-armv7.bin(Raspberry Pi 3, older ARM devices)
Installation
- Download the appropriate binary for your platform
- Make it executable (Linux/macOS):
chmod +x flashforge-webui-*.bin - Run it:
./flashforge-webui-*.bin(orflashforge-webui-*.exeon Windows)
Usage
Run with no arguments to start the WebUI server only:
./flashforge-webui-linux-x64.binOr use CLI options to auto-connect to printers:
# Connect to last used printer
./flashforge-webui-linux-x64.bin --last-used
# Connect to all saved printers
./flashforge-webui-linux-x64.bin --all-saved-printers
# Connect to specific printer(s)
./flashforge-webui-linux-x64.bin --printers="192.168.1.100:new:12345678"
# Customize WebUI port and password
./flashforge-webui-linux-x64.bin --webui-port=3001 --webui-password=mypasswordSee the README for full documentation.