To map your keyboard matrix, please:
Before configuring your keyboard with Pog, CircuitPython needs to be installed on your board.
Once CircuitPython is installed, your board will appear as a CIRCUITPY drive.
Select your CIRCUITPY drive:
{{ drive.name }}
{{ drive.path }}
No CIRCUITPY drives found.
1. Install the debug code on the keyboard
2. Click the text area and follow the guide below
3. Now press each key starting in the top left corner in the first row and moving to the right when you reached the end press the last key once again to start with the next row
If nothing is happening first replug the board in case it hasnt started and wait 5 seconds. If this did not help check the diode direction or pins.
the coordmap should be printed as a list of 3 digit numbers seperated by spaces.
eg 001 005 008 002 ...
it will print this via a hotkey on the number row so make sure to switch to something like
qwerty if you are using azerty or another layout that maps other keys to the number row. for
split keyboards try the coordmap with the type set to normal as depending on the split side
detection the secondary half might not output to usb.
{{ coordmapstring }}
note if your key indexes changed you need to rebuild your layout or adjust the indexes on the on the layout editor, only saving the coord map is only advisable if you wanted to modify spacings but not the order of the keys
Layer {{ lindex }}
Encoder {{ eindex }}
Prefix: {{ keyboardStore.pinPrefix }} - {{ pinPrefixHint }}
No keys selected
Key #{{ [...selectedKeys][0] }} {{ selectedKeys.size }} keys selected
Basics
Matrix
Key Index (from CoordMap)
Encoder Index
you can build way more advanced things with custom keys here are some resources, for some you might need to edit the kb.py file or enable a keyboard feature. when testing these check the output of the REPL for errors
Name
Manufacturer (optional)
Description (optional)
Tags (optional)
Keyboard Features
Keycode Options for Selected Key(s) {{ coordMapWarning }}
To add your own custom keycodes, edit the file `customkeys.py` to add your own and then use them with `customkeys.MyKey` in your keymap
Updating the POG files will overwrite all files on your keyboard generated by POG (e.g. kb.py, code.py, customkeys.py, etc.)
Be sure to backup your code if you still need any of it.
Do you want to generate new ID for the restored configuration? This is only recommended if you are restoring a configuration from another keyboard.
KMK is a capable firmware for keyboards using the Rp2040.
Before you proceed make sure you installed CircuitPython on your controller
Info: This does not work when the controller is only connected via the serial port (and not as mounted usb drive)
By clicking the button below, you can install KMK automatically to the following drive: {{ keyboardStore.path }}
{{ kmkInstallState || '' }}
{{ isNaN(progress) ? 'Done' : progress }}%you can import json files from the keyboard layout editor
set the top left label to the matrix position eg '0,1' for row:0 col:1
set the bottom right label for a layout variant
eg. '0,1' this would be the first layout option using its other variant
Define the size of your keyboard matrix here, set it as big as you need. For easier wiring set it to the max number of cols/rows on your keyboard
Keyboard Type
Wiring Method
Define the mapping for columns and rows to the microcontroller pins. For split keyboards define the method for detecting the split side.
Row Pins {{ keyboardStore.rowPins.length }}
{{ index }}
Column Pins {{ keyboardStore.colPins.length }}
Direct Pins {{ keyboardStore.directPins.length }}
{{ index }}
Split Pins {{ numberOfSplitPins }}
{{ vbusPinHint }}
{{ splitPinHint }}
Pin Prefix
{{ pinPrefixHint }}
Diode Direction
Split Side Detection
{{ splitSideHint }}
Microcontroller
Feel free to submit other microcontroller pinouts. Ensure you have the permission to use the pinout image if it has not been created by you. In the meantime here are links to other pinouts
Currently this tool works with any RP2040 controller.
Just look for a pinout and use any pin that is starting with GP.
Keymap
Info: To enable RGB you also will need a neopixel.mpy file in the lib folder on your CircuitPython drive eg. adafruit-circuitpython-neopixel-py-6.3.11.zip as neopixel.py . You can download that here: Adafruit GitHub
{{ kmkInstallState !== 'done' ? 'Installing firmware... (should take up to 10 seconds)' : 'Firmware installed' }}
initial Firmware install complete, please unplug your keyboard and plug it back in to continue
Select the serial port for your keyboard. We've automatically detected the most likely port.
{{ port.port }}
{{ port.manufacturer || 'Unknown manufacturer' }} {{ port.serialNumber ? `(${port.serialNumber})` : '' }}
No serial ports found.
Configure your keyboard manually by specifying the pins, rows, columns, and diode direction. Recommended for experienced users or if you have your keyboard's documentation.
Let Pog automatically detect your keyboard's configuration by pressing each key. We'll flash a special firmware and guide you through the process.
Before you start please check that your controller is using circuit python, if not please download the matching firmware and drag it on the usb drive that appears when you enter its bootloader mode
when you see the circuit python usb drive it is a good time to rename the drive to reflect your keyboard name
With this done please select the drive so POG can start to flash the firmware, you will be able to configure everything after the flashing is done
now unplug the keyboard and plug it back in to boot up the pog code
loadinginfo prepare controller with circuit python
plugin controller and select the usb drive
flash kmk on drive + add pog files and an id in the pog.json
unplug and replug keyboard to boot pog
listen for serial ports with pog manufacturer then grab its info and compare with created id
open both connections to repl and data for debugging
name + matrix size + pins[rows,cols,directpins,rgb,encoders] (loadable from qr or link)
coordmap press each key
use generated layout or modify (or was loaded from link/qr)
String
' } else { keylabel.action = 'Macro
' } } else if (keycode.startsWith('customkeys.')) { keylabel.action = 'custom' keylabel.simple = false const customcode = keycode.substring(11) keylabel.main = `${customcode}` } else { // Check for modifier keys // if (keycode.includes('KC.LSHIFT') || keycode.includes('KC.RSHIFT') || // keycode.includes('KC.LCTL') || keycode.includes('KC.RCTL') || // keycode.includes('KC.LALT') || keycode.includes('KC.RALT')) { // label += '^ '; // } // Check for key presses const keyMatch = keycode.match(/KC\.(\w+)/) if (keyMatch) { const key = keyMatch[1] const foundKey = keyLabels[key] if (!foundKey) { keylabel.action = keycode } else if (foundKey.icon) { keylabel.action = `` } else if (foundKey.label) { keylabel.action += foundKey.label } // if it has arguments render them as keycode as well if (keycode.includes('(')) { const match = keycode.match(/^[^(]+\((.*)\)$/) // dont render options for some keys eg. MT if (match && match[1]) { const params = match[1].split(',').map((a) => renderLabel(a)) let maxParams = 10 if (['LT', 'MT'].includes(key)) { // keycodes that have a label at the top maxParams = 2 } switch (key) { case 'LT': keylabel.main = String(params[1].action) keylabel.lower = params[0].action keylabel.layer = Number(params[0].action) keylabel.simple = false keylabel.layerNamePosition = 'lower' break case 'OS': keylabel.main = String(params[0].action) keylabel.simple = false break case 'TD': keylabel.main = String(params.map((a) => a.action).join(' ')) keylabel.simple = false break case 'MT': keylabel.main = String(params[0].action) keylabel.lower = String(params[1].action) keylabel.simple = false break case 'HT': keylabel.main = String(params[0].action) keylabel.lower = String(params[1].action) keylabel.simple = false break case 'TT': keylabel.main = String(params[0].action) keylabel.layer = Number(params[0].action) keylabel.simple = false break case 'TO': keylabel.main = String(params[0].action) keylabel.layer = Number(params[0].action) keylabel.simple = false break case 'TG': keylabel.main = String(params[0].action) keylabel.layer = Number(params[0].action) keylabel.simple = false break case 'MO': keylabel.main = String(params[0].action) keylabel.layer = Number(params[0].action) keylabel.simple = false keylabel.layerNamePosition = 'main' break } keylabel.params = params.slice(0, maxParams) } } } else { // custom keycodes keylabel.action = keycode } } return keylabel } const controllers = { '0xcb_helios': ['GP29'] } export const microcontrollerPinValid = ({ controller, pin }: { controller: string pin: string }) => { // check if the controller has this pin return controllers[controller].includes(pin) } ================================================ FILE: src/renderer/src/helpers/saveConfigurationWrapper.ts ================================================ import { ref } from 'vue' // Global loading state const isLoading = ref(false) const loadingCallbacks = new Set<(loading: boolean) => void>() // Subscribe to loading state changes export const onLoadingChange = (callback: (loading: boolean) => void) => { const unwatch = () => { loadingCallbacks.delete(callback) } loadingCallbacks.add(callback) return unwatch } // Get current loading state export const getLoadingState = () => isLoading.value // Set loading state and notify all callbacks const setLoading = (loading: boolean) => { isLoading.value = loading loadingCallbacks.forEach((callback) => callback(loading)) } // Wrapper for saveConfiguration that automatically handles loading overlay export const saveConfigurationWithLoading = async (data: string) => { if (isLoading.value) { console.warn('Save operation already in progress, ignoring duplicate call') return } try { setLoading(true) await window.api.saveConfiguration(data) } catch (error) { console.error('Error in saveConfigurationWithLoading:', error) throw error } finally { // Don't set loading to false here - let the LoadingOverlay handle it // based on the progress events from the main process } } // Function to manually hide loading (for fallback timeouts) export const hideLoading = () => { setLoading(false) } ================================================ FILE: src/renderer/src/helpers/types.d.ts ================================================ ================================================ FILE: src/renderer/src/main.ts ================================================ import { createApp } from 'vue' import App from './App.vue' import router from './router' import '@mdi/font/css/materialdesignicons.css' import './style/index.css' // import '@vueform/multiselect/themes/default.css' import './style/multiselect.css' const app = createApp(App) app.use(router) app.mount('#app') ================================================ FILE: src/renderer/src/router/index.ts ================================================ import { createRouter, createWebHashHistory } from 'vue-router' import LaunchScreen from '../screens/LaunchScreen.vue' import AddKeyboard from '../screens/AddKeyboard.vue' import KeyboardConfigurator from '../screens/KeyboardConfigurator.vue' import KmkInstaller from '../components/KmkInstaller.vue' import SetupWizard from '../screens/SetupWizard.vue' import LayoutEditor from '../components/LayoutEditor.vue' import KeymapEditor from '../components/KeymapEditor.vue' import EncoderSetup from '../components/EncoderSetup.vue' import MatrixSetup from '../components/MatrixSetup.vue' import PinSetup from '../components/PinSetup.vue' import RawKeymapEditor from '../components/RawKeymapEditor.vue' import KeyboardName from '../components/KeyboardName.vue' import CoordMap from '../components/CoordMap.vue' import RgbSetup from '../components/RgbSetup.vue' import Community from '../components/Community.vue' // import Debug from '../components/debug.vue' import KeyboardSelector from '../screens/KeyboardSelector.vue' import CircuitPythonSetup from '../components/CircuitPythonSetup.vue' import SetupMethodSelector from '../components/SetupMethodSelector.vue' import AutomaticSetup from '../components/AutomaticSetup.vue' // import KeyboardSetup from '../screens/KeyboardSetup.vue' import InstallPogFirmware from '../components/installPogFirmware.vue' const routes = [ { path: '/', name: 'Launch', component: LaunchScreen }, { path: '/add-keyboard', name: 'Add Keyboard', component: AddKeyboard }, { // manual setup path: '/setup-wizard', name: 'Setup Wizard', component: SetupWizard }, { path: '/keyboard-selector', name: 'Keyboard Selector', component: KeyboardSelector }, { path: '/automatic-setup', name: 'Automatic Setup', children: [ { path: 'circuit-python', name: 'CircuitPython Setup', component: CircuitPythonSetup }, { path: 'method', name: 'Setup Method', component: SetupMethodSelector }, { path: 'mapping', name: 'Automatic Setup', component: AutomaticSetup }, { path: 'firmware', name: 'Pog Firmware', component: InstallPogFirmware } ] }, { path: '/configurator', name: 'Configurator', component: KeyboardConfigurator, children: [ { path: 'keymap', name: 'Keymap', component: KeymapEditor }, { path: 'layout-editor', name: 'Layout Editor', component: LayoutEditor }, { path: 'encoder', name: 'Encoder', component: EncoderSetup }, { path: 'info', name: 'Info', component: KeyboardName }, { path: 'matrix', name: 'Matrix', component: MatrixSetup }, { path: 'pins', name: 'Pins', component: PinSetup }, { path: 'coordmap', name: 'CoordMap', component: CoordMap }, { path: 'raw-keymap', name: 'Raw Keymap', component: RawKeymapEditor }, { path: 'firmware', name: 'Firmware', component: KmkInstaller }, { path: 'coordmap', component: CoordMap, name: 'CoordMap' }, { path: 'community', component: Community, name: 'Community' }, { path: 'rgb', name: 'RGB', component: RgbSetup } ] } ] export const router = createRouter({ history: createWebHashHistory(), routes }) export default router ================================================ FILE: src/renderer/src/screens/AddKeyboard.vue ================================================Create a Custom Keyboard firmware from scratch or choose a Keyboard from the community
{{ keyboard.path }}
Easy Keyboard Configurator
Effortlessly customize your keyboard with Pog
Serial BETA
Serial available USB Drive Mounted USB Drive Disconnected
Read Only Serial
{{ keyboard.name }}
{{ keyboard.manufacturer }}
{{ keyboard.path }}
{{ keyboard.description }}