juce-audio-processor
Advanced tools
A high-performance native audio processor built with JUCE for Node.js and Electron applications, specifically designed for DJ software and real-time audio processing.
Before installing this package, you MUST install the following software:
Windows:
macOS:
xcode-select --installLinux:
sudo apt-get install build-essentialC:\JUCE (Windows) or /usr/local/JUCE (macOS/Linux)Make sure you have installed all the required software above.
For Node.js Applications:
npm install juce-audio-processor
For Electron Applications:
npm install juce-audio-processor
# The package will automatically detect Electron and build accordingly
# Test in Node.js
npm test
# Test in Electron
npm run test:electron
Solution: Install CMake and add it to your PATH
brew install cmakesudo apt-get install cmakeSolution: Install Visual Studio with C++ build tools
Solution: Download and install JUCE framework
C:\JUCE (Windows) or /usr/local/JUCE (macOS/Linux)CMakeLists.txt if neededSolution: Check all prerequisites are installed
# Check CMake
cmake --version
# Check Visual Studio (Windows)
where cl
# Check GCC (macOS/Linux)
gcc --version
const JUCEAudioProcessor = require("juce-audio-processor");
// Create a new processor instance
const processor = new JUCEAudioProcessor();
// Check if processor is initialized
if (processor.isInitialized()) {
console.log("Processor is ready!");
}
// Configure effects
processor.setVolume(0.8); // Set volume (0.0 to 1.0)
processor.setFlangerEnabled(true); // Enable/disable flanger
processor.setFlangerRate(0.5); // Set flanger rate (0.0 to 1.0)
processor.setFlangerDepth(0.3); // Set flanger depth (0.0 to 1.0)
processor.setFilterCutoff(1000); // Set filter cutoff frequency (Hz)
processor.setFilterResonance(1.2); // Set filter resonance (0.0 to 2.0)
processor.setPitchBend(2.0); // Set pitch bend in semitones
processor.setJogWheelPosition(0.5); // Set jog wheel position (0.0 to 1.0)
// Process audio
processor.processAudio(audioBuffer);
const { app, BrowserWindow } = require("electron");
const JUCEAudioProcessor = require("juce-audio-processor");
app.whenReady().then(() => {
try {
const processor = new JUCEAudioProcessor();
if (processor.isInitialized()) {
console.log("Audio processor ready in Electron!");
// Configure your audio processing here
}
} catch (error) {
console.error("Failed to initialize audio processor:", error);
}
});
new JUCEAudioProcessor() - Creates a new audio processor instanceisInitialized() - Returns true if the processor is ready to usesetVolume(volume) - Set master volume (0.0 to 1.0)setFlangerEnabled(enabled) - Enable or disable flanger effect (boolean)setFlangerRate(rate) - Set flanger rate (0.0 to 1.0)setFlangerDepth(depth) - Set flanger depth (0.0 to 1.0)setFilterCutoff(cutoff) - Set low-pass filter cutoff frequency in HzsetFilterResonance(resonance) - Set filter resonance (0.0 to 2.0)setPitchBend(semitones) - Set pitch bend in semitonessetJogWheelPosition(position) - Set jog wheel position (0.0 to 1.0)processAudio(buffer) - Process audio buffer (implementation depends on your audio system)# Clean build directory
npm run clean
# Build for Node.js
npm run build:node
# Build for Electron
npm run build:electron
# Build for both runtimes
npm run build
# Auto-detect runtime and build
npm run build:auto
# Rebuild (clean + build)
npm run rebuild
# Ensure Visual Studio is installed
npm run build:electron
# Ensure Xcode command line tools are installed
xcode-select --install
npm run build:electron
# Install build essentials
sudo apt-get update
sudo apt-get install build-essential cmake
npm run build:electron
# Test in Node.js
npm test
# Test in Electron
npm run test:electron
# Run example
npm run example
The package includes comprehensive debug logging. Check these files:
juce_debug.log - C++ and JavaScript logselectron_debug.log - Electron-specific logsProblem: Native addon not found Solution:
npm run clean
npm run build:electron
Problem: Runtime mismatch between Node.js and Electron Solution: Rebuild for the correct runtime
npm run build:electron
Problem: Missing node-addon-api dependency Solution:
npm install node-addon-api
npm run rebuild
Problem: CMake not installed or not in PATH Solution:
brew install cmakesudo apt-get install cmakeProblem: JUCE framework not installed Solution:
C:\JUCE (Windows) or /usr/local/JUCE (macOS/Linux)CMakeLists.txt if neededEnable verbose logging:
# Set environment variable
set DEBUG=juce-audio-processor:*
# Run with debug output
npm run test:electron
juce-audio-processor/
├── src/
│ ├── binding.cpp # N-API bindings
│ ├── juce_audio_processor.h # JUCE processor header
│ ├── juce_audio_processor.cpp # JUCE processor implementation
│ ├── audio-processor-mock.js # Mock implementation
│ ├── audio-processor-child.js # Child process for Electron
│ └── audio-processor-wrapper.js # IPC wrapper
├── test/
│ ├── test.js # Node.js tests
│ ├── electron-test.js # Electron tests
│ └── electron-test.html # Electron test UI
├── scripts/
│ └── build-auto.js # Auto-build script
├── build/ # Build output directory
├── CMakeLists.txt # CMake configuration
├── package.json # NPM package configuration
├── index.js # Main entry point
└── README.md # This file
| Package Version | Node.js | Electron | JUCE | CMake |
|---|---|---|---|---|
| 1.0.15+ | 14.0.0+ | 37.0.0+ | 6.0+ | 3.15+ |
Note: This package is designed to work with any Node.js version 14+ and any Electron version 37+. The build system automatically detects and builds for the correct runtime version.
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)git clone https://github.com/iagomartins/juce-audio-processor.git
cd juce-audio-processor
npm install
npm run build
npm test
This project is licensed under the MIT License - see the LICENSE.md file for details.
Made with ❤️ for the audio development community
FAQs
JUCE audio processor native addon for Node.js applications
We found that juce-audio-processor demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.