Getting Started

Installation

Getting Mechvibes up and running is quick and easy. Choose your platform and follow the installation steps.

Windows

  1. Download the latest .exe installer from the download page
  2. Run the installer and follow the setup wizard
  3. Launch Mechvibes from your desktop or start menu
  4. Updates are installed automatically and SHA-256 verified

macOS (experimental)

  1. Download the .dmg file (Apple Silicon) from the download page
  2. Open the .dmg file and drag Mechvibes to Applications
  3. Right-click the app and choose Open to bypass Gatekeeper (not notarized)
  4. Grant microphone/accessibility access if prompted for input capture

Linux

  1. Download the .deb or AppImage from the download page
  2. .deb (Debian/Ubuntu): install with sudo dpkg -i mechvibes_*.deb
  3. AppImage (any distro): make it executable with chmod +x mechvibes-*.AppImage then run it
  4. Add your user to the input group so key events are captured: sudo usermod -a -G input $USER, then log out and back in

First Setup

When you first launch Mechvibes, you'll be greeted with the setup wizard that helps you configure your initial preferences.

  • Choose your preferred keyboard layout
  • Select a default sound pack
  • Configure volume and audio output device
  • Set up hotkeys for quick access (Ctrl+Alt+M to mute)

Basic Configuration

Customize Mechvibes to match your workflow with these essential settings.

💡

Pro Tip

Start with a low volume setting and gradually increase it to find your comfortable level.