Awesome
<h1 align="center"> <img alt="Icon" width="75" src="https://github.com/ThePBone/DDCToolbox/blob/master/res/img/icon.png?raw=true"> <br> DDCToolbox <br> </h1> <h4 align="center">Create and edit ViPER DDC files on Linux, Windows, macOS and Android</h4> <p align="center"> <a href="https://github.com/ThePBone/DDCToolbox/releases"> <img alt="GitHub downloads count" src="https://img.shields.io/github/downloads/ThePBone/DDCToolbox/total?label=downloads%20%28windows%29"> </a> <a href="https://github.com/ThePBone/DDCToolbox/releases"> <img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/thepbone/DDCToolbox"> </a> <a href="https://github.com/ThePBone/DDCToolbox/blob/master/LICENSE"> <img alt="License" src="https://img.shields.io/github/license/thepbone/DDCToolbox"> </a> <a href="https://github.com/ThePBone/DDCToolbox/"> <img alt="Windows build" src="https://img.shields.io/github/repo-size/thepbone/ddctoolbox"> </a> </p> <p align="center"> <a href="#features">Features</a> • <a href="#installation">Installation</a> • <a href="#contributors">Contributors</a> • <a href="#license">License</a> </p> <p align="center"> <img alt="Screenshot" src="https://github.com/ThePBone/DDCToolbox/blob/master/res/img/screenshot.png?raw=true"> </p>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 libMultivariateOpt)
Installation
Developed with Linux in mind. You can also find Windows and macOS installation instructions below.
Recommended:
- Windows
- Linux
- macOS
- Android
Supported CPU architectures:
- Windows
x86_64
only; precompiled
- Linux
- PPA -
x86_64
only; precompiled - AUR -
x86_64
,arm64
, andarmhf
; built from source - Snap -
x86_64
,arm64
,armhf
,ppc64el
, ands390x
; precompiled
- PPA -
- macOS
- Intel
x86_64
only
- Intel
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:
- Visit the actions section
- Select the latest job at the top that finished successfully
- On the next page, scroll all the way down to the artifacts section
- 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:
- Distro based on Debian 11 or later OR
- Distro based on Ubuntu 20.04 or later
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
Arch (AUR)
A git package is available in the AUR.
yay -S ddctoolbox-git
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.
<p align="center"> <a href="https://snapcraft.io/ddctoolbox"> <img alt="Snapcraft Badge" src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg"> </a> </p>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
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:
- 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 (libMultivariateOpt)
- 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.