Skip to content

Add FlipDeck - USB HID Macro Pad#968

Open
ismail-oe wants to merge 1 commit intoflipperdevices:mainfrom
ismail-oe:ismail-oe/flipdeck
Open

Add FlipDeck - USB HID Macro Pad#968
ismail-oe wants to merge 1 commit intoflipperdevices:mainfrom
ismail-oe:ismail-oe/flipdeck

Conversation

@ismail-oe
Copy link
Copy Markdown

@ismail-oe ismail-oe commented Feb 26, 2026

Application Submission

FlipDeck turns your Flipper Zero into a USB HID macro pad with a 2×3 button grid.

Features:

  • Multi-page support (up to 8 pages × 6 buttons) with named page headers and dot indicators
  • Native media keys: Play/Pause, Next, Previous, Volume Up/Down, Mute, Brightness — work instantly on any OS without drivers or host software
  • Custom F-keys (F13–F24) for triggering host-side actions via optional companion daemon
  • Page navigation: left/right at grid edge switches pages, short Back = previous page, long Back = exit
  • Haptic and visual feedback on button press
  • Configurable button layout via SD card config file (/ext/apps_data/flipdeck/config.txt)
  • Optional cross-platform host companion (macOS + Linux) with web UI, plugin system, and background service

Extra Requirements

For media keys (Play, Volume, Mute, etc.): No extra hardware or software required. Works out of the box via USB.

For custom F-key actions (optional): Requires the FlipDeck Host companion installed on the computer:

  • Python 3.9+
  • macOS: Accessibility permission for Terminal/Python
  • Linux: xdotool for keypress simulation

Host companion installation: cd host && pip install -e .

Author Checklist (Fill this out)

  • I've read the contribution guidelines and my PR follows them
  • I own the code I'm submitting or have code owner's permission to submit it
  • I have validated the manifest file(s) with python3 tools/bundle.py --nolint applications/USB/flipdeck/manifest.yml bundle.zip

Reviewer Checklist (Don't fill this out)

  • Bundle is valid
  • There are no obvious issues with the source code
  • I've ran this application and verified its functionality

Copy link
Copy Markdown
Collaborator

@xMasterX xMasterX left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello, your manifest file is invalid
App seems to be located not in repo's root, but in flipper folder
So you need to add subdir: flipper after commit_sha field in manifest

@xMasterX xMasterX added app (new) fixes needed Unresolved issues with the app requiring maintainer's attention labels Mar 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

app (new) fixes needed Unresolved issues with the app requiring maintainer's attention

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants