1
1
mirror of https://github.com/bitgapp/eqMac.git synced 2024-11-26 16:05:52 +03:00
eqMac/README.md

93 lines
5.4 KiB
Markdown
Raw Normal View History

2020-04-05 18:03:42 +03:00
<p align="center">
<img width="512" src="https://github.com/bitgapp/eqMac/raw/master/assets/logos/promo-dark.png"/>
2020-04-05 18:03:42 +03:00
</p>
2020-04-05 18:11:17 +03:00
<p align="center">
2021-06-25 00:56:46 +03:00
<img width="512" src="https://github.com/bitgapp/eqMac/raw/master/assets/screenshots/expert-eq.png"/>
2020-04-05 18:11:17 +03:00
</p>
2020-04-05 18:02:04 +03:00
2021-05-08 15:23:43 +03:00
<p align="center">
<a href="https://discord.eqmac.app"><img src="https://img.shields.io/badge/chat-discord-black?style=flat&logo=discord" alt="discord chat"></a>
</p>
2020-04-06 00:57:50 +03:00
## Features
### Current
* System-wide audio source
* Volume Booster
2021-06-25 00:56:46 +03:00
* HDMI Volume Support
* Volume Balance support for all devices (including HDMI)
2020-04-06 00:57:50 +03:00
* Basic EQ - 3 band (Bass, Mids, Treble)
* Advanced EQ - 10 bands
2021-06-26 01:19:18 +03:00
* Expert EQ - Unlimited bands*
* Spectrum analyzer*
* [AutoEQ](https://github.com/jaakkopasanen/AutoEq?referrer=eqMac&referer=eqMac&utm_source=eqMac) Integration*
*Not Open Sourced
2020-04-06 00:57:50 +03:00
### Roadmap
2020-04-06 01:04:23 +03:00
Idea is to become the ultimate Audio toolbox for macOS (some features might not be open sourced)
2021-03-24 20:04:41 +03:00
* Reverb - Spatial audio enhancement
2020-04-06 01:04:57 +03:00
* Volume mixer - Apply different volume levels per each application
2020-04-06 00:57:50 +03:00
* Input audio source - Apply effects to any device: guitar, microphone etc.
* Recorder - save any audio playback (System, Input device, File)
* File playback and rendering - Apply effects to audio files and instantly render them
* Remote control from your phone
* Hide unused effects / elements of the UI
* and more...
## User support
2020-05-27 01:30:03 +03:00
I'm notoriously known for lacking in communication with users due to lack of time in my busy life. 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). Please no stupid questions like "How to bass?" - those will be completely ignored.
2020-04-06 00:57:50 +03:00
## Technology
eqMac was built using these technologies:
2021-07-10 15:35:04 +03:00
* [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. The driver grabs the system audio stream and sends it to the input channels. eqMac can grab this stream, process it and send to the appropriate audio device. Still very low level C++ code although the driver runs in User space instead of Kernel like the previous drivers, which means it's much more secure and stable.
2020-04-06 00:57:50 +03:00
* [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.
2021-06-20 20:07:47 +03:00
* [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.
2020-04-06 00:57:50 +03:00
## Contribution
2020-05-27 23:38:57 +03:00
At the moment eqMac is going through a major rewrite and it's hard to coordinate the development of big features, but I'm open to try anyway. 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 :)
Check the documentation below to understand how to start eqMac debug process from Xcode
2020-04-06 00:57:50 +03:00
2021-05-21 20:49:25 +03:00
## Credits
[@nodeful](https://github.com/nodeful) - Creator and Developer of eqMac
2021-07-10 15:35:04 +03:00
Apple Inc. - For open sourcing this [HAL Driver Example](https://developer.apple.com/documentation/coreaudio/creating_an_audio_server_driver_plug-in)
2021-05-21 20:49:25 +03:00
[@titanicbobo](https://github.com/titanicbobo) - For the [Big Sur icon design](https://github.com/bitgapp/eqMac/blob/master/assets/icon/icon.svg)
2021-05-21 20:49:25 +03:00
2020-05-27 23:38:57 +03:00
## Development
Fork the repository, then run these commands in Terminal.app:
```
git clone https://github.com/YOUR_USERNAME/eqMac.git
cd eqMac/
```
### Web User Interface
If you want to run the web based User Interface locally then you need to follow these steps to make that happen:
#### Prerequisites
Install [Node.js](https://nodejs.org/en/) LTS version preferrably using [NVM](https://github.com/nvm-sh/nvm#installing-and-updating)
2021-04-10 16:32:25 +03:00
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/))
2020-05-27 23:38:57 +03:00
#### Building and running the Web UI
2021-04-10 16:32:25 +03:00
1. Run `yarn` from the root directory of the Monorepo
2. Go into the ui/ directory by `cd ui/`
3. Start local development server with `yarn start`
2020-05-27 23:38:57 +03:00
### Native app + driver
#### Prerequisites
1. Download [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12)
2. Install [CocoaPods](https://cocoapods.org/) by `sudo gem install cocoapods`
#### Building and running the App
2020-11-23 01:23:09 +03:00
1. Go into the native/app directory from root of the repo by: `cd native/`
2020-05-27 23:38:57 +03:00
2. Install Cocoapod dependencies: `pod install`
2020-11-23 01:23:09 +03:00
3. Open the Xcode workspace: `open eqMac.xcworkspace`
4. Launch eqMac in debug mode by running the **App - Debug** Scheme:
2020-05-27 23:38:57 +03:00
<img width="512" src="https://user-images.githubusercontent.com/8472525/83069640-279c1100-a062-11ea-85a7-45aa5253771b.png"/>