Skip to content

Latest commit

 

History

History
134 lines (100 loc) · 4.95 KB

README.md

File metadata and controls

134 lines (100 loc) · 4.95 KB
Raw

JamesDSP (Cross-platform Audio Effect / Digital Signal Processing library)

GUI is based on Omnirom DSP Manager and able to run on most Android devices from 5 to 10 include AOSP, Cyanogenmod, Huawei(arm64), LineageOS, Samsung and recent HTC. This app include many cool features.

This repo is a Android variant of JamesDSP, JDSP4Linux uses core library from current repo.

Features:

  1. Multiband, multiresolution dynamic range compander --> A highly tunable multiband dynamic range booster/reducer

  2. Auto Bass Boost --> Frequency detecting bass boost. Effect detect interesting frequency, and adjust gain, bandwidth and cut-off frequency arccordingly

  3. Reverb --> Progenitor 2 (Complicated IIR network)

  4. Interpolating FIR Equalizer and IIR Equalizer -->Both FIR and IIR equalizer yield flat response when the gain is uniform, unlike some competitors

  5. Partitioned Convolver (Auto segmenting convolution) --> Support mono, stereo, full/true stereo(LL, LR, RL, RR) IR

  6. Live programmable DSP --> A effect that can compile EEL code into opcode, and do processing base on the compiled code. The EEL virtual machine had pre-built tons of advanced math routines and DSP function. Including: Basic C String manipulation functions, Linear algebra solver(Least square, inv(), pinv()), Mathematical optimization(linprog(), quadprog(), lsqlin()), polynomial roots solver(roots()), spectral processing(Short-time Fourier Transform), Polyphase filterbank(Constant Q Transform), multi-purpose IIR / FIR filter designer(eqnerror() / firls()), IIR Subbands transform, Direct form FIR filter, Fractional delay line, Polyphase resampler, real time 1D convolution, Autoregressive Burg estimator, simple peak finding algorithm.

More details:EEL2 open source variant

  1. Stereo Widen --> Algorithm detect stereo phase relation in a few spectral region, and enhance the stereo soundstage without affect vocal integrity

  2. Crossfeed --> Include traditional BS2B mode and convolution-based HRTF

  3. Vacuum tube modelling --> Second harmonic generator

  4. Viper DDC (Cascaded Second-Order Sections Form II IIR filterbank)

Supported bit depth:
# bits Status
8 Unsupported
16 Supported
24(3bInt) Supported
24(4bInt) Supported
32(Int) Supported
32(Float) Supported

Important

FAQ

1. Computation datatype?

A: Float32.

2. What is convolver?

A: Convolver is a effect apply convolution(a mathematical operation) on input signal, that perfectly apply user desired response on music, it could simulate physical space.

Effect itself require audio file(.wav/.irs/.flac) to become impulse response source.

For more info: Convolution and Convolution reverb

3. Installation method

A: Advanced method(Manual installation)

Effect may get unloaded by Android system if no audio stream for while.

audio_effects.conf is a file specified for system to load effect using known UUID.

  1. you need to add
jdsp {
 path /system/lib/soundfx/libjamesdsp.so
}

under

bundle {
 path /system/lib/soundfx/libbundlewrapper.so
}

AND

jamesdsp {
 library jdsp
 uuid f27317f4-c984-4de6-9a90-545759495bf2
}

under

effects {
  1. copy libjamesdsp.so to /system/lib/soundfx
  2. Reboot
  3. Install APK

B: Automatic installation(Supported up to Android Pie)

Join Telegram group JDSP and V4A group to receive latest update. Methods:

  1. Copy zip package to your phone, reboot to custom recovery, install package, reboot, done.
  2. Get Magisk manager to install JDSP. Now work on most Android device from Lollipop to Pie

Download Link

  1. See my project release page

Screenshot

  1. Equalizer screenshot(Dark theme)
  2. Convolver screenshot(Idea theme)

Important

Modify SELinux is not required(in most case), let your device become safer. Also, it's good to customizing your own ROM or even port ROM with JamesDSP. Some device does require SELinux workaround to work correctly

Contact

Better contact me by email. Send to james34602@gmail.com

Terms and Conditions / License

The engine frame is based on Antti S. Lankila's DSPManager.

Credit

  1. Joseph Young (Provider of dynamic range compander logic and varies impulse responses)
  2. Christopher Blomeyer (Very patient app tester and inspiring me bit depth issue)
  3. ahrion (Making installation tools)
  4. Zackptg5 (Making installation tools)

More Credit

  1. Matlab, a great tool that do all sort of modelling