Skip to content
arudaevPublic

About

Harold, a rubber debugging duck, keeps your computer awake and works as its remote – from a Flipper Zero.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Duckwalk: a pen drawing of Harold, a yellow rubber duck, nudging a mouse pointer along a dotted path from a Flipper Zero to a laptop

Duckwalk

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.

Duckwalk on a Flipper Zero: Harold at his desk types, sips coffee, hops, finds a bug and quacks at it, fixes it, walks the pointer and falls asleep

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.

Why Duckwalk

  • 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.

Install

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.

Use

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.

How it works

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.

Before you use it at work

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.

Docs and help

Contributing

Testing on other computers, bug reports and art are all welcome. Start with CONTRIBUTING.md; the project board shows what is being worked on.

Credits

  • 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.

Licence

GNU General Public License v3.0.

About

Harold, a rubber debugging duck, keeps your computer awake and works as its remote – from a Flipper Zero.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages