garymathews/ddctoolbox

Create and edit DDC headset correction files

DDCToolbox

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

Features • Installation • Contributors • License

Features

• Save/load VDC project files
• Import/export VDCs
• Direct AutoEQ integration
• Undo/redo framework
• Edit values directly in the table
• Interactive magnitude response, phase response and group delay plot
• Various IIR filters (peaking, low/high pass/shelf, notch, all/band pass and unity gain)
• Embed custom IIR filters
• Stability check for filters
• Advanced peaking filter curve fitting (using libgradfreeOpt)

Installation

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

Recommended:

• Windows
  • Windows (Stable)
  • Windows (Nightly)
• Linux
  • Linux (Any distro)
  • Arch Linux (AUR)
• macOS
  • macOS (OSX 10.13 and later, Intel x64 only)
• Android
  • Android app (basic features only)

Other installation methods (not recommended):

• Linux
  • Debian (Unmanaged/Nightly)
  • Build from sources (Linux)
• macOS
  • Build from sources (macOS)

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.

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)

NOTE: The snapcraft package are currently outdated. Consider using the AUR or compiling from sources manually.

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.

Android

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

Arch (AUR)

A git package is available in the AUR.

yay -S ddctoolbox-git

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 Snap Store 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:

• Qt 5.11 or later

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

• James Fung (@james34602):
  • Peaking filter curve fitting (libgradfreeOpt)
  • VDC Importer
  • Group delay plot
  • Unity gain filter
  • and more

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.