Keychron V5 Max QMK/VIA Setup: Wireless Custom Guide

Quick answer

Charge the V5 Max first, then pair it over Bluetooth by holding Fn+1 for about three seconds until the key flashes, and select the keyboard in your OS Bluetooth menu. For key remapping, connect the included cable and open the VIA web app or Keychron Launcher, authorize the device, and edit your layout. Do firmware updates last, with the cable connected and the keyboard awake.

Before you start: what to have ready

You need the V5 Max, its USB-C cable, and a computer with Bluetooth if you plan to use wireless mode. The V5 Max supports both Bluetooth and 2.4 GHz, and the fully assembled version ships with Gateron Jupiter switches and OSA PBT keycaps, so you can type immediately without installing anything. The barebone version does not include keycaps or switches, so plan to add your own before setup.

Decide your primary connection now. Bluetooth is best for switching between a laptop and tablet; 2.4 GHz is better for low-latency gaming or a desktop with a USB-A port. VIA remapping works over a wired connection, so keep the cable nearby even if you plan to go wireless afterward.

Charge and power on without surprises

Plug the V5 Max into a USB port using the included cable and let it charge while you work. A partially charged board can drop a Bluetooth pairing mid-session, which looks like a keyboard fault but is usually just low power. The power switch on the back has cable, Bluetooth, and 2.4 GHz positions; for first-time setup, leave it in cable mode so the computer sees a stable wired device.

Turn the board on and test a few keystrokes in a text editor. If nothing registers, check the cable and the power switch before assuming a defect. Once you see characters, you know the PCB, switches, and connection are all working.

Pair over Bluetooth and label your channels

Move the power switch to Bluetooth. Hold Fn+1 for roughly three seconds until the 1 key flashes quickly, then open your computer's Bluetooth settings and select the Keychron V5 Max entry. Repeat with Fn+2 and Fn+3 for additional devices. Each channel remembers its own host, so you can keep a laptop on 1, a desktop on 2, and a tablet on 3.

A common mistake is holding the key too briefly. If the key stops flashing and no device appears, hold Fn+1 again for the full three seconds and watch for the fast blink before searching. If your computer lists the keyboard but typing does nothing, remove the old pairing entry and pair again rather than toggling Bluetooth repeatedly.

Set up 2.4 GHz if you want lower latency

Plug the 2.4 GHz receiver into a USB port, then move the power switch to the 2.4 GHz position. The connection is usually automatic, but if it is not, hold Fn+4 to enter pairing mode. Keep the receiver on a direct port rather than a hub if you notice dropped keystrokes, because hubs and metal desk surfaces can weaken the signal.

Use 2.4 GHz for gaming or for a desktop that stays in one place. Use Bluetooth when you need to hop between machines. You do not have to choose permanently; the switch on the back changes modes without re-pairing.

Remap keys with VIA or Keychron Launcher

Connect the V5 Max with the cable and switch to cable mode. Open the VIA web app in a Chromium-based browser, click Authorize, and select the V5 Max when it appears. If VIA does not list the board, use Keychron Launcher instead; it is Keychron's own web configurator and accepts the same QMK-based layout. Both tools write changes directly to the keyboard, so you can unplug and keep your remaps.

Start with one or two changes rather than rebuilding the whole layout in one sitting. Remap a key, test it, then move on. If a key stops working, use the reset option in the configurator to return that layer to default rather than flashing firmware.

Update firmware only when you have a reason

Firmware updates fix bugs and add features, but they are the riskiest step in any QMK/VIA wireless keyboard setup. Update only if you are missing a feature you need or Keychron publishes a fix for a problem you have. Before flashing, connect the cable, confirm the keyboard is awake, close other apps that might grab the USB device, and download the correct file for the V5 Max from Keychron's support page.

Never flash over Bluetooth or 2.4 GHz. If the update tool cannot see the keyboard, try a different USB port or cable before retrying. After flashing, the board may reset to defaults, so re-check your VIA layout and re-pair Bluetooth channels if needed.

Setup steps with checkpoints

1. Charge the keyboard: Connect the USB-C cable and let the V5 Max charge before pairing. A low battery can drop a Bluetooth connection mid-setup and mimic a hardware fault. Checkpoint: the keyboard types reliably over the cable before you switch modes.
2. Pair Bluetooth on channel 1: Move the switch to Bluetooth, hold Fn+1 for about three seconds until the key flashes fast, then select the V5 Max in your OS Bluetooth menu. Mistake to avoid: releasing Fn+1 too early, which leaves the board in pairing mode but invisible to the computer.
3. Add 2.4 GHz only if you need it: Plug in the 2.4 GHz receiver and move the switch to the 2.4 GHz position, or hold Fn+4 to pair if it does not connect automatically. Checkpoint: use a direct USB port, not a hub, if keystrokes drop.
4. Remap in VIA or Keychron Launcher: Connect the cable, open the VIA web app or Keychron Launcher, authorize the device, and change one key at a time. Test each change before moving on. Mistake to avoid: rebuilding the whole layout at once, which makes it hard to tell which remap broke a key.
5. Update firmware last, over cable only: Download the correct V5 Max firmware from Keychron, connect the cable, confirm the keyboard is awake, and flash. Never flash over Bluetooth or 2.4 GHz. After flashing, re-check your VIA layout and re-pair Bluetooth channels, because the board may reset to defaults.

Product facts that affect setup

• Keychron V5 Max QMK/VIA Wireless Custom Mechanical Keyboard: The fully assembled V5 Max includes the PCB, screw-in stabilizers, PC plate, double-shot OSA PBT keycaps with Mac and Windows keycaps, and Gateron Jupiter switches. The barebone version does not include keycaps or switches. If you buy the barebone version, you must install switches and keycaps before any pairing or remapping step will work. The assembled version is ready to set up out of the box.
• Keychron K10 Pro QMK/VIA Wireless Mechanical Keyboard ISO Layout Collection: The K10 Pro ISO Layout Collection supports QMK/VIA through the Keychron Launcher web app, includes UK, German, Swiss, Nordic, French, and Spanish ISO layouts, and offers hot-swap support for MX mechanical switches. If you need an ISO layout instead of the V5 Max's ANSI layout, the K10 Pro is the relevant alternative and uses the same Launcher-based remapping workflow.