keyboardsounds.mov

Keyboard Sounds

Keyboard Sounds is a free application that makes any keyboard sound like a Mechanical Keyboard. It includes 16 built in profiles, a profile editor, and application rules.

Getting Started

• Install Keyboard Sounds
• Create Custom Profiles
• Application Rules
• Using Keyboard Sounds with OBS
• Command Line Usage

Helpful Links

• Uninstall Keyboard Sounds
• Developer Documentation

Installation

Keyboard Sounds can be installed as a desktop application or as a Python package. The desktop application is recommended for most users as it is easier to install and use.

Desktop Application (Windows only)

⬇️ Download

Currently the desktop application is only available for Windows. The Python package can be used on any platform that supports Python.

The desktop application still requires the command line to be installed on your system. On first launch, the application will check that both Python and the required Python packages are installed.

Important

Make sure when you install Python that you check the box that says "Add Python to PATH". This will allow you to run Python from the command line, which is a requirement for the application to function correctly.

You may need to restart the application after doing this for the changes to take effect.

For information on uninstalling Keyboard Sounds, see Uninstall Keyboard Sounds

Features

Custom Profiles

• Support for both Mouse and Keyboard audio profiles
• Comes bundled with sixteen built in profiles (15 keyboard, 1 mouse)
• Supports Custom profiles through the editors (.wav and .mp3 supported)

Read more about creating and editing profiles here.

Application Rules

• Keyboard Sounds supports application rules in which you can control the behavior of the sound daemon based on the currently focused application.

• This allows you to do things like only enabling in your text editor or terminal, disabling it for specific games, or localizing the sound effects to a particular application.

• Read more about application rules here.

• Application rules are currently only available for the Windows platform.

Using Keyboard Sounds with OBS

In order to use Keyboard Sounds with OBS as an isolated audio source, OBS needs a window that it can attach to that's connected to the process running the Daemon. This is not the same process as the desktop application. To work with this, Keyboard Sounds provides a window that can be enabled for the audio daemon.

To enable this window you have several options:

1. If you ALWAYS want the daemon window: In the Settings tab of the Keyboard Sounds Desktop Application, check the "Enable Daemon Window" option. This will start the daemon window each time that the sound daemon is started by the desktop application.
2. If you only want the daemon window on demand: You can opposite click the Keyboard Sounds tray icon in your system tray and select the "Show Daemon Window" option. This will only work when the daemon is currently running.
3. If you are using the command line: Run your kbs start command with the -w flag.

Note

On linux, you will need to run sudo apt install python3-tk in order to use the -w flag with kbs start.

Command Line (macOS, Linux or Windows)

1. Install Python

   To install this application as a CLI utility via the Python package, you will need to have Python installed on your system. You can download Python from the official website.

Important

Make sure when you install Python that you check the box that says "Add Python to PATH". This will allow you to run Python from the command line, which is a requirement for the application to function correctly.

2. Install the Keyboard Sounds CLI

   After you have installed Python, you can install the Keyboard Sounds CLI by running the following command in your terminal.

   $ pip install keyboardsounds

3. Using the CLI

   To use the Keyboard Sounds CLI, run kbs --help from your command line terminal.

Uninstalling

You can uninstall the Keyboard Sounds Desktop Application from the "Apps" section of your system Settings application.

• Uninstalling the desktop app will not remove the Python package from your system, you will need to do this manually if you no longer wish to use the Python package using the following command:

  $ pip uninstall keyboardsounds

Development

Documentation for developers who wish to contribute to this project can be found here.

Stargazers over time