Releases · solutionphil/arco-unleashed

Release list

Arco Unleashed v1.3.1 (Bookworm 6.18.30) Latest

Latest

solutionphil released this 03 Sep 21:43

v1.3.1

4ca4d41

Latest build — 2026-09-04 (v1.3.1). One thread, and it starts with a bug report that read like a
hardware fault.

An owner hit MCU 'mcu' shutdown: Timer too close while homing. Running one command by hand fixed it.
That turned out not to be their problem at all — it was ours, and it had been sitting on printers
quietly.

(1) A guard could come back empty, and nothing said so. Every fix in this kit heals itself because
klipper.service runs a series of ExecStartPre guards before it starts. The root filesystem is
mounted with a 120-second commit interval, so a file written seconds before the plug is pulled can come
back with its name intact and its contents gone — and the kit asks for a power-cycle right after
writing them. Six of them were in that state on the development printer. The guards simply stopped
running, and the screen that lists them reported all twelve as fine, because it asked the directory
rather than systemd. They are flushed to disk now, and an empty guard file is named as empty with what
to run.

(2) One of those files was the only way back in. It carries the single step that runs as root, and
losing it left the printer asking for a power-cycle for ever and applying nothing: an update still
arrived and could not put itself into effect. The only exit was an SSH session. A printer in that
state now repairs itself, unattended. It costs 854 ms of boot on a healthy machine and is silent
there.

(3) A guard you switched off came back on. optimize-boot.sh had rewritten every guard file
unconditionally since the day it was written, so the next update undid the decision — and both
checkers then reported the guard as on, so nothing told you. It now leaves a guard you disabled alone,
and says that it did. The same applies to the reconcile check, whose switch the routine update path
went around entirely.

(4) The CPU fence is watched now. The setting that keeps Timer too close away was the one file no
checker could see, because a loop built its path from a variable and nothing that reads the script
could find it.

(5) ARCO_SUPPORT is in the manual at all, and the Z-offset button is documented where somebody
looking for it will be — under Calibration, with what the paper test actually measures.

The pre-built image below is freshly baked (2026-09-04) and carries this kit, on the stable
channel, with the guards pre-installed and verified non-empty.

Arco Unleashed — Full Image (pre-built, flash & run)

A complete Debian Bookworm + Klipper v0.13 image for the Phrozen Arco. Includes the Klipper
stack, the arco-unleashed kit (setup menu, AMS auto-mode, Mainsail theme) and the Arco configuration.
No proprietary Phrozen software is included — you supply Phrozen's official Arco_FW_V*.zip
yourself, or let the printer fetch the display module from Phrozen's own public repository once you
confirm.

📦 What to download

Asset	You need it for
`Arco-Unleashed-USB.zip`	everything — the image, its checksums, the self-flash tool and all guides.
`Arco-Reflash-to-Buster-USB.zip`	only if you ever want to go back to stock Phrozen Buster.

Two downloads, and most people need only the first. The image lives inside Arco-Unleashed-USB.zip
together with its .sha256 and .rawsize, so there is one thing to fetch and nothing to mismatch —
and collect_data_arco.sh is in there too, at the top level, for the one case that still needs it.

Flashing it

Extract Arco-Unleashed-USB.zip onto the root of a FAT32 stick — plugged straight into the
printer, never through a hub. Phrozen's Arco_FW_V*.zip is optional: bring it only if the printer will
have no internet during setup, or if you want PhrozenGo. Then SSH in as mks and:

cd ~/printer_data/gcodes/USB
sh prepare_unleashed_self_flash.sh

It unpacks the flasher — replacing whatever was in ~/selfflash, so the version that runs is always the
one on this stick — and asks whether to start it. Answer y, give your password, and take 3 —
Install. Type yes to the disclaimer and then the target device in full. Leave the stick in: the
display shows check → write → verify, and write and verify both say DO NOT POWER OFF, and both mean
it. The printer restarts by itself.

There is one hands-on step afterwards, and it is not optional: flashing the MCUs, which needs two
buttons pressed inside the toolhead. The MANUAL pictures every screen of it.

Going back

Take the backup the installer offers as menu item 2 before you flash — it images the whole eMMC
onto your stick, no teardown. Phrozen publish no stock image for download, though their support has
supplied one on request; a copy you take yourself is this printer, with your calibration, available
the moment you want it. Note that the eMMC is only half the machine: a return to stock also needs both
MCUs flashed back to v0.11, which the setup menu's going back to Buster does in the right order.

Documentation: MANUAL ·
QUICKSTART ·
README

Arco Unleashed is an independent, community-made project. It is not endorsed, supported or distributed
by Phrozen, and Phrozen cannot be asked for support on a printer running it. Use at your own risk — this
will very likely void your warranty.

Assets 4

Arco Unleashed v1.3.0 (Bookworm 6.18.30)

solutionphil released this 02 Sep 23:25

v1.3.0

9c816f8

Latest build — 2026-09-03 (v1.3.0). Five things an owner will notice.

(1) The Z offset has a button now, and it shows you what it measured. When the first layer sits too
low and the nozzle scratches, the value that fixes it is [probe] z_offset — and until now the only way
to set it was to edit a file. CAL_Z_OFFSET sits under Calibration in Mainsail and Fluidd: it
homes, parks over the middle of the bed, runs Klipper's own paper test, and when you press Accept it
offers to save. The offer names the number it measured beside the one the printer is running on,
because a value you cannot compare is a value you cannot judge. And it removes the step people miss:
Accept on its own changes nothing until the config is saved.

(2) The display no longer waits for ever before a print. It listens for one line — the one that says
bed levelling finished — and the kit's own G30 had quietly stopped saying it, on every printer, since
a profile load replaced the measurement. Starting a print from the touchscreen therefore sat at
levelling and never moved on, while the same file from Fluidd or the slicer printed fine. G30 measures
again during a print and only loads for the display's quick-level.

(3) A bug report is one file now. ARCO_SUPPORT, under Maintenance, writes
arco-support.tar.gz next to printer.cfg: the tail of the logs, your config, the kit version, which
features and guards are on, and the state of the host. A klippy.log passes 50 MB on a printer that has
been working a few weeks — more than anywhere you would post it accepts. This is about two. It leaves
other people's config files behind, blanks anything that reads like a key, and says in its own README
how many lines that was.

(4) An update no longer stops on a password prompt nobody typed. Updating over Mainsail, or fetching
any public repository, could halt asking for a GitHub username. Git's newer wire protocol was the cause;
the kit pins the older one, and the prompt is gone.

(5) Every guard can be switched off, and the switch works. The off switch had been unable to turn a
guard off since it was written — it looked at the wrong thing when it went to rename the file. Alongside
that, the TFT reprint bridge is withdrawn: it ran on every printer, fed a capture file that nothing
capped, and what it left behind is removed rather than abandoned.

Also: the manual explains the Errno 11 traceback owners keep finding in klippy.log — harmless, and not
something that can be switched off — and the Z-offset chapter says which of the two values in the
interface lasts, why the live one does not, and how to correct a measurement with Live Z instead of by
hand.

The pre-built image below is unchanged from v1.2.3. Only the documents in the archive are new. A
fresh flash therefore starts on the older kit and reaches this version the usual way — ARCO_UPDATE in
the console, or Moonraker's update manager.

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Asset	You need it for
`Arco-Unleashed-USB.zip`	everything — the image, its checksums, the self-flash tool and all guides.
`Arco-Reflash-to-Buster-USB.zip`	only if you ever want to go back to stock Phrozen Buster.

Flashing it

cd ~/printer_data/gcodes/USB
sh prepare_unleashed_self_flash.sh

There is one hands-on step afterwards, and it is not optional: flashing the MCUs, which needs two
buttons pressed inside the toolhead. The MANUAL pictures every screen of it.

Going back

Documentation: MANUAL ·
QUICKSTART ·
README

Assets 4

Arco Unleashed v1.2.3 (Bookworm 6.18.30)

solutionphil released this 26 Aug 23:19

v1.2.3

5ec55cb

Latest build — 2026-08-27 (v1.2.3). Five things an owner will notice.

(1) One command, and it asks what you want. The flasher used to be four flags that differ by one
word, one of which cannot be undone. Now sh prepare_unleashed_self_flash.sh unpacks the tool from the
stick and offers to start it, and what opens is a menu: check (changes nothing), back up,
install, cancel something already armed. Choosing from a list is not a confirmation — install
still asks for yes and for the target device typed out in full. The flags all still work, and where
there is no terminal to ask on the bare command still means inspect, change nothing.

(2) The install no longer refuses because of a step you did not take. Phrozen's gateway —
phrozen_master and ~/hdlDat, what the display talks to and where the AMS work mode lives — exists
only on the running original printer and is in no download. The flasher used to check for it and stop.
It now collects it itself, at the last moment it still can, verifies what it collected, and keeps
the refusal only for when that genuinely fails. An archive already on your stick is never overwritten.
By hand it now matters on one road only: writing the eMMC in a PC, where nothing of ours ever runs.

(3) A backup too large for one file is no longer invisible. A backup that crosses FAT32's 4 GiB
ceiling is written as .001, .002 — and until now the restore menu could not see it, because it
looked for a file under the plain name that a split set does not have. Worse on the way home: going
back to Buster reported "no usable image on this stick" while the parts lay on it. Both menus now
recognise either shape and show the part count beside the entry.

(4) Five features that shipped without documentation. AMS_SETUP — one dialog for which slot serves
which tool and the refeed switch — had never been written down anywhere, nor had AMS_SLOTS,
AMS_REFEED, ARCO_FILA_EMPTY or Z_TILT_LEVEL. The chamber light and the AMS refeed are named as
what they are: real toggle switches in Mainsail, not just macros, and the light follows the display.

(5) The documents were audited, and some of them were wrong. A channel switch told you to restart
Klipper; the guard that follows the channel runs on Moonraker, and the script has known that since
August. Troubleshooting sent you to a setup-menu entry a that does not exist. A callout described a
feature that had been removed. Counts had drifted — seven guards where there are thirteen, five Klipper
extras where seven are installed. Alongside that, 146 sentences were rewritten for being correct but
harder to read than they needed to be, each one checked afterwards so that no rewrite quietly dropped a
condition or a warning.

Also: Phrozen do not publish a stock image for download, but their support has supplied one on
request — the flat "there is no stock image" was wrong in six places. And a spare eMMC module alone is
not a way back: the MCU firmware sits on the chips and has to go back to v0.11 as well.

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Asset	You need it for
`Arco-Unleashed-USB.zip`	everything — the image, its checksums, the self-flash tool and all guides.
`Arco-Reflash-to-Buster-USB.zip`	only if you ever want to go back to stock Phrozen Buster.

Flashing it

cd ~/printer_data/gcodes/USB
sh prepare_unleashed_self_flash.sh

There is one hands-on step afterwards, and it is not optional: flashing the MCUs, which needs two
buttons pressed inside the toolhead. The MANUAL pictures every screen of it.

Going back

Documentation: MANUAL ·
QUICKSTART ·
README

Assets 4

Arco Unleashed v1.1.4 (Bookworm 6.18.30)

solutionphil released this 25 Aug 15:38

v1.1.4

01af846

Latest build — 2026-08-25 (v1.1.4). Five things an owner will notice.

(1) The console is readable again. Phrozen's firmware narrates itself constantly — the serial link
being re-initialised before every send, each 16-byte AMS frame printed byte by byte, the firmware version
one field per line. All of it scrolled the welcome banner away within seconds of a print starting. Of 357
console lines from a real print, six now show, and those six are the banner and actual commands. A jam
report and a missing AMS still come through: the patterns are built around keeping them.

(2) One dialog for the AMS. Which slot each tool pulls from, and the refeed switch, in a single
place — AMS_SETUP in the Macros panel. Picking the same slot for two tools is allowed: that is how
you print a four-colour file from two loaded spools. And the old AMS on / off switch is gone — the
unit enumerates as a USB device and the printer follows it by itself, so there is no longer a setting
that can disagree with the hardware.

(3) The printer shows what is plugged in. AMS and USB Stick each get a line under
Miscellaneous, green when connected and red when not. They are indicators, not buttons — clicking
one does nothing, on purpose. Fluidd shows the same two in its Runout sensors card.
Fluidd ships that card switched off, so a fresh printer now switches it on by itself; on a
dashboard you have already arranged it is left alone, and the setup menu still offers it
(w → s).

(4) A print that starts with nothing loaded is stopped. The toolhead filament sensor is visible to
the web interface for the first time, and a job that begins with an empty toolhead is paused instead
of laying down air for hours. A print running without runout protection now says so in the console rather
than staying quiet about it — and it waits until printing has actually begun, so it no longer speaks up
while the bed mesh is still probing and the start G-code has not set the mode yet.

(5) An update from the web interface now finishes the job. Installing an update from Mainsail
or Fluidd is a plain git pull, so anything that needed root — a service, a boot hook, the theme —
was left unapplied without a word. On a printer flashed from an older image that could stay true
indefinitely: every file present, nothing switched on, and no message saying so. An update now
arms the remaining work and applies it at the next start, by itself.

Arco Unleashed — Full Image (pre-built, flash & run)

A complete Debian Bookworm + Klipper image for the Phrozen Arco. Includes the Klipper stack,
the arco-unleashed kit (setup menu, AMS auto-mode, Mainsail theme) and the Arco configuration.
No proprietary Phrozen software is included — you supply Phrozen's official Arco_FW_V*.zip on a
USB stick at first boot.

📦 What to download

Asset	You need it for
`Arco-Unleashed-USB.zip`	everything — the image, its checksums, the self-flash tool and all guides. Extract it to the top level of a FAT32 USB stick.
`collect_data_arco.sh`	Step 0 below — grab it on its own so you can run it before downloading the big archive.
`Arco-Reflash-to-Buster-USB.zip`	only if you ever want to go back to stock Phrozen Buster.

The image is no longer offered as a separate download — it lives inside Arco-Unleashed-USB.zip
together with its .sha256 and .rawsize, so there is one thing to fetch and nothing to mismatch.

Before you flash — collect data from your running printer (required)

Some data the Arco needs is not in Phrozen's Arco_FW_V*.zip (phrozen_master + ~/hdlDat) —
without it the AMS detection hangs and the display misbehaves. Grab it from your still-running
original printer: download collect_data_arco.sh from this release, put it on a FAT32 USB
stick, plug that into your original Arco, SSH in, then:

bash ~/printer_data/gcodes/USB/collect_data_arco.sh ~/printer_data/gcodes/USB

(If the stick auto-mounts elsewhere, run lsblk and use that path.) This writes
arco-phrozen-ams.tar.gz onto the stick — keep it there for the install below.

Two ways to flash

Path A — easy direct flash (self-flash, no teardown). The running printer overwrites its own eMMC.
Proven end-to-end on hardware, but one shot, no net.

Extract Arco-Unleashed-USB.zip onto the root of a FAT32 stick. Add Phrozen's official
Arco_FW_V*.zip and your collected arco-phrozen-ams.tar.gz next to it.

Plug it into the printer, SSH in as mks. The stick auto-mounts at ~/printer_data/gcodes/USB (stock
printer and Unleashed). If that folder is empty, mount it to that same path yourself —
sudo mkdir -p /home/mks/printer_data/gcodes/USB && sudo mount /dev/sda1 /home/mks/printer_data/gcodes/USB
(lsblk shows the partition). Then:

cd ~/printer_data/gcodes/USB                         # where the stick auto-mounts
sh prepare_unleashed_self_flash.sh                   # unpacks the tool to ~/selfflash
sudo bash ~/selfflash/install-unleashed.sh           # inspect only — changes nothing
sudo bash ~/selfflash/install-unleashed.sh --arm     # verify, confirm, arm, reboot

Leave the stick plugged in. The display shows three named steps (check → write → verify), the
printer reboots itself, seeds its WiFi from the stick and installs Phrozen's parts from it.

If something goes wrong before the write begins — image missing, checksum mismatch, or the flasher
hangs — pull the USB stick and power-cycle. With no image on the stick the flasher stands down and
your existing system boots normally. Once the write has begun, only path B recovers the printer.

Path B — eMMC replacement / recovery. The proven route, and how you recover from a failed path A.

Extract Arco-Unleashed_bookworm_6.18.30.img.gz out of Arco-Unleashed-USB.zip — that file is
what balenaEtcher writes.
eMMC out → USB adapter → flash it with balenaEtcher → eMMC back in.
Put Phrozen's official Arco_FW_V*.zip and the collected arco-phrozen-ams.tar.gz on a
FAT32 USB stick. First boot: Wi-Fi portal → the display then installs Phrozen's parts from it.

If the printer never comes online after the flash

Wait ~90 seconds first — that is how long it tries the seeded Wi-Fi before raising its own
Arco-Unleashed-Setup hotspot for your phone. If neither appears, put a wifi-seed.txt on the
stick with three lines (SSID=, PSK=, COUNTRY=) and power-cycle: the first boot re-runs on every
power-cycle until Phrozen's firmware is installed, so it picks the file up and joins your network. Full
details in the QUICKSTART inside the archive — worth knowing, because a printer in that state has no
network, so the guides on the stick are the only ones you can open.

Afterwards (either path): SSH in as mks, set your own password, flash the MCUs and re-calibrate.
Only the toolhead F103 needs a hands-on button step, and only once — the MANUAL explains why.

See the README / QUICKSTART for the full procedure.

Assets 5

Arco Unleashed v1.1.3 (Bookworm 6.18.30)

solutionphil released this 21 Aug 23:14

v1.1.3

4edb590

Latest build — 2026-08-22. Four things an owner will notice.

(1) One dialog for the AMS. Which slot each tool pulls from, and the refeed switch, in a single
place — AMS_SETUP in the Macros panel. Picking the same slot for two tools is allowed: that is how
you print a four-colour file from two loaded spools. And the old AMS on / off switch is gone — the
unit enumerates as a USB device and the printer follows it by itself, so there is no longer a setting
that can disagree with the hardware.

(2) The printer shows what is plugged in. AMS and USB Stick each get a line under
Miscellaneous, green when connected and red when not. They are indicators, not buttons — clicking
one does nothing, on purpose. Fluidd shows the same two in its Runout sensors card.
Fluidd ships that card switched off, so a fresh printer now switches it on by itself; on a
dashboard you have already arranged it is left alone, and the setup menu still offers it
(w → s).

(3) A print that starts with nothing loaded is stopped. The toolhead filament sensor is visible to
the web interface for the first time, and a job that begins with an empty toolhead is paused instead
of laying down air for hours. A print running without runout protection now says so in the console
rather than staying quiet about it.

(4) An update from the web interface now finishes the job. Installing an update from Mainsail
or Fluidd is a plain git pull, so anything that needed root — a service, a boot hook, the theme —
was left unapplied without a word. On a printer flashed from an older image that could stay true
indefinitely: every file present, nothing switched on, and no message saying so. An update now
arms the remaining work and applies it at the next start, by itself.

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Asset	You need it for
`Arco-Unleashed-USB.zip`	everything — the image, its checksums, the self-flash tool and all guides. Extract it to the top level of a FAT32 USB stick.
`collect_data_arco.sh`	Step 0 below — grab it on its own so you can run it before downloading the big archive.
`Arco-Reflash-to-Buster-USB.zip`	only if you ever want to go back to stock Phrozen Buster.

The image is no longer offered as a separate download — it lives inside Arco-Unleashed-USB.zip
together with its .sha256 and .rawsize, so there is one thing to fetch and nothing to mismatch.

Before you flash — collect data from your running printer (required)

bash ~/printer_data/gcodes/USB/collect_data_arco.sh ~/printer_data/gcodes/USB

(If the stick auto-mounts elsewhere, run lsblk and use that path.) This writes
arco-phrozen-ams.tar.gz onto the stick — keep it there for the install below.

Two ways to flash

Path A — easy direct flash (self-flash, no teardown). The running printer overwrites its own eMMC.
Proven end-to-end on hardware, but one shot, no net.

Extract Arco-Unleashed-USB.zip onto the root of a FAT32 stick. Add Phrozen's official
Arco_FW_V*.zip and your collected arco-phrozen-ams.tar.gz next to it.

cd ~/printer_data/gcodes/USB                         # where the stick auto-mounts
sh prepare_unleashed_self_flash.sh                   # unpacks the tool to ~/selfflash
sudo bash ~/selfflash/install-unleashed.sh           # inspect only — changes nothing
sudo bash ~/selfflash/install-unleashed.sh --arm     # verify, confirm, arm, reboot

Leave the stick plugged in. The display shows three named steps (check → write → verify), the
printer reboots itself, seeds its WiFi from the stick and installs Phrozen's parts from it.

Path B — eMMC replacement / recovery. The proven route, and how you recover from a failed path A.

Extract Arco-Unleashed_bookworm_6.18.30.img.gz out of Arco-Unleashed-USB.zip — that file is
what balenaEtcher writes.
eMMC out → USB adapter → flash it with balenaEtcher → eMMC back in.
Put Phrozen's official Arco_FW_V*.zip and the collected arco-phrozen-ams.tar.gz on a
FAT32 USB stick. First boot: Wi-Fi portal → the display then installs Phrozen's parts from it.

If the printer never comes online after the flash

Afterwards (either path): SSH in as mks, set your own password, flash the MCUs and re-calibrate.
Only the toolhead F103 needs a hands-on button step, and only once — the MANUAL explains why.

See the README / QUICKSTART for the full procedure.

Assets 5

Arco Unleashed — Full Image 1.0 (superseded)

solutionphil released this 15 Aug 21:39

full/1.0

5d1efdf

Superseded — do not download from here

This was the original distribution model: one permanent release whose files were replaced with each
build. Its downloads have been removed so nobody picks up a stale image from an old link.

The current build, with every download, is the latest release:
https://github.com/solutionphil/arco-unleashed/releases/latest

Kept only as history. From v1.1.3 onwards there is one release per version, which is also what makes
the release notification fire — published only ever happens once per release, so swapping assets on
this one announced nothing.

Assets 2

Uh oh!

Releases: solutionphil/arco-unleashed

Release list

Arco Unleashed v1.3.1 (Bookworm 6.18.30)

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Flashing it

Going back

Uh oh!

Arco Unleashed v1.3.0 (Bookworm 6.18.30)

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Flashing it

Going back

Uh oh!

Arco Unleashed v1.2.3 (Bookworm 6.18.30)

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Flashing it

Going back

Uh oh!

Arco Unleashed v1.1.4 (Bookworm 6.18.30)

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Before you flash — collect data from your running printer (required)

Two ways to flash

If the printer never comes online after the flash

Uh oh!

Arco Unleashed v1.1.3 (Bookworm 6.18.30)

Arco Unleashed — Full Image (pre-built, flash & run)

📦 What to download

Before you flash — collect data from your running printer (required)

Two ways to flash

If the printer never comes online after the flash

Uh oh!

Arco Unleashed — Full Image 1.0 (superseded)

Superseded — do not download from here

Uh oh!