ChaqKey

🇬🇧 English | 🇪🇸 Español abajo

ChaqKey is a lightweight mechanical keyboard sound simulator for Windows.
It runs quietly from the system tray and plays a sound every time you press a key, providing a simple, minimal, and low-overhead experience.

About the Project

ChaqKey was created from a simple idea: many keyboard sound simulators currently available include more features than necessary, which often makes them heavier and less practical for users who just want a clean and efficient experience.

This project was built with a different approach: minimalist, lightweight, and optimized.
The focus is to deliver a mechanical keyboard sound experience for Windows without unnecessary complexity, extra windows, or resource-heavy behavior.

The name ChaqKey combines:

• Chaq, inspired by an onomatopoeic keypress sound, with a reference to Quechua (Peru)
• Key, from the word keyboard key, recognizable in both English and Spanish-speaking contexts

Highlights

• Minimalist Windows-focused application
• Runs from the system tray with no intrusive window
• Low-latency sound playback
• Multiple sound profile selection
• Volume levels: 25% / 50% / 75% / 100%
• Mute toggle
• Automatic startup with Windows
• Bilingual interface: English and Spanish
• Persistent configuration at AppData\Roaming\ChaqKey\config.json
• Packaged as a single standalone .exe with PyInstaller

Why ChaqKey?

ChaqKey is designed for users who want:

• A lightweight keyboard sound simulator
• A distraction-free experience
• A simple executable with no installation complexity
• A practical desktop utility focused on one thing done well

Quick Start

Option A — Run the executable

1. Download ChaqKey.exe from Releases
2. Double-click it — no installation required
3. Look for the ChaqKey icon in your system tray

Option B — Run from source

1. Make sure you have Python 3.11+ and pip installed
2. Clone or download this repository
3. Open a terminal in the project folder
4. Install runtime dependencies:

   pip install -r requirements.txt

5. Run the app:

   python chaqkey.py

Build to Executable

Option A — Automatic (recommended)

1. Open a terminal in the project folder
2. Run:

   build.bat

3. The executable will be created at dist\ChaqKey.exe

Option B — Manual

1. Install build dependencies:

   pip install -r requirements-build.txt

2. Run the following command in the project folder:

   python -m PyInstaller --onefile --noconsole --clean --name ChaqKey ^
     --icon icon.ico ^
     --add-data "Sounds;Sounds" ^
     --add-data "icon.ico;." ^
     --exclude-module tkinter ^
     --exclude-module matplotlib ^
     --exclude-module numpy ^
     --exclude-module scipy ^
     --exclude-module IPython ^
     --exclude-module unittest ^
     --exclude-module xmlrpc ^
     --exclude-module email ^
     chaqkey.py

Project Structure

ChaqKey/
├─ chaqkey.py
├─ build.bat
├─ icon.ico
├─ Demo.gif
├─ requirements.txt
├─ requirements-build.txt
├─ README.md
├─ CHANGELOG.md
├─ .gitignore
├─ ASSETS_ATTRIBUTION.md
├─ LICENSE.txt
├─ SECURITY.md
├─ CONTRIBUTING.md
└─ Sounds/
   ├─ Bubu.wav
   ├─ Chancho.wav
   ├─ Krilin.wav
   ├─ Osquitar.wav
   └─ Rica.wav

Additional Files

• CHANGELOG.md
• CONTRIBUTING.md
• SECURITY.md
• ASSETS_ATTRIBUTION.md

Support

If ChaqKey is useful to you, you can support future development here:

• Support development via PayPal

Credits

• Icon by Flaticon — keyboard icon
• Sounds by Pixabay Sound Effects — keyboard typing / key press sound effect
• Audio editing with Vocal Remover Cutter

License

MIT © 2026 IRS — see LICENSE.txt

---

Español

ChaqKey es un simulador liviano de sonido de teclado mecánico para Windows.
Funciona silenciosamente desde la bandeja del sistema y reproduce un sonido cada vez que presionas una tecla, entregando una experiencia simple, minimalista y de bajo consumo.

Sobre el proyecto

ChaqKey nació de una idea simple: muchos simuladores de sonido de teclado disponibles actualmente incluyen más funciones de las necesarias, lo que suele volverlos más pesados y menos prácticos para quienes solo buscan una experiencia limpia y eficiente.

Este proyecto fue desarrollado con un enfoque distinto: minimalista, liviano y optimizado.
El objetivo es ofrecer una experiencia de sonido de teclado mecánico para Windows sin complejidad innecesaria, sin ventanas extra y sin un consumo excesivo de recursos.

El nombre ChaqKey combina:

• Chaq, inspirado en un sonido onomatopéyico de pulsación, con una referencia al quechua (Perú)
• Key, por la palabra tecla o keyboard key, reconocible tanto en inglés como en contextos de habla hispana

Puntos destacados

• Aplicación liviana enfocada en Windows
• Funciona desde la bandeja del sistema, sin ventana invasiva
• Reproducción de sonido con baja latencia
• Selección de varios perfiles de sonido
• Niveles de volumen: 25% / 50% / 75% / 100%
• Opción de silenciar
• Inicio automático con Windows
• Interfaz bilingüe: inglés y español
• Configuración persistente en AppData\Roaming\ChaqKey\config.json
• Compilación a un único .exe con PyInstaller

¿Por qué ChaqKey?

ChaqKey está pensado para quienes buscan:

• Un simulador de sonido de teclado liviano
• Una experiencia sin distracciones
• Un ejecutable simple, sin instalación compleja
• Una utilidad de escritorio práctica, enfocada en hacer una sola cosa bien

Inicio rápido

Opción A — Ejecutar el programa compilado

1. Descarga ChaqKey.exe desde Releases
2. Haz doble clic — no requiere instalación
3. Busca el ícono de ChaqKey en la bandeja del sistema

Opción B — Ejecutar desde el código fuente

1. Asegúrate de tener Python 3.11+ y pip instalados
2. Clona o descarga este repositorio
3. Abre una terminal en la carpeta del proyecto
4. Instala las dependencias de ejecución:

   pip install -r requirements.txt

5. Ejecuta la aplicación:

   python chaqkey.py

Compilación a ejecutable

Opción A — Automática (recomendada)

1. Abre una terminal en la carpeta del proyecto
2. Ejecuta:

   build.bat

3. El ejecutable se creará en dist\ChaqKey.exe

Opción B — Manual

1. Instala las dependencias de compilación:

   pip install -r requirements-build.txt

2. Ejecuta el siguiente comando en la carpeta del proyecto:

   python -m PyInstaller --onefile --noconsole --clean --name ChaqKey ^
     --icon icon.ico ^
     --add-data "Sounds;Sounds" ^
     --add-data "icon.ico;." ^
     --exclude-module tkinter ^
     --exclude-module matplotlib ^
     --exclude-module numpy ^
     --exclude-module scipy ^
     --exclude-module IPython ^
     --exclude-module unittest ^
     --exclude-module xmlrpc ^
     --exclude-module email ^
     chaqkey.py

Estructura del proyecto

ChaqKey/
├─ chaqkey.py
├─ build.bat
├─ icon.ico
├─ Demo.gif
├─ requirements.txt
├─ requirements-build.txt
├─ README.md
├─ CHANGELOG.md
├─ .gitignore
├─ ASSETS_ATTRIBUTION.md
├─ LICENSE.txt
├─ SECURITY.md
├─ CONTRIBUTING.md
└─ Sounds/
   ├─ Bubu.wav
   ├─ Chancho.wav
   ├─ Krilin.wav
   ├─ Osquitar.wav
   └─ Rica.wav

Archivos adicionales

• CHANGELOG.md
• CONTRIBUTING.md
• SECURITY.md
• ASSETS_ATTRIBUTION.md

Apoyo

Si ChaqKey te resulta útil, puedes apoyar el desarrollo futuro aquí:

• Apoyar el desarrollo vía PayPal

Créditos

• Ícono por Flaticon — keyboard icon
• Sonidos por Pixabay Sound Effects — keyboard typing / key press sound effect
• Edición de audio con Vocal Remover Cutter

Licencia

MIT © 2026 IRS — ver LICENSE.txt