https://github.com/postapczuk/cameliaeq
a CamillaDSP Equalizer GUI
https://github.com/postapczuk/cameliaeq
audio blackhole-2ch camilladsp dsp equalizer
Last synced: 3 months ago
JSON representation
a CamillaDSP Equalizer GUI
- Host: GitHub
- URL: https://github.com/postapczuk/cameliaeq
- Owner: postapczuk
- License: gpl-3.0
- Created: 2025-08-29T22:14:13.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-11-20T08:42:22.000Z (7 months ago)
- Last Synced: 2025-11-20T10:19:25.845Z (7 months ago)
- Topics: audio, blackhole-2ch, camilladsp, dsp, equalizer
- Language: Python
- Homepage:
- Size: 932 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CameliaEQ: a CamillaDSP Equalizer GUI
[](https://www.gnu.org/licenses/gpl-3.0)
Simple tray app for macOS/Linux to control Bass/Middle/Treble gains in a CamillaDSP config.
## Background
There are not many free and open source equalizers for macOS and Linux. Of course there is
__eqMac__, but it's troublesome while switching devices, and full of random crashes, so I've decided
to find an alternative solution.
Fortunately, there is one: BlackHole driver + CamillaDSP. Unfortunately, it's hard to use
by non-experienced users because it was created for more professional use cases.
Instead of using extensive CamillaGUI, which needs some programming knowledge, I've decided
to create a project that simply allows changing Bass/Middle/Treble gains.
## Disclaimer:
This application is PoC that during development I used to test features of IntelliJ's
Junie Ai assistant.
I did review and modified the resulting code, but there might be some bugs and flaws.
As LICENSE says: I'm not responsible for any harm that could happen during usage of
this software. I've created this just for my use and decided to share it with others.
# Running the app
___
## Requirements
- Python 3.9+
- blackhole-2ch installed
- running CamillaDSP
### Notes
Settings are stored in a user config file `settings.yml`. Paths:
- macOS `~/Library/Application Support/CameliaEQ/settings.yml`
- Linux `~/.config/CameliaEQ/settings.yml`.
## macOS
___
### 1. Install BlackHole driver
```commandline
brew install --cask blackhole-2ch
```
### 2. Install CamillaDSP (the trickiest part)
- ###### Steps contain placeholders you need to replace:
- `` with your directory to `camilladsp`
- `` to control CamillaDSP over WebSocket. If you don't know what it means, put `1234`
- `` configuration file you'd like to use
- Download and extract a specific version for your computer https://github.com/HEnquist/camilladsp/releases/tag/v3.0.1
- Open terminal and go to directory with `camilladsp` executable
- Create new CamillaDSP config file with title, all other properties will be set by the app:
```
mkdir config
nano config/.yml
echo $'' >> config/.yml
```
- Check if you are able to run CamillaDSP
```
./camilladsp -w -p /configs/.yml
```
Don't worry if you get the following log:
```
INFO [src/bin.rs:781] CamillaDSP version 3.0.1
INFO [src/bin.rs:782] Running on macos, aarch64
ERROR [src/bin.rs:939] Invalid config file!
EOF while parsing a value
```
This is completely normal, and happens because the configuration file is empty
### :warning::warning: WARNING :warning::warning:
If you receive prompt about untrusted software, app is under system quarantine. To remove quarantine run, and retry:
```
xattr -d com.apple.quarantine
```
- Prepare a startup file with a command `nano ~/Library/LaunchAgents/com.github.camilladsp.startup.plist`
and save it with this content:
```
Label
com.github.camilladsp.startup
ProgramArguments
/camilladsp
-w
-p
/configs/.yml
RunAtLoad
```
- Launch on system log-in:
```commandline
launchctl load ~/Library/LaunchAgents/com.github.camilladsp.startup.plist
```
- Restart system
### 3. Run CameliaEQ
There are two options to run the app. If you are not familiar with python, and you don't want to learn it,
I'd recommend you to run the app from executable:
- Download and extract executable from [Releases](https://github.com/postapczuk/cameliaEQ/releases) page in this repo valid for your system
- Double click the app icon, or run in commandline:
```commandline
./cameliaEQ
```
- Go to `Settings` and set CamillaDSP config file that was set previously
## Linux
___
(TBD) But I'm sure if you are Linux user, basing on MacOS steps you know what to do ;)
## Build executable from sources
If you'd like to run this APP from sources, or build your own executable:
- Go to the directory to which this repository is downloaded
- Create new virtual environment:
```commandline
python3 -m venv .venv
```
- Activate the environment:
```commandline
source .venv/bin/activate
```
- Install python dependencies:
```commandline
pip install -r requirements.txt
```
- You can run the app via command line directly:
```commandline
python -m cameliaeq
```
- Install pyinstaller:
```commandline
pip install pyinstaller
```
- Or build executable (your executables should be in `/dist`):
```commandline
pyinstaller --windowed --onefile --icon=icon.icns --name="cameliaEQ" cameliaeq/__main__.py
```