diff --git a/info-kit.html b/info-kit.html
index 5ca1d0a..5a0321d 100644
--- a/info-kit.html
+++ b/info-kit.html
@@ -106,14 +106,19 @@
Download main.py ↓
Source + README ↗
+ Two separate steps — and main.py is not a drag‑and‑drop file. The
+ RPI‑RP2 drive only accepts a .uf2 firmware file; a .py copied there is
+ discarded on reboot. You drag‑and‑drop the firmware once, then copy main.py over USB serial.
- - Install MicroPython: hold BOOTSEL, plug the Pico into USB, and drop the MicroPython
-
.uf2 onto the RPI‑RP2 drive
+ - Install MicroPython (drag‑and‑drop, one time): hold BOOTSEL, plug the Pico into USB, and drop
+ the MicroPython
.uf2 onto the RPI‑RP2 drive
(Pico /
- Pico 2).
- - Copy
main.py onto the Pico as main.py (in
- Thonny: File ▸ Save as ▸ Raspberry Pi Pico,
- or mpremote cp main.py :main.py).
+ Pico 2). It reboots
+ on its own and the drive disappears — that's correct.
+ - Copy
main.py (the Pico is no longer a USB drive, so use a serial tool):
+ in Thonny pick the interpreter
+ MicroPython (Raspberry Pi Pico), then File ▸ Save as ▸ Raspberry Pi Pico as main.py;
+ or mpremote cp main.py :main.py.
- Reset — it boots straight into the metronome.
- Add your own grooves by pasting program strings from the editor into the
PROGRAMS list at the
top of main.py. If colours, touch, or the joystick look off, flip a flag in the
diff --git a/pico/README.md b/pico/README.md
index fe95f2f..021fc70 100644
--- a/pico/README.md
+++ b/pico/README.md
@@ -21,17 +21,35 @@ buzzer, joystick, the polymeter engine — no external libraries).
The components are wired on the board — you don't breadboard anything; just seat the Pico.
-## Flash it
+## Flash it — TWO separate steps
-1. **MicroPython:** hold **BOOTSEL**, plug the Pico into USB, and copy the MicroPython UF2
- onto the `RPI-RP2` drive that appears:
- - Pico / Pico W →
+> ⚠️ **`main.py` is NOT a drag-and-drop file.** The `RPI-RP2` drive that appears in BOOTSEL mode
+> is the bootloader, and it *only* accepts a `.uf2` firmware file — anything else (like `main.py`)
+> is silently discarded on the next reboot. You first flash MicroPython with a `.uf2` (drag-and-drop),
+> and *then* copy `main.py` over the USB serial link with Thonny or mpremote. Two different steps.
+
+### Step 1 — install MicroPython (drag-and-drop a `.uf2`, one time)
+
+1. Download the MicroPython firmware **`.uf2`** for your board:
+ - Pico / Pico W → (or `RPI_PICO_W`)
- Pico 2 / Pico 2 W →
-2. **The firmware:** open `main.py` in [Thonny](https://thonny.org) (or `rshell`/`mpremote`)
- and save it to the Pico **as `main.py`**.
- - Thonny: open the file → **File ▸ Save as… ▸ Raspberry Pi Pico** → name it `main.py`.
- - mpremote: `mpremote cp main.py :main.py`
-3. Reset (replug). It boots straight into the metronome.
+2. Hold **BOOTSEL**, plug into USB → the `RPI-RP2` drive appears.
+3. **Drag the `.uf2` file onto that drive.** It copies, the Pico reboots on its own, and the drive
+ **disappears** — that's correct and means MicroPython is installed. (Don't use BOOTSEL again unless
+ you're reinstalling the firmware.)
+
+### Step 2 — copy `main.py` (over USB serial, NOT to a drive)
+
+After step 1 the Pico runs MicroPython and **no longer shows up as a USB drive** — so you can't drag
+files to it. Use a tool that talks to it over USB serial:
+
+- **Thonny (easiest):** install [Thonny](https://thonny.org), plug the Pico in normally, then
+ bottom-right click the interpreter selector → **MicroPython (Raspberry Pi Pico)** (you should see
+ a `>>>` prompt in the Shell). Open `main.py`, then **File ▸ Save as… ▸ Raspberry Pi Pico** and save
+ it as exactly **`main.py`**.
+- **mpremote (command line):** `pip install mpremote` then `mpremote cp main.py :main.py`
+
+Reset (replug) and it boots straight into the metronome.
## Controls