97 lines
2.6 KiB
Markdown
97 lines
2.6 KiB
Markdown
# SoundBoard.AHK
|
|
|
|
A lightweight, fully customizable soundboard built with AutoHotkey.
|
|
Allows users to assign sound files to hotkeys dynamically through an `.ini` configuration file. No recompiling needed to change keys or sounds since it's handled on the seperate file.
|
|
|
|
---
|
|
|
|
## Features
|
|
- **Custom Hotkeys**: Bind any key you want with control (`Ctrl`) or alt (`Alt`) modifiers (by default).
|
|
- **Fully Configurable**: All key and modifier settings are stored in a simple `.ini` file.
|
|
- **Save and Reload Settings**: Save hotkey and sound assignments anytime without restarting the script.
|
|
- **Minimal & Fast**: No external libraries required, fully standalone.
|
|
|
|
---
|
|
|
|
## How It Works
|
|
|
|
1. All hotkey mappings are loaded from a `.ini` file (`save.ini` by default).
|
|
2. Modifier keys (e.g., Control, Alt) can also be customized through the ini.
|
|
3. Two types of actions:
|
|
- **Browse**: Press `Control + [Your Key]` to select a sound file (BY DEFAULT).
|
|
- **Play**: Press `Alt + [Your Key]` to play the assigned sound (BY DEFAULT).
|
|
|
|
The script automatically handles key registration at runtime.
|
|
|
|
---
|
|
|
|
## Default Controls
|
|
|
|
| Action | Key Combination | Description |
|
|
|--------------|-------------------------|--------------------------|
|
|
| Browse Sound | `Ctrl + [Assigned Key]` | Choose a sound file |
|
|
| Play Sound | `Alt + [Assigned Key]` | Play assigned sound |
|
|
| Save Mapping | `Ctrl + Alt + Shift +s` | Save all key mappings |
|
|
| Exit Script | `Ctrl + Win + Alt + X` | Exit the soundboard |
|
|
|
|
All keys are configurable via `save.ini`.
|
|
|
|
---
|
|
|
|
## Example `save.ini`
|
|
|
|
```ini
|
|
[Settings]
|
|
ControllerModifier=^
|
|
SoundModifier=!
|
|
|
|
[GeneralHotkeys]
|
|
SaveKey=^!+s
|
|
ExitKey=^#!x
|
|
|
|
[h1]
|
|
key=F1
|
|
path=C:\Sounds\sound1.wav
|
|
|
|
[h2]
|
|
key=F2
|
|
path=C:\Sounds\sound2.wav
|
|
|
|
; Add more sections like [h3], [h4], etc.
|
|
````
|
|
|
|
---
|
|
|
|
## How To Use
|
|
|
|
1. Install [AutoHotkey v1.1](https://www.autohotkey.com/) (classic) if you don't have it.
|
|
2. Clone this repository or download the `.ahk` script.
|
|
3. Edit `save.ini` according to your preferred hotkeys and sound files.
|
|
4. Run the script (`soundboard.ahk`).
|
|
5. Enjoy your custom soundboard!
|
|
|
|
---
|
|
|
|
## ⚙Requirements
|
|
|
|
* Windows OS
|
|
* AutoHotkey v1.1 (or newer)
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
This project is licensed under the [MIT License](MIT-LICENSE.txt).
|
|
|
|
## Support This Project
|
|
|
|
If you find this project helpful, you can support my work by donating via PayPal:
|
|
👉 [](https://www.paypal.me/rafli23115)
|
|
|
|
Thank you for your support!
|
|
|
|
---
|
|
|
|
> Crafted with 💡 and code by **TechLabs.**
|
|
**Leaping over limits, one project at a time. ♾**
|