ViaMia 🤌🏻

Easily use your own keyboards in VIA for QMK.

ViaMia is patcher and alternative keyboards database for VIA. It allows you to override the official VIA database with our open source one that actually adds new keyboards.

Just get me started

Why create ViaMia?

In the custom mechanical keyboard community QMK is king. VIA is an elegant realtime configurator for QMK allowing you to change your keyboard's behavior on the fly. However, VIA has a few flaws:

  1. The app is closed source
  2. The keyboard repository has no license (meaning it is copyrighted by many people)
  3. Getting keyboards merged into the repository takes ages
  4. It restricts itself to keyboards in the official QMK repository
  5. If your keyboard is not in the VIA database, you have to manually load your config every time you use VIA

ViaMia aims to solve all these problems in an open source friendly way. At the core is the ViaMia Patcher that changes the database used by VIA to an unofficial one. We host our own database in the ViaMia keyboards repository.

ViaMia Patcher 🩹

Our patcher for VIA changes the data source used by VIA to any other URL. The only requirement is that this URL hosts a keyboards.v2.json file compatible with the official VIA one.

The patcher qualifies as an unofficial patchwiki to closed source software, meaning it is fully legal. We do not redistribute VIA binaries.

ViaMia Keyboards ⌨️

Our keyboards repository holds a database of additional keyboards that work with VIA but are not in the official VIA database. When you've patched your VIA installation with our keyboard database, you, or anyone with the same keyboard, will no longer need to load the config JSON manually every time VIA is opened.

The repository automatically checks if your VID/PID combination is unique. If that is the case, a maintainer will likely merge your keymap within hours. We hope to have an online VID/PID checker soon so you can avoid conflicts in the first place.

Learn how to add your keyboard to ViaMia Keyboards.

Note: VIA requires unique VID/PID combinations. We may require you to change your VID/PID in your QMK keymap to avoid conflicts.

Start using ViaMia