{"id":46109776,"url":"https://github.com/postapczuk/cameliaeq","last_synced_at":"2026-03-01T22:04:43.379Z","repository":{"id":312340567,"uuid":"1047185542","full_name":"postapczuk/cameliaEQ","owner":"postapczuk","description":"a CamillaDSP Equalizer GUI","archived":false,"fork":false,"pushed_at":"2025-11-20T08:42:22.000Z","size":954,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-20T10:19:25.845Z","etag":null,"topics":["audio","blackhole-2ch","camilladsp","dsp","equalizer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/postapczuk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-29T22:14:13.000Z","updated_at":"2025-11-20T08:34:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"dceac3fb-062f-4039-9c33-9587b461ebf0","html_url":"https://github.com/postapczuk/cameliaEQ","commit_stats":null,"previous_names":["postapczuk/cameliaeq"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/postapczuk/cameliaEQ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postapczuk%2FcameliaEQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postapczuk%2FcameliaEQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postapczuk%2FcameliaEQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postapczuk%2FcameliaEQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/postapczuk","download_url":"https://codeload.github.com/postapczuk/cameliaEQ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postapczuk%2FcameliaEQ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29986242,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T21:06:37.093Z","status":"ssl_error","status_checked_at":"2026-03-01T21:05:45.052Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","blackhole-2ch","camilladsp","dsp","equalizer"],"created_at":"2026-03-01T22:04:42.734Z","updated_at":"2026-03-01T22:04:43.367Z","avatar_url":"https://github.com/postapczuk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CameliaEQ: a CamillaDSP Equalizer GUI \n[![License: GPL v3](https://img.shields.io/badge/License-GPL_v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\nSimple tray app for macOS/Linux to control Bass/Middle/Treble gains in a CamillaDSP config.\n\n![Scrshot](equalizer.png)\n\n## Background\nThere are not many free and open source equalizers for macOS and Linux. Of course there is\n__eqMac__, but it's troublesome while switching devices, and full of random crashes, so I've decided \nto find an alternative solution.\n\nFortunately, there is one: BlackHole driver + CamillaDSP. Unfortunately, it's hard to use\nby non-experienced users because it was created for more professional use cases.\nInstead of using extensive CamillaGUI, which needs some programming knowledge, I've decided\nto create a project that simply allows changing Bass/Middle/Treble gains.\n\n## Disclaimer:\nThis application is PoC that during development I used to test features of IntelliJ's \nJunie Ai assistant. \n\nI did review and modified the resulting code, but there might be some bugs and flaws. \nAs LICENSE says: I'm not responsible for any harm that could happen during usage of\nthis software. I've created this just for my use and decided to share it with others.\n\n\n# Running the app\n___\n## Requirements\n- Python 3.9+\n- blackhole-2ch installed\n- running CamillaDSP\n\n### Notes\nSettings are stored in a user config file `settings.yml`. Paths:\n- macOS `~/Library/Application Support/CameliaEQ/settings.yml`\n- Linux `~/.config/CameliaEQ/settings.yml`.\n\n\n## macOS\n___\n\n### 1. Install BlackHole driver\n```commandline\nbrew install --cask blackhole-2ch\n```\n\n### 2. Install CamillaDSP (the trickiest part)\n\n- ###### Steps contain placeholders you need to replace:\n  - `\u003cDIRECTORY_TO_CAMILLADSP\u003e` with your directory to `camilladsp`\n  - `\u003cWEBSOCKET_PORT\u003e` to control CamillaDSP over WebSocket. If you don't know what it means, put `1234`\n  - `\u003cCONFIG\u003e` configuration file you'd like to use\n\n\n- Download and extract a specific version for your computer https://github.com/HEnquist/camilladsp/releases/tag/v3.0.1\n- Open terminal and go to directory with `camilladsp` executable\n- Create new CamillaDSP config file with title, all other properties will be set by the app:\n  ```\n  mkdir config\n  nano config/\u003cCONFIG\u003e.yml\n  echo $'' \u003e\u003e config/\u003cCONFIG\u003e.yml\n  ```\n- Check if you are able to run CamillaDSP \n  ```\n  ./camilladsp -w -p\u003cWEBSOCKET_PORT\u003e \u003cDIRECTORY_TO_CAMILLADSP\u003e/configs/\u003cCONFIG\u003e.yml\n  ```\n  Don't worry if you get the following log:\n  ```\n  INFO [src/bin.rs:781] CamillaDSP version 3.0.1\n  INFO [src/bin.rs:782] Running on macos, aarch64\n  ERROR [src/bin.rs:939] Invalid config file!\n  EOF while parsing a value\n  ```\n  This is completely normal, and happens because the configuration file is empty\n\n  ### :warning::warning: WARNING :warning::warning:\n  If you receive prompt about untrusted software, app is under system quarantine. To remove quarantine run, and retry:\n  ```\n  xattr -d com.apple.quarantine \u003cDIRECTORY_TO_CAMILLADSP\u003e \n  ```\n- Prepare a startup file with a command `nano ~/Library/LaunchAgents/com.github.camilladsp.startup.plist` \n  and save it with this content:\n  ```\n  \u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n  \u003c!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\"\u003e\n  \u003cplist version=\"1.0\"\u003e\n  \u003cdict\u003e\n    \u003ckey\u003eLabel\u003c/key\u003e\n    \u003cstring\u003ecom.github.camilladsp.startup\u003c/string\u003e\n    \u003ckey\u003eProgramArguments\u003c/key\u003e\n    \u003carray\u003e\n      \u003cstring\u003e\u003cDIRECTORY_TO_CAMILLADSP\u003e/camilladsp\u003c/string\u003e\n      \u003cstring\u003e-w\u003c/string\u003e\n      \u003cstring\u003e-p\u003cWEBSOCKET_PORT\u003e\u003c/string\u003e\n      \u003cstring\u003e\u003cDIRECTORY_TO_CAMILLADSP\u003e/configs/\u003cCONFIG\u003e.yml\u003c/string\u003e\n    \u003c/array\u003e\n    \u003ckey\u003eRunAtLoad\u003c/key\u003e\n    \u003ctrue/\u003e\n  \u003c/dict\u003e\n  \u003c/plist\u003e\n  ```\n- Launch on system log-in:\n  ```commandline\n  launchctl load ~/Library/LaunchAgents/com.github.camilladsp.startup.plist\n  ```\n- Restart system\n\n### 3. Run CameliaEQ\nThere are two options to run the app. If you are not familiar with python, and you don't want to learn it, \nI'd recommend you to run the app from executable:\n\n- Download and extract executable from [Releases](https://github.com/postapczuk/cameliaEQ/releases) page in this repo valid for your system\n- Double click the app icon, or run in commandline:\n  ```commandline\n  ./cameliaEQ\n  ```\n- Go to `Settings` and set CamillaDSP config file that was set previously\n\n## Linux\n___\n(TBD) But I'm sure if you are Linux user, basing on MacOS steps you know what to do ;) \n\n## Build executable from sources\nIf you'd like to run this APP from sources, or build your own executable:\n   - Go to the directory to which this repository is downloaded\n   - Create new virtual environment:\n     ```commandline\n     python3 -m venv .venv\n     ```\n   - Activate the environment:\n     ```commandline\n     source .venv/bin/activate\n     ```\n   - Install python dependencies:\n     ```commandline\n     pip install -r requirements.txt\n     ```\n   - You can run the app via command line directly:\n     ```commandline\n     python -m cameliaeq\n     ```\n   - Install pyinstaller:\n     ```commandline\n     pip install pyinstaller\n     ```\n   - Or build executable (your executables should be in `/dist`):\n     ```commandline\n     pyinstaller --windowed --onefile --icon=icon.icns --name=\"cameliaEQ\" cameliaeq/__main__.py\n     ```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostapczuk%2Fcameliaeq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpostapczuk%2Fcameliaeq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostapczuk%2Fcameliaeq/lists"}