Filament
This content is for 1.1 (beta). Switch to the stable release docs.
Extrusion Panel
Section titled “Extrusion Panel”
Manual filament control:
| Button | Action |
|---|---|
| Extrude | Push filament through nozzle |
| Retract | Pull filament back |
Amount selector: 5mm, 10mm, 25mm Speed selector: Slow, Normal, Fast
Safety: Extrusion requires the hotend to be at minimum temperature (usually 180°C for PLA, higher for other materials). If HelixScreen knows what filament is loaded — either from an external spool or an active AMS slot — it skips the cold-nozzle safety warning and auto-preheats to the correct temperature instead.
Load / Unload / Purge
Section titled “Load / Unload / Purge”The Filament panel has dedicated Load, Unload, and Purge buttons. These run Klipper macros — HelixScreen auto-detects common names like LOAD_FILAMENT, UNLOAD_FILAMENT, and PURGE from your printer config.
On a printer with more than one tool, the picker beside the lane bars chooses which tool these buttons act on. Its label uses your printer’s own word for a tool (Toolhead on the Snapmaker U1), and the closed picker shows just the tool’s number, or the name you gave it; open it to see the full list. When the nozzle is too cold to move filament and HelixScreen doesn’t know what is loaded, a warning takes the place of the Operations heading until the nozzle is hot enough.
Customizing which macro runs
Section titled “Customizing which macro runs”You can override any of these buttons to run a different macro:
- Go to Settings > Printing > Macro Buttons
- Scroll to the Standard Macros section
- Tap the dropdown for Load Filament, Unload Filament, or Purge
- Select (Auto) to use auto-detection, or pick any macro from your Klipper config
This works whether or not you have an AMS system. If a slot is left empty (no macro detected or configured), the button is disabled.
With an AMS system: by default the Load and Unload buttons drive your filament system directly — slot-based load and unload through the AMS — rather than running a macro. Pick a macro yourself and your choice wins: the button runs your macro and the filament system’s own handling is skipped for that operation. That is the point of the override, and it is worth knowing what it means, because your macro then owns everything the built-in path would have done — on AFC, for example,
TOOL_UNLOADno longer runs, so parking the shuttle and marking the lane are up to your macro. Set the slot back to (Auto) to hand the operation back to the filament system.The Purge button always uses your configured macro.
Manual extrude/retract
Section titled “Manual extrude/retract”For manual control without macros, use the Extrude and Retract buttons on the extrusion widget with selectable amounts (5mm, 10mm, 25mm) and speeds.
When no preheat happens first
Section titled “When no preheat happens first”Loading or unloading normally heats the nozzle to the material’s temperature before the operation starts. HelixScreen skips that preheat when something else already handles the heat, so the nozzle is not heated twice:
- your filament system heats on its own when it loads,
- your configured Load/Unload macro heats the hotend itself, or
- Allow cold load/unload is on (Settings > Printing).
What happens to the nozzle afterward
Section titled “What happens to the nozzle afterward”Loading or unloading heats the nozzle to material temperature. Two minutes after the operation finishes, HelixScreen turns the extruder heater back off — the delay lets you run several operations in a row without the nozzle cooling in between, and a running print is never touched.
If your filament system already handles this (AFC does), turn off Settings > Printing > Cool nozzle after filament ops so only one of them is driving the heater. It’s a per-printer setting. See Printing settings.
AMS / Multi-Material Systems
Section titled “AMS / Multi-Material Systems”
For multi-material systems (Happy Hare, AFC-Klipper, ACE, Tool Changer, etc.). The AMS panel has two main areas: the slot view on the left and the sidebar on the right.
Slot View (Left)
Section titled “Slot View (Left)”The left side shows all your filament slots in a visual tray layout:
- Spool icons — Each slot displays a 3D spool visualization with its filament color
- Material labels — Material type (PLA, PETG, ABS, etc.) shown above each spool
- Status badge — Slot number with color-coded background (green = loaded, gray = empty, red = error)
- Tool badge — If a slot is assigned to a specific extruder tool (T0, T1, etc.), a badge appears in the corner
Below the slot grid, a filament path diagram shows the routing from slots through the hub/selector to the toolhead. This updates in real time during load/unload operations, including eject animations when retracting filament at the slot sensor. On the Anycubic ACE the path reads the hub and toolhead sensors the driver publishes, so a strand parked partway down the tube is drawn where it actually sits - short of the hub - rather than back at the spool.
Above the slot view, a mini temperature graph shows live nozzle, bed, and chamber temperatures (when a chamber sensor or heater is present) so you can monitor heating during filament operations without switching panels. On small portrait screens there is no room to draw it, so a graph button takes its place next to the filament strip at the bottom - tap it to open the full-screen temperature graph.
Reading Error States
Section titled “Reading Error States”When a slot runs into trouble, HelixScreen shows it visually so you don’t have to dig through logs:
- Error dot — A small colored dot appears at the corner of a slot’s spool when that slot reports a problem. Red means an error (jam, runout, hardware fault); amber means a warning. With animations enabled, the dot gently pulses to draw your eye.
- Buffer-health tint: On systems with a buffer between the slots and the toolhead (an AFC buffer - a TurtleNeck, or a pressure-sensor buffer such as an
FPS_PSF- an OpenAMS filament pressure sensor, or Happy Hare with sync feedback), the hub on the filament path diagram changes color as the buffer drifts toward a fault: grey on target, amber as it drifts, red near an end stop. - Filament pressure (OpenAMS): On OpenAMS running without AFC, each unit’s filament pressure sensor appears on the filament path as a box labelled FPS, tinted live like any other buffer as the reading drifts from its target (grey on target, amber, red near an end). A sensor with no target stays untinted. Tap the box to open Buffer Status: the slider, the reading against its target (for example “FPS 53%” and “target 50%”), whether the filament is running tight, loose or balanced, and the last minute as a line that is coloured by how far off target it was. Below the target the extruder is pulling harder than the unit feeds; above it the unit is overfeeding. OpenAMS has no clog detection, so only the buffer reading is shown.
To recover:
- Use Reset in the sidebar (it reads Home on Happy Hare). This clears the error message your system is holding onto and then puts the system back to a known-good state. It is the right first move for almost every jam or fault, including one reported against a single slot. On Happy Hare it runs
MMU_RECOVERand thenMMU_HOME, which unloads any loaded filament before homing, so the button is greyed out while a print is running. On AFC it runsRESET_FAILUREandAFC_CLEAR_MESSAGE, thenAFC_RESET. - If filament from one slot is stuck partway down the tube, tap that slot. When your system can pull it back, the slot menu’s second button changes from Unload to Recover. Tap it to draw the filament back toward the slot without heating the nozzle.
- For a system-wide problem that Reset does not shift, use Recover in the AMS Management overlay (Settings). On Happy Hare this is how you run
MMU_RECOVERfrom the screen, and it moves nothing - see AMS Management for what it sends. When a Happy Hare error pops up on screen, its own Recover button sends plainMMU_RECOVERand lets Happy Hare work out the filament position from its sensors.
On Happy Hare, every fault the MMU reports opens a recovery popup showing Happy Hare’s own reason, whether it happened during a print or during a load or home you started yourself. Happy Hare’s own error prompt closes behind it. The popup offers:
- Resume - only when a print is paused, and first in the list there. Heats the nozzle first if it has cooled.
- Recover - lets Happy Hare work out where the filament is with its own sensors. First in the list when nothing is paused. Works on a cold nozzle.
- Unload - when filament is at the toolhead. Heats the nozzle first.
- Unlock - a last resort that clears Happy Hare’s pause lock without moving anything.
Sidebar (Right)
Section titled “Sidebar (Right)”The right sidebar shows the status of the currently loaded filament and provides quick-access controls.
Currently loaded section:
- “Current: Slot N” — Header showing which slot is active (or “Current: Bypass” when bypass is enabled)
- Color swatch — Large color indicator matching the loaded filament
- Material name — e.g., “Red PLA”, “Prusament PETG”
- Remaining weight — Estimated filament remaining (e.g., “750g”), if available
- Buffer slider: When your system has a filament buffer with a proportional reading (a filament pressure sensor, or Happy Hare sync feedback), a small upright slider sits at the right of the card, with the short reading and, on wider screens, its FPS or Sync label under it. Loose is up and tight is down; the block is grey on target, amber off target and red near an end. It is the same reading the Filament Buffer widget shows. Without a target the reading shows as a number only.
- Clog detection meter — When your system has flow monitoring (encoder, FlowGuard, or AFC buffer), an arc meter shows the current reading, with the sensor named underneath. It is the same reading the Clog Detection widget draws as a bar on the dashboard. When the sensor is armed but has nothing to report, the arc is replaced by a check mark
During load/unload operations, the sidebar switches to a step progress display showing each stage of the operation. The exact steps come from your filament system, so they match what it actually does rather than a generic list.
On AFC (Box Turtle, OpenAMS):
- Load into an empty toolhead: Heat nozzle → Feed filament → Purge to bucket → Brush nozzle → Kick away → Load complete
- Swap to a different slot: Heat nozzle → Cut tip → Unload filament → Feed filament → Purge to bucket → Brush nozzle → Kick away → Load complete
- Unload: Heat nozzle → Cut tip → Retract filament
If AFC’s auto_home is enabled in AFC.cfg, HelixScreen skips its home-first prompt — AFC homes the printer itself when needed.
On Happy Hare:
- Load into an empty toolhead: Heat nozzle → Select gate → Load filament → Purge → Load complete
- Swap to a different slot: Heat nozzle → Form tip → Cut tip → Unload → Select gate → Load filament → Purge → Load complete
- Unload: Heat nozzle → Form tip → Cut tip → Unload
Systems that don’t publish a step list of their own get a shorter generic bar: Heat nozzle → Feed filament → Purge, with a tip step added for a swap.
Some steps only apply to how your machine is set up. A step your system never reaches stays greyed out instead of lighting up, so a bar that skips Cut tip or Kick away is normal, not a stall. Each step updates in real time so you can see exactly where the operation is.
Action buttons (hidden while an operation is in progress):
| Button | Action |
|---|---|
| Bypass (toggle) | Feed filament directly to the extruder, bypassing the AMS. Shown when your hardware supports bypass, or when you turn on Enable Bypass Controls - see When Bypass Doesn’t Appear. The toggle is guarded: it can’t be changed while a job holds the machine (a “Bypass cannot be changed while printing” warning appears), if a lane’s filament is loaded it is unloaded first before bypass engages, and where a hardware sensor owns the bypass the toggle only reports that the sensor is in control. |
| Load | Load a slot’s filament into the toolhead. On the Snapmaker U1 it opens a picker instead - see below |
| Unload | Retract the currently loaded filament back to its slot. It also works when filament is stuck in the toolhead and no slot claims it, on systems that can tell. On the Snapmaker U1 it opens a picker instead - see below |
| Reset | Reset the AMS system state (useful after jams or errors) |
| Settings | Open the AMS Management overlay for advanced controls |
Loading or unloading several heads at once (Snapmaker U1). The U1 has a toolhead per slot, so Load and Unload there open a picker listing every head with what it holds - the material and whether it is loaded, ready to load, or empty. Unload comes with the loaded heads already ticked; Load comes with the empty-but-fed heads ticked. Tick the heads you want and confirm: if a ticked head turns out not to take the operation, it is skipped with a warning naming the head and the reason, and the rest continue. The U1 runs its own batch command, which preheats the next head while the current one finishes.
When Bypass Doesn’t Appear
Section titled “When Bypass Doesn’t Appear”Some filament systems do not report a bypass position. On those, the Bypass toggle is hidden and no external spool appears on the filament path:
| System | Reason |
|---|---|
| Anycubic ACE Pro | The ACE protocol has no bypass position - unless your rig has the fifth-spool master switch (see below) |
| Snapmaker U1 | Each toolhead has its own path, so there is nothing to bypass |
| Tool changers (generic Klipper) | Each tool has its own path |
| QIDI Box | Not implemented in the QIDI backend yet |
| Happy Hare | Only when [mmu_machine] has_bypass is 0 |
The Creality CFS no longer appears here — it has a working external spool. See CFS and the External Spool.
To show the controls anyway, turn on Enable Bypass Controls in Settings > Devices > Multi-Filament System Management. The setting appears only when your firmware reports no bypass.
With it on, the external spool appears on the filament path beside your slots. Tap it to set material, color, and brand, or to link a Spoolman spool.
The ACE Pro’s fifth spool is a working bypass. The ACE protocol has no bypass position of its own, but some rigs have a master switch that turns the whole ACE path off so a fifth spool can be fed to the toolhead by hand. Where the driver publishes that switch, HelixScreen drives it as the bypass: the switch being off is bypass engaged. There is no firmware command for it, so the switch is thrown by macros - define ACE_BYPASS_ON and ACE_BYPASS_OFF on your printer and the Bypass toggle works, with the usual unload-first and never-during-print guards. A rig without the switch, or with only one of the two macros, reports no bypass and the table above applies.
On Happy Hare, the bypass itself also works. MMU_SELECT_BYPASS does not check has_bypass - it deselects the gear steppers and reports gate -2 either way. Turn the setting on if your MMU has a bypass but reports has_bypass: 0. That happens with mmu_vendor: Other (which includes a QIDI Box driven through Happy Hare) and with a type-A selector whose bypass offset is not calibrated yet.
On the other systems, the setting changes only what HelixScreen displays. There is no bypass command to send, so the Bypass toggle reports that the operation is not supported. Use the external spool to record the material and color you loaded by hand: filament tracking, spool presets, and purge temperatures all read from it. Load and unload with your own macros or from the Extrusion panel.
On the systems where bypass genuinely engages (AFC, AD5X IFS, Happy Hare, Creality CFS, and an ACE Pro with its fifth-spool switch), it also quiets the pre-print filament checks. Filament fed through the bypass never passes through a slot, so a print started that way would otherwise be flagged for every tool it uses. See Pre-Print Filament Check. On the display-only systems above nothing is suppressed, because bypass never actually engages there.
Always Show Bypass Spool, in the same place, keeps the external spool on the filament path while bypass is disengaged. It applies to AFC systems only (Box Turtle, OpenAMS), which report a bypass sensor whether or not one is wired, so the spool is otherwise hidden until bypass is engaged.
Loading and Unloading the Bypass Spool
Section titled “Loading and Unloading the Bypass Spool”Added in 1.1.
Tap the external spool on the filament path. Alongside the spool bookkeeping (Spool Info, Select Spool, Scan QR, Clear) the menu offers Load and Unload, which feed and retract the bypass spool itself.
Bypass load deliberately does not go through the AMS. It runs your configured Load Filament macro — the same one the Filament panel’s Load button uses, set in Settings > Printing > Macro Buttons — or a plain feed if you have no macro configured. That is what the reporter of this behavior expected: with bypass engaged, the normal load routine takes over. Unload does go through the AMS on backends that expose a bypass unload, because that is how the filament gets back out of the toolhead.
If bypass is not engaged when you tap Load, it is engaged first. On systems that require it, a lane’s filament is unloaded before bypass engages, and the load starts once that finishes — the same sequence the Bypass toggle performs, so nothing is fed down the lane path by mistake.
Both entries grey out for the same reasons the Filament panel’s buttons do: while a filament operation is already running, while a job holds the machine, and — for Unload — when there is nothing at the toolhead to retract.
The same Load and Unload are on the Filament panel, which acts on the external spool whenever bypass is the current selection.
Slot Context Menu
Section titled “Slot Context Menu”Tap any slot to open a context menu with actions for that specific slot:
| Action | Description |
|---|---|
| Load | Feed filament from this slot to the toolhead. Disabled if the slot is empty. |
| Unload | Retract filament from this slot. Only available if this slot is currently loaded. Greyed out while filament sits in the toolhead that no slot claims, because the slot this menu names may not be the one holding it: use Unload in the filament sidebar instead. |
| Eject | Push filament fully out of the lane to release the spool, when the slot has filament in its lane but not loaded into the toolhead. Replaces the Unload button in that state. Only on backends that support per-lane eject (AFC and Happy Hare). |
| Recover | Pull filament that is stranded partway down the tube back toward its slot, without heating the nozzle. Takes the place of Unload when the system can tell that this slot’s filament is stuck past the hub. |
| Preload | Happy Hare only. Feed filament from the spool into its gate, ready for a later load. Greyed out during a print, while any filament is loaded, or while the MMU is busy. |
| Spool Info | Open the filament editor to view or change material, color, vendor, and remaining weight. |
| Select Spool | Assign a saved Spoolman spool to this slot. Only shown when Spoolman is configured. |
| Scan QR Code | Scan a filament QR code to auto-fill spool data. Only shown when Spoolman is configured. |
| Clear Spool | Erase everything HelixScreen and the printer’s firmware remember about this slot: your saved edits, the slot’s spool details, and the Spoolman link, plus the printer’s own record where the firmware lets it be wiped (Happy Hare’s whole gate map entry, the QIDI Box’s stored slot values). What is left afterwards is only what the hardware can physically read - on the ACE, the Snapmaker U1 and a stock CFS the firmware’s record cannot be wiped (read-only, or the RFID tag is simply re-read), so the slot repopulates from it. Shown whenever the slot carries an assignment, loaded or not. Refused on the lane feeding an active, paused or preparing print - the button greys out and says why. |
Note: On a Happy Hare printer that fills its gates from Spoolman (Spoolman pull mode), the firmware side is refused for both edits and Clear Spool, and the reason names Spoolman: make colour, material and spool changes in Spoolman itself. Clear Spool still clears HelixScreen’s own copy, so remove the spool in Spoolman to finish the job.
On systems that support Endless Spool, the context menu also includes:
- Backup Slot — Choose a backup slot to automatically switch to if this spool runs out mid-print. The backup must hold a compatible material; a slot holding something else is marked (incompatible) and can’t be picked. A slot holding the same material in a different grade — PLA-CF behind PLA, say — is marked (different grade) and can be picked: the swap will work, but filled filaments print slower and wear a brass nozzle, and this one happens mid-print without you there, so the label tells you before you choose it. This picker appears on AFC (Box Turtle) and on single-unit Happy Hare setups; a multi-unit Happy Hare shows its groups read-only, because the command that edits them acts on whichever unit is selected.
The Creality CFS is different: there is nothing to pick. Its auto-refill is managed entirely by the box’s firmware, so the Backup Slot row appears greyed out and no backup arrows are drawn between the slots. The box decides for itself which slot can stand in, and it only accepts one holding the exact same material and the exact same colour. If nothing matches, or auto-refill is switched off, it does not swap at all: the print stays paused and HelixScreen tells you which of the two it was. Auto-refill itself can be turned on or off from the CFS device actions.
Clearing every backup at once: To remove all failover assignments in one step — back to “a runout just stops the print” — open the AMS Management overlay and tap Reset Endless Spool. See AMS Management (Settings Overlay) below.
Assigning tools: Tool-to-slot mapping isn’t set from the slot context menu — it’s done from the filament mapping card that appears when you select a multi-tool file to print. See Tool Mapping below.
Editing Filament Properties
Section titled “Editing Filament Properties”Tap Spool Info in the slot context menu to open the filament editor. This lets you tell HelixScreen what’s loaded in each slot — important for systems without automatic detection (RFID).
What you can edit:
- Color — Tap the color swatch to open a color picker
- Vendor — Select from a dropdown (e.g., Prusament, eSUN, Hatchbox)
- Material — Select the filament type (PLA, PETG, ABS, TPU, Nylon, etc.)
- Remaining weight — Tap the pencil icon to enable a slider and set how full the spool is (0–100%)
Read-only info:
- Nozzle temperature range — Recommended printing temperatures (e.g., 200–230°C)
- Bed temperature — Recommended bed temperature (e.g., 60°C)
Spoolman actions (when Spoolman is configured):
- Choose Saved Spool — Browse your Spoolman database and assign a spool. This auto-fills the vendor, material, color, and temperatures.
- Scan QR Code — Scan a filament spool’s QR code to look it up in Spoolman
- More actions button (▾ dropdown) — Tap the dropdown arrow for additional actions:
- Spool Details — View the full Spoolman spool record
- Unlink — Remove the Spoolman association (appears only when a spool is linked)
- Print Label — Print a physical label for this spool (appears only when a label printer is set up)
Tap Save to apply your changes, or Cancel to discard them.
Adding brands and products from a file. The catalog can be extended or corrected by editing
user_filaments.jsoninstead of using the screen. See Editing materials and brands by hand.
Tip: favourite filaments. Tap the star on any row in the filament catalog (the brand and material picker). Starred filaments lead the vendor list in a Favorites section and float to the top of their own vendor’s list too, on every printer. Tap the star again to unstar.
Material names with punctuation or spaces. On AFC and Happy Hare the material is stored by the firmware itself, so the name has to be something Klipper accepts. Names like
PLA+,PA6-CF,PETG-CFandSilk PLAall save correctly. If a Spoolman spool’s material name contains something HelixScreen cannot send (a semicolon, a quote, a backslash, or a non-English character), the save tells you so: everything else - color, weight, Spoolman link - is still saved, and renaming the material in Spoolman using letters, digits, spaces and+ - _ . ( ) /fixes it.
Where Lane Information Comes From
Section titled “Where Lane Information Comes From”Every piece of information on a lane - color, material, brand, spool name, remaining weight - can arrive from more than one place: you edit it on the screen, the printer’s firmware reports it, or a linked Spoolman spool carries it. HelixScreen remembers which source said what, and the more trustworthy source for each field wins, rather than whichever wrote last:
- A color you pick yourself beats the linked spool’s. The spool record says what the vendor sells; your pick says what is actually loaded in that lane right now. The color name you chose travels with it, so a swatch is never labelled with a different color’s name.
- A spool linked from Spoolman owns its brand, material and spool name. While Spoolman is unreachable those fields are read-only in the editor - the picker shows the spool’s own values instead of letting you type over what the server will replace anyway. The spool’s remaining weight also comes from the server.
- Your edits are marked as yours in the record the printer shares with other tools, so Mainsail, OrcaSlicer or a macro refreshing that record does not wipe what you entered.
- A reading that leaves a field out leaves it standing. A status frame that says nothing about, say, brand keeps whatever another source already knew.
Swapping a spool is noticed, even with the screen off. Each lane remembers a fingerprint of the spool it held, so a spool swapped while HelixScreen was not running clears the old spool’s edits instead of painting them onto the new one. This works on the QIDI Box, on the Creality CFS (including community Kalico-based CFS setups), and - by RFID tag - on the Snapmaker U1.
Tool Mapping
Section titled “Tool Mapping”For multi-tool prints, you can control which AMS slot feeds each tool the slicer expects (T0, T1, T2, …). The mapping controls appear as a filament mapping card on the file detail screen — open a file from the print browser and, if your file uses multiple tools and your AMS supports editable tool mapping, the card shows a compact row of color pairs. Tap the card to open the Filament Mapping dialog.
In the dialog you get one row per tool in the file:
- Map to closest colors with matching material (toggle at the top) — When on, HelixScreen auto-assigns each tool to the loaded slot with the nearest color and a compatible material; the rows become read-only. When off, you assign tools yourself.
- Manual assignment — With the toggle off, tap a tool’s row to pick which slot feeds it.
- Mismatch warnings — A warning icon appears on any row mapped to an empty slot or a slot whose material doesn’t match what the tool needs.
Tap Done to keep your mapping, or Cancel to discard it.
Tip: When you actually start the print, HelixScreen re-checks these mappings and stops with a Check filament dialog if any required tool points at an empty slot — unless bypass is engaged, in which case the mappings aren’t feeding the print and the check is skipped. See Print Monitoring & Failure Detection.
Note: The mapping card only appears on backends with editable tool mapping. On fixed 1:1 systems (Snapmaker U1, ACE) tools always map directly to their matching slot, so there’s nothing to assign.
Note: The card also hides itself while bypass is engaged on a single-tool file, because the print takes its filament from the external spool and the mapping decides nothing — showing it would offer an assignment the print ignores. The Bypass active note on the file detail screen appears in its place. A multi-tool file with bypass engaged still shows the card: those prints do use the lanes.
Printers that remap by rewriting the file
Section titled “Printers that remap by rewriting the file”Most filament systems carry out your mapping themselves: HelixScreen tells the printer “tool 0 comes from slot 2” and the printer does the rest. A few can’t, because their firmware has no mapping table. On those, HelixScreen rewrites a copy of the G-code with the new tool numbers and prints that copy. Today that means a tool changer running without klipper-toolchanger, such as the MedusaHC fork that drops [toolchanger].
This needs the HelixPrint plugin on your printer. Without it the mapping card offers to install it instead. With it, the finished job is listed in print history under its original name (details).
What the rewrite changes:
- Tool changes:
T0,T1, … - Temperature commands for a specific tool:
M104 T1 S220,M109 T0 S230 - An
INITIAL_TOOL=orTOOL=value on any command line, such asPRINT_START INITIAL_TOOL=0orSET_TOOL_TEMPERATURE TOOL=1, so a start macro that picks up or primes the first tool picks up the right one
What it does not change: any other per-tool value you pass to your start macro, such as EXTRUDER_TEMP=, EXTRUDER1_TEMP=, T0_TEMP=, TOOL_TEMP= or T=, and a tool given by name rather than number (TOOL=T0). Those names are your own macro’s, and HelixScreen can’t know whether EXTRUDER_TEMP means “tool 0” or “the tool this print starts with”, so it leaves them as sliced. If your start macro heats tools from those values, a job remapped from tool 0 to tool 1 heats tool 0 and then switches to a cold tool 1.
When the file you picked passes values like these and your picks move at least one tool to a different number, the Filament Mapping dialog shows a warning naming them, for example:
Your PRINT_START line passes per-tool settings that remapping does not change (EXTRUDER_TEMP, EXTRUDER1_TEMP). A remapped tool may not be heated.
The warning appears and disappears as you change the picks: leave every tool on its own number and there is nothing to warn about, because the file prints as sliced. It doesn’t stop you remapping; if your macro doesn’t use those values to heat anything, you can ignore it.
Recommended start G-code. Do the tool heating in plain M104/M109 lines, which the rewrite does change, and keep only the bed, homing and mesh in PRINT_START. In OrcaSlicer’s Machine start G-code (one M104 line per tool your printer has):
PRINT_START INITIAL_TOOL=[initial_tool] BED_TEMP=[bed_temperature_initial_layer_single]{if is_extruder_used[0]}M104 T0 S{idle_temperature[0]}{endif}{if is_extruder_used[1]}M104 T1 S{idle_temperature[1]}{endif}{if is_extruder_used[2]}M104 T2 S{idle_temperature[2]}{endif}{if is_extruder_used[3]}M104 T3 S{idle_temperature[3]}{endif}M109 T[initial_tool] S{first_layer_temperature[initial_tool]}Keep the M109 for the first tool last. It sets that tool from its idle temperature up to printing temperature and waits, so it has to come after the idle lines. INITIAL_TOOL= and TOOL= are fine to keep if your macro uses them: the rewrite moves them along with everything else. OrcaSlicer adds a T[initial_tool] line right after the start G-code, and that line is remapped too.
Syncing with OrcaSlicer (2.3.2 and later, including 2.4.0)
Section titled “Syncing with OrcaSlicer (2.3.2 and later, including 2.4.0)”When you edit spool info in HelixScreen — on any supported filament system (AD5X IFS, Snapmaker U1, ACE, CFS) — that information is saved to your printer in the standard location OrcaSlicer 2.3.2 and later reads automatically. Open OrcaSlicer after editing and your slot’s vendor, material, color, and temperatures show up in the filament panel with no extra setup.
AFC (Box Turtle) and Happy Hare work the same way automatically — your lane assignments flow through to OrcaSlicer with nothing to configure.
Either way, your printer’s filament info and OrcaSlicer stay in sync. The sync is one-way (your printer → OrcaSlicer): editing in OrcaSlicer doesn’t change what’s loaded in your AMS.
Precise names on-screen, matchable names in OrcaSlicer. You can name your filament as specifically as you like — “ASA-GF”, “PLA Silk”, “PPS-CF” — and HelixScreen keeps showing that exact name on the printer. OrcaSlicer only recognizes broader material families, so when HelixScreen syncs it automatically translates your precise name to the closest one OrcaSlicer knows. That’s why a slot showing “ASA-GF” on your printer may appear as “ASA” in OrcaSlicer. This is expected — the color and temperatures still come across correctly, and OrcaSlicer now picks a real ASA preset instead of falling back to a generic PLA one.
Tip: For an unusual material OrcaSlicer doesn’t recognize at all, the slot may sync with its color and temperatures but no material selected, rather than a wrong guess. Just pick the filament yourself in OrcaSlicer that one time — your printer keeps showing the precise name.
Requirements: OrcaSlicer 2.3.2 or newer, connected to the same printer’s Moonraker. Nothing to enable on the HelixScreen side — it’s automatic.
AMS Management (Settings Overlay)
Section titled “AMS Management (Settings Overlay)”Tap Settings in the sidebar to open the AMS Management overlay with advanced controls:
- Home — Return the AMS to its home position. Sends
MMU_HOMEon Happy Hare (which unloads any loaded filament first) andAFC_RESETon AFC. Unlike the sidebar’s Reset, it does not clear the error message first. - Recover — Attempt to recover from an error state. On Happy Hare this runs
MMU_RECOVER, which tells Happy Hare what is really selected and loaded when its tracking has gone wrong; nothing moves. A dialog asks which gate is actually selected (it starts on the current one; you can also pick Bypass, or Keep current to leave the gate alone) and whether filament is loaded (Detect automatically, the default, lets Happy Hare check its sensors; or choose Loaded / Unloaded). HelixScreen then sendsMMU_RECOVERwith only what you set:GATE=orBYPASS=1, plusLOADED=1orLOADED=0. On AFC, Recover sendsAFC_RESET, the same as Home. - Abort — Cancel the current operation immediately
- Bypass Mode — Toggle direct-feed mode (if supported by hardware). The toggle refuses while a filament operation is running, and on systems that require it, while filament is still loaded - unload first. When a hardware sensor owns the bypass, this row becomes a read-only “Controlled by hardware sensor” indicator instead of a toggle. If your machine has no bypass according to its firmware, an Enable Bypass Controls toggle appears here instead - see When Bypass Doesn’t Appear
- Always Show Bypass Spool — Keep the external spool visible on the filament path even while bypass is disengaged (AFC systems only)
- Keep Spool Info on Eject — When a lane is emptied, keep its spool details so reloading the same spool after maintenance needs no re-selection (on by default). Turn it off to start fresh when a lane empties. This applies only to spools you selected in HelixScreen: a spool assigned elsewhere (such as Mainsail) clears with the lane. To have every assigned spool remembered no matter where it was picked, use the firmware’s own retention instead (AFC:
remember_spoolin AFC.cfg) - HelixScreen follows the spool the firmware reports. Note that when the firmware’s own retention is switched on for every lane, it takes precedence: this toggle then has no effect and shows as disabled with a note explaining why. Shown on systems whose firmware tracks spool ids per lane (such as AFC and Happy Hare); systems that detect spool swaps by tag always refresh on a swap regardless of this setting. - Reset Endless Spool — Wipe every slot’s backup assignment at once, so a runout stops the print until you set up failover again. Only appears on systems whose failover you can edit here (AFC, single-unit Happy Hare); hidden on CFS and AD5X, which manage it in firmware. Asks you to confirm before clearing. See Endless Spool / Backup Slot above.
- System status — Current system state and firmware version
Below the top-level controls, device-specific settings appear as expandable sections that vary by hardware. Tap a section to open it; inside you’ll find buttons, on/off toggles, and sliders for that group, and changes apply immediately.
AFC (Box Turtle and friends) exposes the richest set, organized into sections:
| Section | What’s inside |
|---|---|
| Setup | Run Calibration Wizard, Bowden Length, LED toggles (system + per-toolhead), Quiet Mode |
| Speed Settings | Forward and reverse move-speed multipliers |
| Toolhead | Sensor-to-nozzle, unload, and post-sensor clear distances (per tool) |
| Maintenance | Test All Lanes, Change Blade, Park, Clean Brush, Reset Motor Timer |
| Hub & Cutter | Cutter enable, cut distance, hub bowden length, assisted retract |
| Tip Forming | Ramming volume, unloading start speed, cooling-tube length and retraction |
| Purge & Wipe | Purge enable/length, brush-wipe enable |
Happy Hare groups its controls into Setup, Speed, Toolhead, Accessories and Maintenance. A few worth knowing:
- Load Extruder and Unload Extruder (Maintenance) run only the extruder part of a load or unload, for filament that is already at the toolhead. Happy Hare heats the nozzle for them. Not available during a print.
- Motors (Maintenance) switches the MMU’s motors on or off. Switching them on does not home the MMU.
- Refresh Spoolman (Accessories) asks Happy Hare to re-read its spool details from Spoolman. Greyed out when Spoolman support is off in Happy Hare.
Other backends show their own (usually smaller) set of sections, or none at all.
- When an AMS slot is actively loaded, its material information drives spool preset behavior — you’ll see a spool preset button on the Filament and Temperature panels, and purge macros receive the correct temperature automatically. See External Spool Configuration for details.
- The filament path diagram at the bottom of the slot view is interactive — you can tap slot entry points to trigger a load.
- During a load or unload, watch the step progress in the sidebar to track exactly where the operation is.
Multiple Filament Systems
Section titled “Multiple Filament Systems”HelixScreen supports running multiple filament management backends at the same time. For example, a toolchanger printer might use both a Tool Changer backend and Happy Hare for different parts of the filament path.
When multiple backends are detected:
- A backend selector appears at the top of the AMS panel
- Tap to switch between systems (e.g. “Happy Hare” vs “Tool Changer”)
- Each backend has its own slots and status display
- Slot assignments and controls are independent per backend
Supported system types:
| System | Description |
|---|---|
| CFS | Creality Filament System (K2 series, plus K1/K1C/K1 Max with the official CFS upgrade) |
| Happy Hare | MMU2, ERCF, 3MS, Tradrack, EMU |
| AFC | Box Turtle, OpenAMS, ViViD |
| OpenAMS | klipper_openams without AFC. Needs a klipper_openams version that publishes its UI API; Load and Unload also need the OPENAMS_LOAD / OPENAMS_UNLOAD macros from its oams_macros.cfg |
| ACE | Anycubic ACE Pro (via ValgACE/BunnyACE/DuckACE Klipper drivers) |
| Tool Changer | Toolchanger-based filament routing |
| AD5X IFS | FlashForge Adventurer 5X Intelligent Filament Switching (requires ZMOD firmware v1.7.0 or newer) |
| SnapSwap | Snapmaker U1 4-toolhead changer (parallel, one independent toolhead per slot) |
Each system displays its own logo in the AMS panel header. Happy Hare and AFC show their firmware logos; specific hardware variants (ERCF, Box Turtle, ViViD, etc.) show hardware-specific logos when detected.
With a single backend there is no selector — the panel just shows that system.
Creality Filament System (CFS)
Section titled “Creality Filament System (CFS)”The CFS is an enclosed filament storage and delivery system for Creality printers. It ships on the K2 series, and is also supported on the K1, K1C, and K1 Max once you install Creality’s official CFS upgrade kit and firmware. Each CFS unit holds 4 spools of filament, and up to 4 units can be connected (16 total slots). HelixScreen auto-detects CFS when connected, along with the set of commands your printer’s firmware actually understands — there are three, and it works this out from the firmware itself rather than assuming based on your printer model.
K1 series note: CFS on the K1, K1C, and K1 Max requires Creality’s official CFS upgrade firmware (v2.3.5.33 or newer). Detection is automatic; no manual configuration is needed.
Running community firmware? Some K2 Plus owners replace Creality’s firmware with a community build that has its own rewritten CFS module. HelixScreen recognizes those automatically and supports them fully — slots, spools, colors, humidity and temperature all display, and loading, unloading and filament changes all work from the touchscreen. Nothing to configure.
Slot Layout
Section titled “Slot Layout”CFS uses a TNN address format to identify each slot:
| Unit | Slot A | Slot B | Slot C | Slot D |
|---|---|---|---|---|
| Unit 1 | T1A | T1B | T1C | T1D |
| Unit 2 | T2A | T2B | T2C | T2D |
| Unit 3 | T3A | T3B | T3C | T3D |
| Unit 4 | T4A | T4B | T4C | T4D |
Each slot displays the detected filament color, material type (PLA, PETG, ABS, etc.), brand, and remaining filament length.
RFID Detection
Section titled “RFID Detection”CFS units have built-in RFID readers that automatically detect Creality filament spools:
- Place a spool in any slot and its material info appears within seconds
- Supported materials include Hyper PLA, Hyper PETG, Hyper ABS, CR-PLA, CR-Silk, and more
- Remaining filament length is tracked automatically
- If a spool isn’t recognized, a generic entry is shown — you can identify it manually
Tip: If a slot shows incorrect info, remove and re-seat the spool to trigger a fresh RFID read.
CFS Device Actions
Section titled “CFS Device Actions”Tap the menu icon on the CFS panel to access device actions:
| Action | What It Does |
|---|---|
| Refresh | Re-read all RFID tags across all units — useful after swapping spools while the printer was off |
| Auto-Refill | Toggle automatic backup spool switching. A runout pauses the print either way; with this on, the box then swaps in another slot only if one holds the exact same material and colour, and resumes. With it off, or with no match, the print stays paused |
| Nozzle Clean | Trigger the nozzle cleaning routine using the CFS’s built-in silicone strip |
CFS and the External Spool
Section titled “CFS and the External Spool”Every CFS printer has a spool holder that feeds the toolhead directly, next to the CFS, and HelixScreen’s Bypass toggle drives it. How much the firmware does for you depends on which CFS firmware you have:
Community K2 Plus firmware (Kalico port): the bypass is fully automatic. Turn the Bypass toggle on and the printer takes over — it heats, moves to the waste bin, and waits for you to insert the filament into the holder. Feed it in, and the printer draws it to the toolhead and flushes. Turning the toggle off reverses the whole thing: the printer retracts and cuts, then asks you to pull the filament out. The external spool also appears on the filament path, and you can tap it to set material, color, and brand or link a Spoolman spool.
Stock K1/K2 firmware (Creality’s own): you feed the holder by hand. Creality’s firmware has no command that loads from the holder — even Creality’s own screen leaves the feeding to you. When you turn the Bypass toggle on, HelixScreen stands the CFS down so it cannot push bay filament into the tube your spool is using, then watches the toolhead sensor: the moment it sees your filament, the external spool shows as active. Inserting and removing the filament updates this automatically. Turning the toggle off re-arms the CFS for normal printing. You can still tap the external spool to record material, color, and brand, and prints started from bypass skip the loaded-filament checks.
Both firmwares: the external spool is also published to your slicer. When bypass is available, the spool appears as one extra lane past the CFS’s own lanes in OrcaSlicer’s printer-adapter view (T4 beside T0–T3, for example), carrying the material, color, and spool info you set — so a single-tool file can be mapped straight onto it. Creality’s firmware doesn’t write this lane itself, so it disappears if the printer restarts until the next time you engage bypass or edit the spool.
Turning bypass on also switches the toolhead runout sensor on at the printer (stock firmware normally leaves it off outside CFS operations), so a bypass print is protected against running out mid-print. Turning bypass off restores the sensor’s previous state.
Tip: On stock firmware, turn bypass on before you feed the holder. The toolhead sensor can only attribute filament to the external spool while the bypass toggle is on — filament that appears without it is treated as unknown, not bypass.
Snapmaker U1 (SnapSwap)
Section titled “Snapmaker U1 (SnapSwap)”The Snapmaker U1 is a 4-toolhead changer, not a shared-path AMS. Each of its four slots has its own independent toolhead, so the topology is parallel — every slot keeps its own spool permanently attached to its own tool. There is no hub or selector to share between slots.
That fixed slot-to-toolhead pairing is not the same thing as which toolhead prints which part of your file. When you start a print, the printer is told which head to use for each colour in the file, matching on the filament that is actually loaded. So a file sliced with its first colour red will print red even if your red spool sits in the third slot — you do not have to rearrange spools to match the slicing order.
The model preview on the print screen follows the same routing: each part of the model is drawn in the colour of the filament that will really print it, not in the slicer’s slot order. If the preview colours look swapped compared to your slicing software, that is the preview showing you what the printer is actually going to do.
RFID Detection
Section titled “RFID Detection”Each channel has an RFID reader that reads Snapmaker filament tags automatically:
- Material type and sub-type (e.g. “PLA SnapSpeed”), manufacturer, and brand appear per slot
- Color, recommended nozzle/bed temperatures, and spool weight come from the tag
- When you physically swap a spool, the new tag is detected and any stale metadata you’d previously entered for that slot is cleared automatically
You can still edit spool info manually from the slot context menu for spools without a tag.
Runout and Resume
Section titled “Runout and Resume”The U1 tracks filament with a motion sensor per tool. When a runout fires mid-print, HelixScreen prepares the printer before resuming — disabling the runout sensor, heating the tool, priming a short length of filament past the encoder, and re-enabling the sensor — so a plain Resume actually continues the print. If the motion sensor reports a runout but filament is still physically present (a stale sensor reading), HelixScreen recovers silently without prompting you.
Note: Because each toolhead is independent, the Snapmaker backend has no Home, Recover, Reset, Bypass, or Endless Spool controls — those apply to shared-path AMS hardware only.
MedusaHC (Hotend Changer)
Section titled “MedusaHC (Hotend Changer)”MedusaHC swaps only the hot end — heater, thermistor and fan — rather than a whole toolhead. It runs on top of klipper-toolchanger, so HelixScreen shows it as a tool changer with parallel topology: each tool is its own independent path, with no hub or selector.
You don’t need to configure anything. HelixScreen recognises a MedusaHC automatically when your Klipper config has both a tool changer and MedusaHC’s own dock sensors.
Which tool is mounted
Section titled “Which tool is mounted”MedusaHC has a sensor at each dock, and HelixScreen trusts those sensors over what the toolchanger thinks it picked up. That matters after a failed or partial pickup: the toolchanger will still report the tool it was told to fetch, while the docks know it never arrived.
If the sensors can’t agree on what’s on the head, HelixScreen shows an error rather than guessing. That state is deliberately not shown as “no tool” — starting a tool change from an unknown position risks driving the carriage into a dock. Clear it by running a tool change or your printer’s error-recovery macro from the console.
The filament feeder
Section titled “The filament feeder”Because only the hot end travels, the filament is held by a servo gripper on the frame instead of by the moving toolhead. You’ll find Open feeder and Close feeder under the AMS panel’s Settings button, in Device Operations.
Use Open feeder to release the filament when you’re clearing a jam or loading a fresh spool by hand, then Close feeder to grip it again.
Note: These are refused while a print is running. The gripper is the only thing holding your filament — releasing it mid-print drops the strand and ruins the job.
HelixScreen picks the right macro for your setup automatically, whether you’re on the original MedusaHC config or the newer Python controller.
If your setup uses different macro names — you’ve renamed them, or you’re part-way through migrating to the Python controller — you can choose them yourself. In the same Device Operations screen, Open feeder macro and Close feeder macro list the macros found on your printer. Leave them on auto to keep HelixScreen’s automatic choice, which also means you’ll pick up the newer commands for free if you migrate later.
Tool mapping
Section titled “Tool mapping”You can point a G-code tool number at a different physical tool, which is useful when a slicer project expects a different tool order than your machine is loaded with. See Tool Mapping above for the dialog itself.
How the mapping reaches the printer depends on your setup:
- Original MedusaHC config or the Python controller (your config has
[toolchanger]): HelixScreen tells klipper-toolchanger the mapping and the file is printed as sliced, like any klipper-toolchanger machine. - topi314’s fork (no
[toolchanger]): there is no mapping table to write, so HelixScreen rewrites the file instead. That needs the HelixPrint plugin, and any per-tool temperatures you pass toPRINT_STARTstay as sliced. Read Printers that remap by rewriting the file before your first remapped print; it has start G-code that heats the right tools.
What HelixScreen remembers per tool
Section titled “What HelixScreen remembers per tool”Your printer reports nothing about the filament in each hot end — no material, no colour, no brand. So whatever you set in HelixScreen is the record, and it’s kept for you: material, colour, brand, spool name, and remaining weight, per tool.
That survives restarts and reconnects. It’s stored on your printer via Moonraker rather than only on the screen, and it uses the same records Mainsail writes, so spools you’ve assigned there should show up here and vice versa.
One consequence worth knowing: nothing on a tool changer can detect that you physically swapped a spool, so HelixScreen keeps showing what you last told it until you change it. Edit the slot when you switch filament.
Note: Like other tool changers, MedusaHC has no Unload, Bypass, Endless Spool or dryer controls — each tool is its own path, and those apply to shared-path AMS hardware.
Spoolman Integration
Section titled “Spoolman Integration”Spoolman is an optional filament-inventory server. Once it’s connected, the AMS panel shows saved spool data on each slot and lets you assign spools straight from your inventory:
- Spool name and material type shown per slot
- Remaining filament weight shown
- Tap a slot’s Spool Info or Select Spool to assign a saved spool — see Editing Filament Properties and the Slot Context Menu
Connecting a server, the full spool-inventory panel, the new-spool wizard, and how remaining weight is tracked all live on their own page: Filament Tracking & Spoolman.
Filament Drying and Humidity
Section titled “Filament Drying and Humidity”Many filament materials absorb moisture from the air over time. Wet filament prints poorly - you may see popping, stringing, reduced layer adhesion, or a rough surface finish. Drying the filament before or during a print removes that moisture and restores print quality. Hygroscopic materials that benefit most include Nylon, PA-CF, TPU, and PETG; PLA is less sensitive but still benefits after long storage.
HelixScreen groups all of this into boxes. A box is one enclosure it can measure, heat, or both. What counts as a box depends on your hardware: a box can be a whole unit, a group of slots inside a unit, or a single lane with its own heater and sensor.
A box is not a unit. The slot range printed under the box name is the only thing that tells you which lanes that box covers. Read it before you start a dry.
Supported Systems
Section titled “Supported Systems”| System | What you get |
|---|---|
| Anycubic ACE Pro | Temperature, humidity, and drying (built-in heated chamber) |
| QIDI Box | Temperature, humidity, and drying (PTC heater; QIDI PLUS4, Q2, MAX4) |
| Happy Hare | Temperature and humidity wherever sensors are configured, drying wherever a filament heater is. A setup with per-lane heaters and sensors reports each lane as its own box |
| Creality CFS | Temperature and humidity, one box per unit. The CFS has no heater, so there is nothing to start |
AFC (Box Turtle, OpenAMS), AD5X IFS, Snapmaker U1 and tool changers report no environment data at all, so nothing appears for them.
QIDI Box note: QIDI Box drying control requires recent QIDI firmware that exposes the
box_extrasKlipper plugin. On older firmware the heater still works, but the session timer isn’t tracked - the heater runs until you tap Stop.
Opening a Box
Section titled “Opening a Box”On the Filament panel, any box with a reading or a heater shows a small badge beside its slots: a thermometer with the temperature, and a water drop with the humidity where a sensor exists. Tap the badge. That is the whole route - there is nothing to open under Settings.
What opens depends on how many boxes that unit has:
| Boxes | What you get |
|---|---|
| One | That box’s screen |
| Two to four of the same kind | That box’s screen, with a tab per box across the top |
| More than four, or a mix of heated and unheated boxes | A list of boxes; tap a row to open one |
Each tab carries a small icon for the box it names, so you can tell which box is heating, which is waiting and which has finished without selecting it first.
A mix always goes to the list rather than to tabs, because a tab would hide the difference between a box you can heat and one you can only watch behind a selection you have to make first.
When the screen is showing fewer boxes than the printer has, a View all boxes line appears above the card. Tap it for the full list across every unit, with a count of units, boxes and dryers under the title. The list itself has no controls: each row gives the box name, its slot range, its current reading and a one-word status. Tap a row to open that box, where the controls are.
Reading a Box
Section titled “Reading a Box”The title names the box, and the line under it gives its slot range.
- Temperature is always shown.
- Humidity is shown only where that box has its own humidity sensor. A box without one reads
--, and the Material Comfort strip is hidden rather than guessed at. That is deliberate: with no humidity reading, a comfort verdict would be a made-up all-clear. - While a cycle runs, the temperature reads current then target, a countdown gives the time left, and a progress bar fills.
The same rule reaches the status column in the box list: a box with a heater but no humidity sensor reads -- there instead of a status word, and a box with no heater at all reads passive.
A box with no heater says so on its own screen, and points you at a sealed dry box with desiccant instead.
The reverse case also shows up: a heated box with no sensor of its own still gets a badge, with a dash where the temperature would be, so its controls are still one tap away.
Starting and Stopping a Dry
Section titled “Starting and Stopping a Dry”The controls are on the right of the box’s screen:
- Pick a preset from the dropdown. Each entry names a material with its temperature and time, like “PLA 55°C/4h”, and fills in both fields below.
- Or set the values yourself. Tap the temperature field or the minutes field to bring up a keypad.
- Tap Start Drying.
While a cycle runs, that same button reads Stop Drying, and it is also the cancel - there is no separate cancel button. Stopping is safe at any point: the heater goes off and the remaining time is discarded. There is no fan control.
Three things about the fields are worth knowing:
- The duration field is in minutes, not hours. Only the preset labels read in hours, so a preset called “4h” puts
240in the field. Cycles shorter than an hour are fine. - The temperature range is that box’s range, and it is printed in the field’s own label - “Temp °C (35-65)”. The keypad won’t accept anything outside it. A preset whose usual temperature sits above the ceiling is shown and sent clamped, so a 70 °C preset on a 65 °C box reads 65 °C, and 65 °C is what runs.
- Your last values come back. HelixScreen remembers the temperature and duration you last started a dry with, per printer, and fills them in the next time you open a box.
Left alone, HelixScreen picks the preset that suits the filament in that box - the most conservative one, meaning the lowest drying temperature among the materials loaded there, so a mixed box isn’t dried at the temperature its most tolerant spool would take. Type a value yourself and that stops for the rest of the visit; pick a preset by hand and it starts again.
Material Comfort
Section titled “Material Comfort”Where a box has a humidity sensor, a Material Comfort strip sits below the readouts. It lists the materials loaded in that box, each with a verdict - OK, Marginal or Too humid - and the humidity ceiling that material is judged against, written as “PLA: OK (< 50%)”. Materials differ enormously in what they tolerate: nylon and the high-temperature engineering plastics want a far drier box than PLA does, so the same reading can be comfortable for one spool and too wet for the one beside it. If none of the box’s slots report a material, the strip falls back to the materials on your temperature presets.
The one-word status in the box list is a second, more general scale, applied to the box rather than to any material in it. So a box can read OK in the list while a demanding material reads Marginal in the strip. For what you actually have loaded, the strip is the one to go by.
Typical Drying Parameters
Section titled “Typical Drying Parameters”These are general-purpose starting points. Your filament manufacturer’s guidance takes priority.
| Material | Temperature | Time |
|---|---|---|
| PLA | 45 °C | 4–6 h |
| PETG | 55 °C | 4–6 h |
| ABS / ASA | 60 °C | 4 h |
| TPU / TPE | 50 °C | 4–8 h |
| Nylon (PA) | 60 °C | 8–12 h |
| PA-CF / PA-GF | 60 °C | 8–12 h |
Filament that has been stored open for a long time may need the longer end of the range.
Remember that the duration field takes minutes: 4 hours is 240, 12 hours is 720.
Several Boxes at Once
Section titled “Several Boxes at Once”Boxes are measured independently, but they aren’t always heated independently. Some hardware runs one heater at a time. Where your filament system reports that, starting a dry on a second box doesn’t begin heating it - the box waits its turn, and the screen says so:
- A banner with a clock icon reads “Waiting for box to finish. One heater at a time.” (or just “Waiting for another box to finish.” when the box holding the heater can’t be named)
- That box’s tab shows a clock instead of the heat symbol
- No progress bar appears until the box is actually heating
Nothing has gone wrong and there’s nothing to retry. When the running cycle ends, the waiting box takes the heater.
Where the hardware has no such limit, boxes heat independently and more than one cycle can run at a time.
Whichever shape you have, the readouts, the Material Comfort strip and the drying controls all belong to the box named in the title - not to the unit, and not to the first box on the printer.
See Also
Section titled “See Also”- Filament Tracking & Spoolman — How remaining weight is tracked, with and without Spoolman, and how to connect a Spoolman server
- Temperature Control — Preheat presets work with spool material info
- Bluetooth Setup — Required for Bluetooth-connected AMS and label printers
- Label Printing — Print physical spool labels with Spoolman data
- Settings: Devices — AMS, Spoolman, and filament sensor configuration
Next: Filament Tracking & Spoolman | Prev: Motion & Positioning | Back to User Guide