Congratulations on receiving your Pikatea Macropad GB3! This quick guide will walk you through how to use it.

What’s in the Box

  • (1) Pikatea Macropad GB3
  • (1) USB Mini Cable
  • (1) Allen Wrench
  • (2) Screws
  • (2) Mounting tape


Mounting can be done with the included screws or the doubled sided tape. Remove the red plastic to reveal the adhesive part of the mounting tape. Align the Macropad to the underside of your desk or monitor and press firmly for 10 seconds. The bond will grow stronger over time. Be careful not to cover up any monitor buttons. More mounting tape can be bought on our store in sets of 4.

Note: The USB cable can act as a lever and pry the macropad off if you accidently pull the cord. We would recommend you secure the cable behind the macropad so that if the cable is pulled, it doesn't pull directly on it and cause it to fall off.

Programming and Usage

VIAL firmware is already loaded onto your macropad. VIAL is an open source program that makes it easy to configure the device with a simple interface. 


We use VIAL for a variety of Pikatea devices so please reference this guide for details on using VIAL. It is a generic guide applicable to any VIAL compatible device.


Example Uses

This is a list I've generated of useful ways and programs to use the Pikatea Macropad with. This is just an example. In reality, the possibilities are endless. Add your own use cases by editing the github page.

  • Music control - My favorite way to use the Pikatea Macropad. I usually configure 3 buttons for Play/Pause, Next, and Previous songs. The knob is used to control volume. This works well with Spotify.
  • Screenshots - Configure a macro to press LeftMenu+LeftShift+s to open up the screenshot tool on Windows 10.
  • SoundSwitch - This is an amazing computer program that makes it very easy to switch audio devices with a macro or hotkey.
  • In conjunction with AutoHotkey - AutoHotkey is a powerful scripting language that can do automated tasks. It can be triggered by a hotkey press so it's perfect to use with the Pikatea Macropad.
  • Streaming - Configure OBS or other streaming platforms to change scenes or camera angles. We like to have a button to blank the display.
  • Video Editing - Program the knob to press the correct keys to move the timeline back and forth for any video editing program.

deej Software Usage

The Pikatea Macropad works with deej. deej is an open-source hardware volume mixer for Windows and Linux PCs. It lets you use real-life sliders (or in this case, your Pikatea Macropad) to seamlessly control the volumes of different apps (such as your music player, the game you're playing, and your voice chat session) without having to stop what you're doing.

Important note: deej is a 3rd-party program. The macropad uses a rotary encoder - which isn't officially supported with deej - and as such might not interact super-intuitively with config options such as "noise_reduction"

Setting up your macropad to work with deej requires a little bit of programming. Don't be intimidated, every step is outlined and detailed to make it as easy as possible. If you have questions, ask on discord! We are happy to assist.

Follow this guide to get started with using your macropad with deej


QMK and VIA Programming

The Pikatea Macropad is compatible with QMK and VIA firmware.

Pikatea QMK Fork - Use this fork to create your own firmware powered by QMK.

A pre-built QMK VIA compatible firmware is available to download and is outlined in the (insert link here)


Sometimes the device doesn't work as expected or doesn't seem to work at all. If this is the case, we can do a replacement/repair up to 3 months after receiving your device.

Have some advice? Edit this page