A Flipper Zero app that keeps your computer awake, with a rubber debugging duck in charge.
Website · Install · User guide · All docs
Harold lives on your desk. When you step away, he moves the mouse pointer so Teams, the screen saver and the lock timer still see someone there, and he puts it back where it was. Over USB or Bluetooth, no drivers, nothing to install on the computer. The same Flipper is a media, slides and mouse remote.
Note
v0.1 is nearly ready. It works on official firmware 1.5.1 with Windows 11, over USB and Bluetooth. Until it is in the Flipper Apps Catalog, build it from source (below). Progress: v0.1 milestone.
- Three ways to stay awake. Walk takes a short, curved, random walk every few minutes. Subtle moves one pixel out and back, invisible while you work. Wander drifts the pointer around without stopping and glides it back to where it started when you turn it off. See them move.
- Never the same path twice, so it does not look like a jiggler.
- USB or Bluetooth. Plug it in, or pair it and keep it in your pocket. A connection check shows whether the Flipper or the computer needs attention.
- Stops when you want it to. Work hours only (Mon–Fri 8–18), and Stop after puts Harold to sleep when nobody has been around for 1 to 8 hours, so a PC you walked away from still locks.
- Lets go while you work. With the optional desktop app for Windows, macOS and Linux, Harold pauses the moment you touch your own mouse or keyboard, over USB or Bluetooth. It lives in the tray and starts at login.
- A remote too. Play, pause, volume and tracks; next and previous slide; a D-pad mouse.
- Harold is good company. He reads code, types, sips coffee, hunts bugs and quacks at them.
Once v0.1 is out: open the Flipper mobile app or Flipper Lab, go to USB, and install Duckwalk. It needs the official firmware, 1.5 or newer.
Until then, build it from source
You need Python 3.8+ and a Flipper on the official firmware.
python -m pip install --upgrade ufbt
git clone https://github.com/arudaev/duckwalk.git
cd duckwalk/app
ufbt launch # builds it and starts it on a connected Flipper (close qFlipper first)On the first launch Harold asks how to reach the computer: Left for USB, Right for Bluetooth. Bluetooth walks you through pairing on the Flipper's screen.
| Button | On the Flipper |
|---|---|
| OK | Wake Harold (keep-awake on) or put him to sleep. Hold to quack |
| Right | Settings: mode, USB or Bluetooth, how often, how far, Resume after, work hours, Stop after, Baby lock, sound and vibration |
| Left | Remote: media, slides or mouse |
| Up | Preview: the next walk drawn to scale; OK plays it now |
| Down | Connection check: a checklist that shows whether the Flipper or the computer needs attention |
| Back | Leave Duckwalk; USB and Bluetooth go back to normal. With Baby lock on: tap twice, or hold for 2 seconds |
The opposite button brings you back: Down from Preview, Up from the connection check, Right from the Remote's menu.
The Flipper app needs nothing installed on the computer: it shows up as a normal USB or Bluetooth mouse, so it works with any computer that takes one. So far it has been tested on Windows 11.
For a whole day away, set Stop after to Never. The user guide shows every screen.
Most Flipper apps that talk to a computer turn the USB port into a single device, so a jiggler and a PC monitor cannot run at once. Over USB, Duckwalk is one device with three parts: a mouse, media keys and a small data channel, all standard USB HID (USB device has the descriptor and IDs). Over Bluetooth it pairs like any Bluetooth mouse, using the firmware's HID profile plus one small data service of Duckwalk's own, and the USB port stays free for charging and qFlipper.
The lock timer and "away" status follow the computer's idle timer, and any mouse input resets it. The desktop app asks the system which device each input came from (Raw Input on Windows, IOHIDManager on macOS, evdev on Linux) to tell your own devices from Duckwalk's and sends one number over the data channel, on USB or Bluetooth: how long you have been idle. The architecture page has the diagrams.
Caution
A keep-awake tool can be against your employer's rules. Duckwalk makes your computer look attended; whether that is acceptable where you work is your decision. It only moves the pointer. It never types, and it clicks or presses media keys only when you use the remote.
- User guide: every screen, Settings, the remote, pairing
- Desktop app: the optional tray app for Windows, macOS and Linux, with an MCP server and an agent skill for coding agents. In Claude Code:
/plugin install duckwalk --marketplace arudaev/duckwalk - All docs, including the architecture and developer guide
- Found a bug or tried it on macOS or Linux? Open an issue.
Testing on other computers, bug reports and art are all welcome. Start with CONTRIBUTING.md; the project board shows what is being worked on.
- Harold is the duck from VOYAGER // 56K, a small sailing game by the same author.
- The USB interface follows the structure of the Flipper Zero firmware's own HID driver (flipperdevices/flipperzero-firmware, GPL-3.0).
- The Flipper drawing in the animation and on the website is adapted from qFlipper (GPL-3.0). Flipper Zero is a trademark of Flipper Devices Inc.; Duckwalk is not affiliated with them.

