Skip to content

Headless Mode

Jump to bottom
GhostTypes edited this page Dec 30, 2025 · 1 revision

Headless Mode Usage

For Linux and MacOS, replace FlashForgeUI.exe with the correct way to start from the CLI, for your OS. The --enable-logging flag is only needed for Windows, or if it's not spawning a new CLI window after starting the program.

For MacOS, the command structure starts with

open "/Applications/FlashForgeUI.app/Contents/MacOS/FlashForgeUI"

For Linux, (coming soon...)

Starting Headless Mode

Launch FlashForgeUI with the --headless flag:

FlashForgeUI.exe --enable-logging --headless

The WebUI will be accessible at http://localhost:3001 by default.

Command-Line Arguments

Core Flags

--headless

  • Runs without the desktop UI
  • Starts the WebUI server automatically
  • Required for all headless operations

Printer Connection Modes

--last-used

  • Connects to the last printer you used
FlashForgeUI.exe --enable-logging --headless --last-used

--all-saved-printers

  • Connects to all saved printers
  • Enables multi-printer mode with dropdown selector
FlashForgeUI.exe --enable-logging --headless --all-saved-printers

--printers=<spec>

  • Connects to specific printer(s) by IP address and type
  • Format: --printers="<ip>:<type>:<checkcode>,<ip>:<type>:<checkcode>,..."
  • Type: new (5M family) or legacy (older models)
  • Checkcode: Required for new type printers (8-digit code)

Single printer example:

FlashForgeUI.exe --enable-logging --headless --printers="192.168.1.100:new:12345678"

Multiple printers example:

FlashForgeUI.exe --enable-logging --headless --printers="192.168.1.100:new:12345678,192.168.1.101:legacy"

WebUI Server Configuration

--webui-port=<port>

  • Sets the WebUI server port (default: 3001)
FlashForgeUI.exe --enable-logging --headless --webui-port=8080

--webui-password=<password>

  • Overrides the default WebUI password
FlashForgeUI.exe --enable-logging --headless --webui-password=mypassword

Common Usage Examples

Single Printer (Last Used)

FlashForgeUI.exe --enable-logging --headless --last-used

Multiple Printers (All Saved)

FlashForgeUI.exe --enable-logging --headless --all-saved-printers

Specific Printer by IP (New API)

FlashForgeUI.exe --enable-logging --headless --printers="192.168.1.146:new:12345678"

Specific Printer by IP (Legacy API)

FlashForgeUI.exe --enable-logging -headless --printers="192.168.1.100:legacy"

Multiple Specific Printers

FlashForgeUI.exe --enable-logging --headless --printers="192.168.1.146:new:12345678,192.168.1.129:new:87654321"

Custom Port and Password

FlashForgeUI.exe --enable-logging --headless --last-used --webui-port=8080 --webui-password=secret

Accessing the WebUI

Once running, access the WebUI from any browser on your network:

http://<server-ip>:3001

Default password is configured in your application settings (or use --webui-password= to override).

Multi-Printer Mode

When using --all-saved-printers or specifying multiple printers with --printers=, the WebUI provides:

  • Printer Selector: Dropdown to switch between printers
  • Per-Printer Camera: Each printer gets its own camera stream (ports 8181+)
  • Independent Control: Each printer maintains its own state and features

Clone this wiki locally