PICOTOOL-CONFIG(1)

💖 PICOTOOL-CONFIG 💖

okay so bestie, welcome to the picotool-config manual page, section 1 (User Commands, obviously), and it's literally just about looking at or changing your program's configuration settings — either on the target device(s) or inside a file. that's the whole vibe. 🎀

---

✨ NAME ✨

picotool-config — display or change program configuration settings from the target device(s) or file. no cap, that's it, that's the job. 💅

---

🌸 SYNOPSIS 🌸

picotool config [-s <key> <value>] [-g <group>] [device-selection]

picotool config [-s <key> <value>] [-g <group>] <filename> [-t <type>]

like, two whole moods: device mode and file mode. pick ur fighter. 🦋

---

👑 OPTIONS 👑

• <key> — this is the variable name, aka which setting you're poking at. 🫶
• <value> — the new value you want that key to hold. glow-up for ur config.
• -g <group> — filter stuff by feature group. only the groupies u asked for. 🎀

---

🔥 TARGET SELECTION 🔥

targeting device(s) 🌈

if you wanna target one or more connected RP-series device(s) sittin' in BOOTSEL mode — and yes, that's the default, main character energy fr fr — here's ur filter menu:

• --bus <bus> — filter devices by their USB bus number.
• --address <addr> — filter devices by USB device address.
• --vid <vid> — filter by vendor id. iykyk.
• --pid <pid> — filter by product id.
• --ser <ser> — filter by serial number.
• -f, --force — this one's spicy: it forces a device that is not in BOOTSEL mode, but is running compatible code, to reset so the command can actually run. and after the command executes — unless the command itself happens to be a reboot — the device gets rebooted back into application mode. it's giving "let me in, i promise i'll put it back". 😭
• -F, --force-no-reboot — same rescue mission: forces a device that's not in BOOTSEL mode but running compatible code to reset so the command can run. BUT here's the difference — after executing (again, unless the command itself is a reboot), the device is left connected and accessible to picotool, just without the USB drive mounted. no reboot home, it stays out here with us. 💀

targeting a file 📁

• <filename> — the file name. that's the whole description bestie, it's the name of the file. 🙈
• -t <type> — specify the file type explicitly — uf2 | elf | bin — and it just straight up ignores the file extension. icon-level decisiveness. ⭐

---

💜 reminder: -f and -F both reset a device that isn't in BOOTSEL mode, and both skip rebooting when the command itself is reboot. the only difference is where the device ends up after — rebooted to application mode (-f) or left connected without the USB drive mounted (-F). don't mix 'em up, queen. 👑

---

🧚 SEE ALSO 🧚

nothing here bestie, the original page doesn't list any. slay with what u got. ✨

---

and that's the tea, gorgeous. this was picotool-config, section 1 of the User Commands manual, from picotool 2.2.0-a4+dfsg, dated December 2025. go forth and configure, periodt. 💅💖🎀