VibeKeys User Guide

Getting Started

Unbox, connect, and start using your VibeKeys in minutes

1

Unbox Your VibeKeys

Remove your VibeKeys from the packaging. You'll find the keypad, a USB-C cable, and a quick start card. The device comes with clicky mechanical switches pre-installed.

💡 Tip: Keep the packaging for safe storage or transport if needed.

📦

Unboxing Video

What's in the box

2

Connect via USB-C

Plug the USB-C cable into your VibeKeys and connect it to your computer. The device is plug-and-play - no drivers needed for basic functionality. Your system will recognize it as a USB keyboard.

🍎 macOS Users: VibeKeys Pro uses a non-standard keyboard layout, so macOS may not recognize it automatically. This is normal. When prompted, press any key, then select "Other" or "Unrecognized Keyboard" to finish setup.

Demo

3

Start Coding

You're ready to go! VibeKeys comes with 6 pre-programmed keys arranged in two rows, plus a rotary knob on the right. Here's what each key does:

Voice

Toggle voice input

Usage

Show statistics

ESC

Reject / Cancel

Rotary Knob

Scroll up/down
Click to confirm

YOLO

Accept instantly

Retry

Regenerate

Accept

Accept suggestion

💡 Tip: All keys can be remapped using the VibeKeys Configurator to match your workflow.

macOS Setup Guide

Special instructions for macOS users to configure VibeKeys properly

1

Connect Your VibeKeys

Connect your VibeKeys to your Mac using the provided USB-C cable. macOS will detect the device and asking you to identify the keyboard.

Connecting VibeKeys to Mac

2

Press Any Key When Prompted

Press any key on your VibeKeys device to activate the keyboard identification. It's normal that macOS displays the keyboard setup assistant with the message "The keyboard cannot be identified" or similar.

💡 Tip: Press one of the main keys (not the knob) to ensure proper detection.

Press any key on VibeKeys

3

Select Keyboard Type

In the keyboard setup assistant, you'll see options to select your keyboard type. Simply choose any type from the list and click Done. That's it!

Selecting the correct keyboard type

Voice Input

Set up and use voice dictation for hands-free coding

1

Choose Voice Dictation Software

VibeKeys works with popular voice typing applications. Choose Typeless or WisprFlow depending on your preference. Install your preferred software before continuing.

💡 Tip: Both Typeless and WisprFlow work excellently with AI coding assistants.

🎤

Voice Software Selection Video

Compatible voice dictation tools

2

Configure Your Voice Software

Important: Configure your voice dictation software to use the Option key (macOS) or ALT key (Windows) as the toggle shortcut. This is required for VibeKeys Voice key to work properly.

⚠️ Critical: The Voice key on VibeKeys sends the Option/ALT key signal. Your voice software MUST be configured to recognize this key as the toggle trigger.

Option A: Typeless

Open Typeless Settings → Keyboard Shortcuts → Set toggle to Option/ALT key

Configuring Typeless

Option B: WisprFlow

Open WisprFlow Preferences → Shortcuts → Set toggle to Option/ALT key

Configuring WisprFlow

3

Start Dictating

Press the Voice key to activate dictation, then speak your commands, instructions, or code. Press it again when done. Works great with AI coding assistants for natural language instructions.

💡 Tip: Speak clearly and use technical terms at a normal pace for best accuracy.

Customization

Personalize your key mappings and knob behavior

1

Download and Open VibeKeys Configurator

First, download the VibeKeys Configurator for your operating system (Windows or macOS). Once downloaded, launch the app and it will detect your connected VibeKeys device automatically.

⚠️ Note: Make sure VibeKeys is connected via USB-C before opening the configurator.

🖥️

Configurator Launch Video

Opening the configurator app

2

Remap Your Keys

Click on any key in the configurator to assign a new function. Choose from keyboard shortcuts, media controls, or custom macros. Create profiles for different workflows.

💡 Tip: Save multiple profiles for different AI tools or coding environments.

🎹

Key Remapping Video

Customizing key mappings

3

Configure the Rotary Knob

Customize knob rotation (scroll up/down) and click behavior. Set different actions for clockwise vs counter-clockwise rotation. The knob is perfect for scrolling through code or AI suggestions.

💡 Tip: Map knob click to "Enter" or "Confirm" for quick selections.

🎚️

Knob Configuration Video

Setting up the rotary knob