# DDCToolbox

**Repository Path**: james34602/DDCToolbox

## Basic Information

- **Project Name**: DDCToolbox
- **Description**: Create and edit DDC headset correction files
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-17
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DDCToolbox
[![Appveyor Build status](https://ci.appveyor.com/api/projects/status/7akte2nk20j6u9w1?svg=true)](https://ci.appveyor.com/project/ThePBone/ddctoolbox)
![License](https://img.shields.io/github/license/ThePBone/DDCToolbox)
![GitHub release](https://img.shields.io/github/release/ThePBone/DDCToolbox)

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

## Features
 * Save/load *.vdcprj files
 * Export as *.vdc
 * Import VDCs (to *.vdcprj)
 * Direct AutoEQ integration
 * Proper undo/redo framework 
 * Edit values directly in the table
 * Interactive magnitude response, phase response and group delay plot
 * Various IIR filter types (peaking, low/high pass/shelf, notch, all/band pass and unity gain)
 * Embed custom IIR filters
 * Stability check for filters

## Screenshot

![Screenshot](https://github.com/ThePBone/DDCToolbox/blob/master/img/screenshot.png?raw=true)

# Installation
Developed with Linux in mind. You can also find Windows and macOS installation instructions below.
  * [Windows](#windows)
  * [Arch (AUR)](#arch-aur)
  * [Ubuntu](#ubuntu-ppa)
  * [Debian](#debian)
  * [Android](#android)
  * [Manually (Linux)](#manuallyportable-linux)
  * [Manually (macOS)](#manually-macos)
  
## Windows

### Stable releases
You can find stable windows packages attached on the [release page](https://github.com/ThePBone/DDCToolbox/releases).

### Nightly builds
These windows builds are automatically built and deployed once a new commit has been pushed.

You can download one of these builds [from my server](https://nightly.timschneeberger.me/ddctoolbox-win).

If the server is down, you can also get one from the [AppVeyor cloud](https://ci.appveyor.com/project/ThePBone/ddctoolbox) (select one of the two jobs (32/64-bit) and go to the tab 'Artifacts')

## Arch (AUR)
A git package is available in the [AUR](https://aur.archlinux.org/packages/ddctoolbox-git/).
```bash
yay -S ddctoolbox-git
```
![AUR version](https://img.shields.io/aur/version/ddctoolbox-git?label=aur-git)

## Ubuntu (PPA)
Add PPA Repo
```bash
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
```bash
sudo apt install ddc-toolbox
```
[View PPA on GitHub](https://github.com/ThePBone/PPA-Repository)

## Debian
### Stable releases
Users of debian-based distros can use the DEB-packages that are attached on the [release page](https://github.com/ThePBone/DDCToolbox/releases).

### Nightly builds
You can download one of these DEB-builds [from my server](https://nightly.timschneeberger.me/ddctoolbox-debian).
They are automatically compiled and may contain bugs.

## Android
There is an Android version of DDCToolbox with limited functionality available here: [ThePBone/DDCToolbox-Android](https://github.com/ThePBone/DDCToolbox-Android)

## Manually/Portable (Linux)
### Build from sources

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 https://github.com/ThePBone/DDCToolbox

Compile sources

    cd DDCToolbox
    qmake
    make

You should now be able to execute it:

    ./DDCToolbox

### Optional: Manual installation
Copy to /usr/local/bin
```bash
sudo cp DDCToolbox /usr/local/bin/ddc-toolbox
sudo chmod 755 /usr/local/bin/ddc-toolbox
```
Create Menu Entry
```bash
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
```bash
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 https://github.com/ThePBone/DDCToolbox

Compile it

    cd DDCToolbox
    qmake
    make

Run it
    
    open ./DDCToolbox.app

## Contributors
* [James Fung (@james34602):](https://github.com/james34602)
  * VDC Importer
  * Group delay plot
  * Unity gain filter 
_____________
Based on ViPERs Toolbox 2.0 for Windows