search

timschneeb / DDCToolbox

Create and edit DDC headset correction files
GNU General Public License v3.0
137 stars 13 forks source link
audio-filters audio-processing autoeq biquad equalization filter-design headset-correction iir jamesdsp signal-processing viper4android

readme

Icon
DDCToolbox

Create and edit ViPER DDC files on Linux, Windows, macOS and Android

GitHub downloads count GitHub release (latest by date) License Windows build

Features • Installation • Contributors • License

Screenshot

Features

Installation

Developed with Linux in mind. You can also find Windows and macOS installation instructions below.

Recommended:

Supported CPU architectures:

Other installation methods (not recommended):

Windows (Stable)

You can find stable windows packages attached on the release page.

Windows (Nightly)

These windows builds are automatically built and deployed once a new commit has been pushed. They may contain bugs but are always cutting-edge.

You can download one of these builds from my server.

If the server is down, you can also get one from the GitHub artifact storage:

  1. Visit the actions section
  2. Select the latest job at the top that finished successfully
  3. On the next page, scroll all the way down to the artifacts section
  4. Select your architecture and choose whether you want an installer or standalone executable.

NOTE: You need a GitHub account to download these build artifacts, otherwise you'll get redirected to a 404 page.

Debian/Ubuntu (PPA)

Recommended system requirements:

Add PPA Repo

sudo apt install -y curl
curl -s --compressed "https://thepbone.github.io/PPA-Repository/KEY.gpg" | sudo apt-key add -
sudo curl -s --compressed -o /etc/apt/sources.list.d/thepbone_ppa.list "https://thepbone.github.io/PPA-Repository/thepbone_ppa.list"
sudo apt update

Install from PPA

sudo apt install ddctoolbox

View PPA on GitHub

Arch (AUR)

A git package is available in the AUR.

yay -S ddctoolbox-git

AUR version

Snap package (Universal Linux)

Linux users can download a stable release of this app from the Snap Store. If snap is not yet installed on your system, you need to install it before you can continue: https://snapcraft.io/docs/installing-snapd. (All Ubuntu flavors, KDE Neon, Manjaro and Zorin OS have this utility already pre-installed)

Supported CPU architectures: x86_64, arm64, armhf, ppc64el, and s390x.

Once snap is properly installed, you can install ddctoolbox:

sudo snap install ddctoolbox

You can launch ddctoolbox by executing ddctoolbox in a terminal, or by selecting the application shortcut in your drop-down menu bar.

Note: If you installed snap for the first time, it may be necessary to relogin in order to make the application shortcut in your menu bar visible.

Snapcraft Badge

Android

There is an Android version of DDCToolbox with limited functionality available here: ThePBone/DDCToolbox-Android

macOS (Intel)

macOS support is currently in beta; only cloud-compiled nightly binaries are available. The next stable release will include stable versions of OSX binaries. OSX 10.13 (High Sierra) or later Intel macOS devices only. If your device is older or an ARM-based device, try to compile it from sources yourself.

You can download one of nightly beta builds from my server.

Debian (Nightly)

Qt 5.11 or later required. Debian 10 (or later releases) provide this version of Qt in their official repositories.

Since these nightly (beta) packages are not downloaded by your package manager, you will not be notified about any updates. If possible, please install this app from the stable PPA instead!

You can download one of these nightly debian packages or precompiled binaries from my server. They are automatically compiled and may contain bugs. Dependencies are not included with precompiled standalone executables.

Manually/Portable (Linux)

Build from sources

Requirements:

Install dependencies (Debian)

sudo apt install qt5-qmake qtbase5-dev libgl1-mesa-dev

Install dependencies (Arch)

sudo pacman -S qt5-base

Clone this repository

git clone --recurse-submodules https://github.com/ThePBone/DDCToolbox

Compile sources

cd DDCToolbox
qmake
make

You should now be able to execute it:

./DDCToolbox

Optional: Installation and shortcut

Copy to /usr/local/bin

sudo cp DDCToolbox /usr/local/bin/ddc-toolbox
sudo chmod 755 /usr/local/bin/ddc-toolbox

Create Menu Entry

sudo cat <<EOT >> /usr/share/applications/ddc_toolbox.desktop
[Desktop Entry]
Name=DDC Toolbox
GenericName=DDC Editor
Comment=Create and edit DDCs on Linux
Keywords=editor
Categories=AudioVideo;Audio;Editor
Exec=ddc-toolbox
Icon=/usr/share/pixmaps/ddc-toolbox.png
StartupNotify=false
Terminal=false
Type=Application
EOT

Download Icon

sudo wget -O /usr/share/pixmaps/ddc-toolbox.png https://raw.githubusercontent.com/ThePBone/DDCToolbox/master/img/icon.png -q --show-progress

Manually (macOS)

Note: these installation steps are untested but should still work.

Install Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install QT

brew install qt5

Symlink QT

brew link qt5 --force

Clone the repo

git clone --recurse-submodules https://github.com/ThePBone/DDCToolbox

Compile it

cd DDCToolbox
qmake
make

Run it open ./DDCToolbox.app

Contributors

License

This project is licensed under GPLv3.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR 
THE USE OR OTHER DEALINGS IN THE SOFTWARE.