FlipBoard Keyboard¶

Description¶

FlipKeyboard¶

Overview¶

The FlipKeyboard application turns your Flipper Zero and FlipBoard into a MacroPad Keyboard. It also becomes a musical light-up keyboard that you can use to play songs. It supports both USB and BLE connections. Automate repetitive typing tasks with the press a button on the FlipBoard!

You can order your FlipBoard from @MakeItHackin using tindie or Etsy. Be sure to also join our Discord server.

Running the app¶

Make sure your FlipBoard is connected to your Flipper Zero. When you start the app, you should see startup splash screen for a few seconds reminding you to connect the FlipBoard and then the FlipBoard LEDs will do their start-up sequence. - Start application : enables MacroPad (USB/BLE keyboard) and music. - Configuration application : change what notes are played and what messages are typed. - About : version and ordering information. - Instructions QR code : links to GitHub for detailed instructions (including customizing app).

Configuration¶

Go to 'Configure application' in the app menu to setup how each action works. You’ll see all of the different button combos listed (for example "Action 3" is pressing button 1 and button 2 at the same time). Press 'Ok' to select the Action to configure.

• The 'Press color' option changes the button color when it’s pressed. If you pick a combo button, all the buttons in that combo will change color.

• The 'Release color' option changes the button color when it’s not pressed. This option doesn’t work for combo buttons.

• The 'Music note' option changes the sound to play when the button is pressed. You can pick 'Off' if you don’t want any sound.

• The 'Keystroke' option adds a key to press when the button is pressed. You can pick 'None' if you don’t want any key to be pressed. There is also options 'Msg1', 'Msg2', 'Msg3', 'Msg4' which will type the message you have set in the "Message 1-4" option. The option 'Delay' will pause for 100ms. The keys 'Ctrl', 'Shift', 'Alt' and 'Gui' are modifiers that will stay pressed until the next key. If you press 'Ok' on the Keystroke, you will get a custom keyboard to pick the key. You can press 'Back' on the Flipper Zero if you decide to not change the key.

  NOTE: For this application, not all keys are on the on-screen keyboard; you may need to use the Flipper Zero's 'Left' and 'Right' buttons on the "Keystroke" option to access some keys options.

  NOTE: You can remove a Keystroke by selecting 'None' as the key. Currently this change only takes effect after you quit the application and restart it. In a future version, this will take effect when you go to the application main menu.

• The 'Count' is how many times to press the key (or repeat the delay).

• The "Message 1-4" option changes the text to send (NOTE: you should also use "Add Keystroke" and choose 'Msg1'-'Msg4' to send the message). If you want to erase a message, replace the message with a Space then press save.

Using the app¶

Make sure your FlipBoard is connected to your Flipper Zero. Make sure the qFlipper application is NOT running. Choose the 'Start application' option to launch the app. Press the buttons to see the LEDs change color & hear the tones get played. If your computer is connected to your Flipper Zero via USB, you should see keystrokes and Messages get entered on the computer. If you computer is NOT connected to your Flipper Zero via USB, then BLE will be used to send the keystrokes and Messages to the computer.

BLE support¶

You must first enable BLE on your Flipper Zero, make sure no applications are running on the Flipper Zero. Then go to 'Settings', 'Bluetooth' and select 'On'. You can also choose "Unpair All Devices" from this menu.

The FlipKeyboard application supports BLE (Bluetooth Low Energy) connections. This option will be selected when you choose 'Start application' and don't have a USB cable connected.

To pair a BLE device, run the 'FlipKeyboard' application on the Flipper Zero. Make sure the USB cable is NOT plugged in, then choose 'Start application'. On your device (phone, computer, etc.) choose Bluetooth pairing. The device should show up as 'BadUSB {flipper name}'. On your Flipper confirm the pairing code is correct and click 'Ok', then click confirm on your device. The device should now be paired.

Support¶

If you have need help, we are here for you. Also, we would love your feedback on cool ideas for future FlipBoard applications!

Please visit my Flipper Zero Discord server Flipper Zero Tutorials (Unofficial) and ask your questions in the #flipboard or #general channel.

Changelog¶

3.9¶

• Fix hanging issue on new FW. (Free popup on exit)

3.8¶

• Some keys not rendering in Keystroke selector.

3.7¶

• Fix issue were invalid memory was getting freed.

3.6¶

• Show "BLE" or "USB".

3.5¶

• Show FlipKeyboard title when app is running.

3.4¶

• Don't send MSG1-4 if Keystroke is set to any key.

3.3¶

• Add support for BLE.

2.6¶

• Default configuration on first load.

2.5¶

• Splash screen.

2.4¶

• Improved LED driver.

2.3¶

• Add additional keystroke buttons.