You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Notice: Currently the code in this repository corresponds to v1.3.2 of eqMac and all the newer releases are done on a private fork. I'm still unsure if new releases will be open sourced, mostly because I don't see the benefit of open sourcing the app anymore. Change my mind.
13
+
**Notice: Currently the code in this repository corresponds to v1.3.2 of eqMac without any Pro Features and all the newer releases are done on a private fork. Having the Free parts of the app open sourced required too much time to maintain and split off.**
14
14
15
15
## Features
16
16
### Current
17
-
* System audio Source
18
-
* Volume Booster
19
-
* HDMI Volume Support
20
-
* Volume Balance support for all devices (including HDMI)
*[AutoEQ](https://github.com/jaakkopasanen/AutoEq?referrer=eqMac&referer=eqMac&utm_source=eqMac) Integration - Automatic Headphone Equalization from frequency responses. `Free` for Advanced EQ and `Pro` as part of the Expert EQ
26
+
*`Pro`AudioUnit (AU) Hosting* - add 3rd party effects to the Audio Pipeline
27
+
*`Pro`Spatial Audio - simulate different listening environments like Concert Halls or Different sized Rooms.
28
+
*`Pro`Volume Mixer - Apply different volume levels per each application
29
+
* Custom UI - Fully customize the look and feel of eqMac by changing the User Interface Colors (`Pro`), Feature visibility (`Free`) and arrangement (Soon).
30
30
31
31
### Roadmap
32
32
Idea is to become the ultimate Audio toolbox for macOS
@@ -43,61 +43,19 @@ Idea is to become the ultimate Audio toolbox for macOS
43
43
[Vote on the Features you want to see sooner](https://eqmac.app/#coming-soon)
44
44
45
45
## User support
46
-
This project is heavily reliant on the whole community helping each other out. If you have an issue with eqMac please go through [Issues](https://github.com/bitgapp/eqMac/issues) to see if it's already being discussed, if not create a new one. Also you can [join our Discord](https://discord.eqmac.app), I'm there all the time and I like to chat with people.
46
+
If you are a `Pro` customer I provide Customer Support through the Contact form on the website :)
47
+
This project is heavily reliant on the whole community helping each other out. If you have an issue with eqMac please go through [Issues](https://github.com/bitgapp/eqMac/issues) to see if it's already being discussed, if not create a new one. Also you can [join our Discord](https://discord.eqmac.app), I'm there all the time and I like to chat with people.
47
48
48
49
## Technology
49
50
eqMac was built using these technologies:
50
-
*[Driver](https://github.com/bitgapp/eqMac/tree/master/native/driver) - System Audio loopback/passthrough device based on [Apple's Null Audio Server Driver Plug-in](https://developer.apple.com/documentation/coreaudio/creating_an_audio_server_driver_plug-in) example. One of the first Examples of a macOS System Capture drivers written in Swift. The driver grabs the system audio stream and sends it to the input channels (similar to [BlackHole](https://github.com/ExistentialAudio/BlackHole)). eqMac can grab this stream, process it and send to the appropriate audio device. The driver runs in User space instead of Kernel like the previous drivers (i.e SoundFlower), which means it's much more secure and stable.
51
-
*[App](https://github.com/bitgapp/eqMac/tree/master/native/app) - Native backend to the whole app. Responsible for audio processing, filesystem access, window management, API and general lifecycle of eqMac. Written in Swift and uses Apple's more modern [AVAudioEngine API](https://developer.apple.com/documentation/avfoundation/avaudioengine), unlike the previous version that used a deprecated AUGraph API.
52
-
*[UI](https://github.com/bitgapp/eqMac/tree/master/ui) - Web based user interface that is hosted remotely and thus allows for over the air updates & bug fixes. Built with [Angular](https://angular.io/) + [TypeScript](https://www.typescriptlang.org/) and is cached for offline availability.
53
-
54
-
## Contribution
55
-
At the moment eqMac is going through a major rewrite and it's hard to coordinate the development of big features. But bug fixes, performance optimizations and refactoring PR's are welcomed! Please create an issue on GitHub (please check if your issue is already being discussed) or [join our Discord](https://discord.eqmac.app) to discuss. Once a piece of work has been agreed - fork, build, debug, fix, merge and create a Pull Request to get your work merged in :)
56
-
Check the documentation below to understand how to start eqMac debug process from Xcode
57
-
58
-
## Development
59
-
Fork the repository, then run these commands in Terminal.app:
You don't need to run the UI code locally to debug just the Swift side of the app, unless you want to debug the UI code :)
82
-
If you want to run the web based User Interface locally then you need to follow these steps to make that happen:
83
-
84
-
#### Prerequisites
85
-
Install [Node.js](https://nodejs.org/en/) LTS version preferrably using [NVM](https://github.com/nvm-sh/nvm#installing-and-updating)
86
-
87
-
Install [Yarn](https://classic.yarnpkg.com/en/) v1 globally: `npm i -g yarn` (this is needed because the project uses [Yarn Workspaces](https://classic.yarnpkg.com/en/docs/workspaces/))
88
-
89
-
#### Building and running the Web UI
90
-
1. Run `yarn` from the root directory of the Monorepo
91
-
2. Go into the ui/ directory by `cd ui/`
92
-
3. Start local development server with `yarn start`
93
-
51
+
*[App](https://github.com/bitgapp/eqMac/tree/master/native/app) - Native backend to the whole app. Responsible for audio processing, filesystem access, window management, API and general lifecycle of eqMac.
52
+
*[UI](https://github.com/bitgapp/eqMac/tree/master/ui) - Web based user interface that is hosted remotely and thus allows for Over the Air (OTA) updates & bug fixes. Built with [Angular](https://angular.io/) + [TypeScript](https://www.typescriptlang.org/) and is cached for offline availability.
53
+
*[Driver](https://github.com/bitgapp/eqMac/tree/master/native/driver) - System Audio loopback/passthrough device based on [Apple's Null Audio Server Driver Plug-in](https://developer.apple.com/documentation/coreaudio/creating_an_audio_server_driver_plug-in) example. One of the first Examples of a macOS System Capture drivers written in Swift. The driver grabs the system audio stream and sends it to the app through a secure memory tunnel. eqMac can grab this stream, process it and send to the appropriate audio device. The driver runs in User space instead of Kernel like the previous drivers (i.e SoundFlower), which means it's much more secure and stable.
94
54
95
55
## Credits
96
56
97
57
[@nodeful](https://github.com/nodeful) - Creator and Developer of eqMac
98
58
99
-
Apple Inc. - For open sourcing this [HAL Driver Example](https://developer.apple.com/documentation/coreaudio/creating_an_audio_server_driver_plug-in)
100
-
101
59
[@titanicbobo](https://github.com/titanicbobo) - For the [Big Sur icon design](https://github.com/bitgapp/eqMac/blob/master/assets/icon/icon.svg)
102
60
103
61
[Max Heim](https://github.com/0bmxa) - For his research and work on creating the first Swift based Audio Server Plug-in Driver - [Pancake](https://github.com/0bmxa/Pancake)
0 commit comments