8000 GitHub - makalin/groovdeck: GroovDeck is an open-source hardware + software groove production station inspired by the Akai MPC One, built around a Raspberry Pi with a touchscreen. It features a real-time audio player, mixer, and sequencer with an Ableton Live-style workflow β€” fully designed for standalone music production. Β· GitHub
[go: up one dir, main page]

Skip to content
makalinPublic

About

GroovDeck is an open-source hardware + software groove production station inspired by the Akai MPC One, built around a Raspberry Pi with a touchscreen. It features a real-time audio player, mixer, and sequencer with an Ableton Live-style workflow β€” fully designed for standalone music production.

Resources

Stars

10 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

7 Commits

Folders and files

8000
NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ›οΈ GroovDeck

GroovDeck is an open-source hardware + software groove production station inspired by the Akai MPC One, built around a Raspberry Pi with a touchscreen. It features a real-time audio player, mixer, sequencer, live looper, and effects processor with an Ableton Live-style workflow β€” fully designed for standalone music production.


🎯 Project Goals

  • βœ… Touch-based UI for intuitive beatmaking and looping
  • βœ… Real-time low-latency audio engine
  • βœ… MIDI controller & sample pad support
  • βœ… Track-based session view (Ableton-style)
  • βœ… Scene and clip launching
  • βœ… Time-stretching and pitch shifting
  • βœ… Full offline standalone operation
  • βœ… Live looping and recording
  • βœ… Step sequencer with pattern programming
  • βœ… Real-time effects processing
  • βœ… Multi-source audio mixing

🧱 Architecture Overview

Layer Technology Purpose
OS Raspberry Pi OS (64-bit Lite) Lightweight and audio-friendly environment
Core Audio C++ / JUCE, RtAudio, RtMidi Real-time audio playback & MIDI control
DSP rubberband, libsamplerate High-quality pitch & tempo manipulation
UI LVGL or Flutter (TBD) Custom touchscreen GUI
Effects JUCE DSP Real-time audio effects processing
Sequencer Custom C++ Pattern-based step sequencing
Live Looper Custom C++ Real-time loop recording & playback

πŸ›  Hardware Requirements

  • Raspberry Pi 4 or CM4 (2GB+ RAM)
  • 7" Official Raspberry Pi Touchscreen
  • USB Audio Interface (low-latency)
  • SD card (32GB+ recommended)
  • Optional:
    • MIDI controller / pad (USB or DIN)
    • GPIO or USB knob/slider for extra control

πŸš€ Getting Started

# Clone repo
git clone https://github.com/makalin/groovdeck.git
cd groovdeck

# Build instructions
./scripts/setup.sh

πŸ“¦ Dependencies

  • JUCE (GPL edition)
  • RtAudio / RtMidi
  • rubberband
  • libsamplerate
  • ALSA / JACK (Linux audio backend)
  • LVGL or Flutter SDK (UI engine TBD)

🎡 Features

Core Audio Engine

  • Multi-track playback
  • Per-track volume & mute
  • Loop triggering & launching
  • Real-time time-stretching
  • MIDI pad & controller input
  • Scene sequencer
  • Project/session saving

Live Looping System 🎀

  • Real-time audio recording
  • Seamless loop playback
  • Loop length adjustment (1-30 seconds)
  • Loop start/end point editing
  • Loop gain control
  • Loop reversal
  • Multiple loop layers
  • Live overdubbing

Step Sequencer πŸ₯

  • 16-step pattern sequencer
  • Variable tempo (60-200 BPM)
  • Adjustable step count (4-16 steps)
  • Pattern randomization
  • Pattern shifting (left/right)
  • Visual step grid interface
  • Real-time pattern editing
  • Velocity control per step

Effects Processing πŸŽ›οΈ

  • Reverb with room size, damping, wet/dry controls
  • Delay with time, feedback, and mix parameters
  • Filter with cutoff and resonance
  • Distortion with drive and mix controls
  • Real-time parameter adjustment
  • Effect bypass functionality
  • Effects chain processing

Advanced Features

  • Multi-source audio mixing
  • Real-time effects processing
  • Live performance capabilities
  • Pattern-based composition
  • Loop manipulation tools
  • Professional-grade audio engine

πŸ—οΈ Project Structure

groovdeck/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ MainApplication.h/cpp          # Main application entry point
β”‚   β”œβ”€β”€ AudioEngine.h/cpp              # Core audio processing engine
β”‚   β”œβ”€β”€ EffectsProcessor.h/cpp         # Real-time effects processing
β”‚   β”œβ”€β”€ LiveLooper.h/cpp               # Live loop recording & playback
β”‚   β”œβ”€β”€ Sequencer.h/cpp                # Step sequencer engine
β”‚   β”œβ”€β”€ MainComponent.h/cpp            # Main UI component
β”‚   β”œβ”€β”€ EffectsPanel.h/cpp             # Effects control interface
β”‚   β”œβ”€β”€ LiveLoopPanel.h/cpp            # Live looping interface
β”‚   └── SequencerPanel.h/cpp           # Sequencer control interface
β”œβ”€β”€ scripts/
β”‚   └── setup.sh                       # Build setup script
β”œβ”€β”€ CMakeLists.txt                     # CMake build configuration
β”œβ”€β”€ .gitignore                         # Git ignore patterns
└── README.md                          # This file

🎨 UI Components

Transport Controls

  • File loading and playback
  • Volume control
  • Loop toggle for file playback

Effects Panel

  • Reverb, Delay, Filter, Distortion controls
  • Real-time parameter adjustment
  • Effect bypass toggles

Live Loop Panel

  • Record/Play/Stop/Clear controls
  • Loop length and gain adjustment
  • Loop start/end point editing
  • Status display

Sequencer Panel

  • 4x4 step button grid
  • Tempo and step count controls
  • Pattern manipulation tools
  • Start/Stop/Reset functionality

πŸ’‘ Inspiration

  • Akai MPC One
  • Ableton Live Session View
  • Novation Circuit
  • Mod Devices Pedals
  • Boss RC-505 Loop Station
  • Arturia BeatStep Pro
  • Native Instruments Maschine

πŸ§‘β€πŸ’» Developer Notes

Audio Architecture

  • Multi-source mixing: File playback, live loops, and sequencer output
  • Real-time processing: All audio sources processed through effects chain
  • Low-latency design: Optimized for live performance
  • JUCE DSP integration: Professional-grade audio processing

Live Looping Engine

  • Buffer-based recording: Efficient memory management
  • Seamless looping: Zero-latency loop transitions
  • Real-time manipulation: Live parameter adjustment
  • Multi-layer support: Multiple simultaneous loops

Sequencer Engine

  • Step-based timing: Precise rhythmic patterns
  • Pattern management: Save, load, and manipulate patterns
  • Real-time control: Live pattern editing
  • MIDI integration: External clock and control support

Effects Processing

  • Modular design: Easy to add new effects
  • Parameter automation: Real-time control
  • CPU optimization: Efficient DSP algorithms
  • Professional quality: Studio-grade audio processing

πŸ“œ License

GroovDeck is licensed under the MIT License. See LICENSE for details.


✨ Contributing

Pull requests are welcome! Ideas, bug reports, or feature requests? Open an issue.

Areas for Contribution

  • Touch UI optimization for Raspberry Pi touchscreen
  • MIDI mapping and controller support
  • Additional effects (chorus, flanger, compressor)
  • Sample library management
  • Project file format and saving
  • Hardware integration for GPIO controls

πŸ“· Screenshots

(Coming soon – UI mockups and build photos)


🎡 Use Cases

Live Performance

  • Loop-based performance: Create layered compositions live
  • Beat making: Program and play rhythmic patterns
  • Effects processing: Real-time audio manipulation
  • Multi-track mixing: Combine multiple audio sources

Studio Production

  • Pattern programming: Create complex rhythmic sequences
  • Loop manipulation: Edit and process recorded loops
  • Effects experimentation: Try different effect combinations
  • Composition sketching: Quick idea capture and development

Educational

  • Music production learning: Understand sequencing and effects
  • Live performance practice: Develop looping skills
  • Audio engineering concepts: Learn about DSP and mixing
  • Hardware integration: Understand embedded audio systems

πŸ“‘ Stay Connected

Follow development on GitHub and contribute to shaping the future of portable open-source beatmaking!

πŸŽ›οΈ GroovDeck - Where Hardware Meets Creativity

About

GroovDeck is an open-source hardware + software groove production station inspired by the Akai MPC One, built around a Raspberry Pi with a touchscreen. It features a real-time audio player, mixer, and sequencer with an Ableton Live-style workflow β€” fully designed for standalone music production.

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0