Mad Noodle VIA Support

Welcome to the Mad Noodle VIA Support repository! This repository is your go-to resource for VIA firmware and definitions for all Mad Noodle keypads. Follow the instructions below to ensure your keypad is up-to-date and ready for customization through VIA.

You can also check out this really crude but effective video I threw together for setting up VIA on your Mad Noodle Keypad: VIA Setup Guide Video

Getting Started

Before you begin, make sure you have:

• A Mad Noodle keypad
• A USB cable to connect your keypad to your computer
• The latest files downloaded from this repository by clicking this link: ZIP Download

Firmware Update

Note

If you purchased your keypad in 2024 or later, it should already come with the latest VIA firmware. For older models, please update your firmware:

1. Extract and open the file downloaded from the step above.
2. Locate the 'Firmware' folder that corresponds to your specific keypad model.
3. Find the Via firmware .hex or .uf2 file associated with your keypad.
4. Install the firmware as usual, following the flashing instructions provided on The Mad Noodle Flashing Guide or our website for your keypad model.

Setting Up VIA

You can configure your keypad using the VIA application, which is available as a Web App or as a standalone desktop application.

• Web App: VIA Web App
• Desktop App: VIA Releases

Configuring Your Keypad with VIA

Once you have VIA open:

1. Go to 'Settings' and enable the "Show Design tab" option. If promted click 'Confirm'.
2. Select the 'Design' tab, indicated by a paintbrush icon.
3. Under 'Load Draft Definitions', upload your {keypad}.json file from the 'Via Definitions' folder that corresponds to your specific keypad model.

Return back to the "Configure" tab and now your keypad should now be fully functional with VIA. If you encounter any issues, try changing the 'Render Mode' to 3D in the settings menu.

Start Editing your Keymap:

1. Select the key you'd like to remap on virtual keypad. It will be highlighted red when ready to be assigned a new keycode.
2. From the selection of keycodes on the bottom portion of the Via window, select the desired keycode you would likee to assign.

Enhanced Keycodes and Features for Mad Noodle Keypads

Some Mad Noodle Keypads come equipped with specialized keycodes and features designed to enhance your experience. Below are the details of these unique functionalities:

Layer Change Indicators

When switching between layers, the keypad offers visual feedback through its RGB backlighting:

• Default Setting: The RGB backlight blinks to indicate a layer change, with distinct colors assigned to each layer:
  • Layer 0: White
  • Layer 1: Red
  • Layer 2: Green
  • Layer 3: Blue
• Alternative Option: Choose to have one of the four LEDs maintain a constant white light, correlating to the active layer.

To switch between these visual feedback options, use the keycode found in the "Custom" section labeled "RGB Layer Mode".

Keycode for Layer Cycling

With a tap on this custom keycode, you can cycle through the layers in sequence, from Layer 0 to Layer 3.

This feature is accessible in the "Custom" section under the label "Cycle Layers".

Important Reminder: For consistent performance, ensure that this custom keycode is assigned to the same key across all layers.

Troubleshooting

In case of any difficulties, please refer to our troubleshooting guide or send an email to [email protected].

Support and Contact

For further assistance, please reach out through our GitHub Issues or contact support directly at our website https://www.themadnoodle.com/.

Hope you love this new support we added for your Mad Noodle KeyPad!