DpdoEngine Parameter Reference
This document lists all DpdoEngine command-line parameters by category.
Generic format: DpdoEngine -i <INFILE> <OUTFILE> [OPTIONS]
1. Basic Parameters
| Parameter | Description | Example |
|---|
-i INFILE | Input PCM file path (FLAC / WAV / AIFF / MP3, etc.) | -i track.flac |
OUTFILE | Output file path; extension determines format | track.dsf |
--reverse | Reverse mode: DSD → PCM | --reverse |
--oversampling N or --oversampling N | Set oversampling ratio | --oversampling 256 |
--help | Show help | --help |
2. Noise Shaping (IIR)
| Parameter | Description | Values |
|---|
--order N | IIR noise shaper order | 3, 5, 7, 9, 11 |
--pole V | Pole placement | float (default 8.5) |
--zero | Zero placement optimization | — |
--mash | MASH structure | — |
--cifb | CIFB (Chain of Integrators with FeedBack) structure | — |
--poly | Polynomial noise shaping | — |
Examples
# 11th-order IIR + MASH
DpdoEngine -i input.wav output.dsf --oversampling 128 --order 11 --mash
# Custom pole
DpdoEngine -i input.wav output.dsf --oversampling 64 --order 7 --pole 9.2
3. FIR Filters
| Parameter | Description | Default |
|---|
| `` | Enable FIR filter mode | off |
--taps N | Number of FIR taps | auto (min 4096) |
--beta V or --beta V | Kaiser window beta | auto |
--window-type TYPE | Window type | kaiser |
Window Types
| Value | Description | Characteristics |
|---|
kaiser | Kaiser window | adjustable sidelobe suppression, general purpose |
blackman | Blackman window | high sidelobe attenuation |
flattop | Flat Top window | precise amplitude measurement |
bartlett | Bartlett (triangular) window | simple, moderate sidelobe attenuation |
hamming | Hamming window | classic, balanced resolution and leakage |
hanning | Hanning (Hann) window | good low-frequency leakage |
remez | Parks-McClellan (Remez) | equiripple optimal FIR |
4. Oversampling Ratio
| Parameter | Description |
|---|
--oversampling N | Oversampling ratio (64–4096, powers of 2) |
--oversampling N | Same as above |
Recommended Matching
| Input Sample Rate | Target DSD | Recommended OSR |
|---|
| 44.1 kHz | DSD64 | 64 |
| 88.2 kHz | DSD64 | 32 |
| 96 kHz | DSD128 | 64 |
| 192 kHz | DSD256 | 64 |
5. GPU Acceleration
| Parameter | Description |
|---|
--opencl | Enable OpenCL GPU acceleration |
--no-opencl | Force-disable GPU (pure CPU mode) |
GPU acceleration is recommended for:
- High oversampling (OSR ≥ 256)
- High-order IIR (order ≥ 9)
- Large batch processing
6. DSP Effects
Equalizer
| Parameter | Format |
|---|
--equalizer or --eq | <freq(Hz)>:<gain(dB)>:<Q>,... |
# Three-band EQ
--equalizer "60:1.0:2,1000:-0.5:1,8000:0.3:3"
Harmonic Saturation
| Parameter | Format |
|---|
--harmonics | <type>,<amount> |
Types: tanh, poly, softclip, fullwave, tape
--harmonics tanh,0.3
--harmonics tape,0.5
Dynamic Processing
| Parameter | Description |
|---|
--lal | Look-ahead limiter |
--adaptive | Adaptive parameter adjustment |
--apo | Anti-popping overflow filter |
Loudness Normalization
| Parameter | Description |
|---|
--lufs V | Loudness normalization target (dB LUFS) |
--rg | Enable ReplayGain normalization |
--lufs -16 # normalize to -16 LUFS
--rg # normalize by ReplayGain tags
7. Stereo & Spatial Audio
| Parameter | Description |
|---|
--auto-pan | Automatic pan correction |
-target-width V | Target stereo width |
-stereoexpander V | Stereo expander |
--hrtf | HRTF spatial audio rendering |
--DXD | DXD output mode |
Stereo Expansion
# Expand stereo width to 150%
-stereoexpander 1.5
# Auto pan correction + target width
--auto-pan -target-width 0.8
8. Audio Encoding Formats
| Parameter | Description |
|---|
--quad N | DSD channel count |
--dst [on/off] | DST compression toggle |
--dst-compression N | DST compression level (0–9) |
9. Metadata
| Parameter | Example |
|---|
--artist "Name" | --artist "Ludwig van Beethoven" |
--title "Track" | --title "Symphony No.5" |
--album "Album" | --album "Complete Symphonies" |
--genre "Genre" | --genre "Classical" |
--year YYYY | --year 2024 |
--label "Label" | --label "Deutsche Grammophon" |
--composer "Name" | --composer "Beethoven" |
--conductor "Name" | --conductor "Karajan" |
--barcode "CODE" | --barcode "028947757823" |
--isrc "CODE" | --isrc "DEF059003211" |
10. Analysis Reports
| Parameter | Description |
|---|
--report | Generate text analysis report |
-pdfrp | Generate PDF analysis report (with spectrogram) |
--noise-profiling | Noise distribution analysis |
--spectrogram | Spectrogram generation |
--stats | Data statistics |
11. Quantization & Dither
| Parameter | Description |
|---|
--dither TYPE | Dither type |
Dither Types
8 dither algorithms supported:
| Type | Description |
|---|
rect | Rectangular PDF dither |
tri | Triangular PDF dither |
shaped | Noise-shaped dither |
gauss | Gaussian dither |
rpdf | Rectangular probability density function |
tpdf | Triangular probability density function |
ns | Noise-shaped dither (high order) |
none | No dither |
12. User Presets
| Parameter | Description |
|---|
--preset-load NAME | Load a saved user preset |
--preset-save NAME | Save current parameters as a preset |
--preset-list | List all saved presets |
13. Dpdo DSP
| Parameter | Description |
|---|
--bass V | Dpdo DSP bass enhancement |
--treble V | Dpdo DSP treble adjustment |
--pbe V | Dpdo DSP parametric EQ |
--eq .... | Dpdo DSP EQ |
--crossfeed V | Dpdo DSP crossfeed |
14. Pipe & Recording
| Parameter | Description |
|---|
--pipe | Pipe output mode (stdin/stdout) |
--record | Recording mode |
-format TYPE | Recording output format |
See Batch & Recording for details.