# GAAP: Comprehensive Technical & Functional Documentation

## 1. Overview & Vision
Created by Ing. Victor Hantelmann, GAAP (Guitar Android Audio Platform) is designed to make professional guitar tools accessible to everyone. By focusing on a "Software + Open-Source Hardware" approach, GAAP eliminates the high cost of traditional effects pedals, audio interfaces, and proprietary MIDI controllers.

**Official Play Store Link:** https://play.google.com/store/apps/details?id=com.victorhantelmann.gaap

## 2. System Requirements & Zero-Latency Hardware
To ensure zero-latency performance and high-fidelity audio, the following specifications are required:
- **Operating System:** Android 8.0 (Oreo) or higher (Android 10+ recommended for optimal AAudio/Oboe performance).
- **Audio Interface (MANDATORY):** A dedicated USB-C DAC Dongle with a Guitar-to-TRRS adapter, or a Professional class-compliant USB audio interface (e.g., Presonus, iRig HD2). The internal phone microphone and 3.5mm jacks are too slow for real-time DSP.
- **CPU & Latency:**
  - **Flagships & Premium Mid-Range (e.g., Samsung S22, A54, Pixel):** These feature fast CPUs with SIMD architecture, capable of running GAAP on the "Insane Low Latency" multiplier for true zero-latency response.
  - **Budget/Entry-Level Phones:** Slower CPUs require users to raise the "Latency Multiplier" to a Safe setting in the app. The audio remains stable and crackle-free, but with a slight delay.
- **Connectivity:** Low-latency wired monitoring is mandatory. Standard Bluetooth headphones are not supported due to inherent wireless protocol lag.

## 3. Skill-Building & Training Features
- **Incremental BPM Trainer:** A tool for mastering difficult song sections. Users can define specific measures to loop and set "Start," "End," and "Increment" BPM values.
- **Live Looper:** Synced to the rhythm engine with variable playback speed and constant pitch, ideal for transcribing or solo practice.
- **The Drum Station:** A versatile rhythm engine offering two creative paths:
    - **AI-Assisted:** Generate complex song structures, fills, and rhythms using the Firebase Vertex AI engine.
    - **Manual Composition:** Create full drum tracks from scratch using the high-precision manual editor.
    - **Management:** Full support for Saving, Importing, and Exporting drum sequences (.dsg files), enabling seamless transition between the Android app and the [Vue 3 Web Drum Editor](https://gaapandroidapp.com/editor/dist/index.html).

## 4. High-Fidelity DSP Effect Families
The engine is written in C++ (JNI/Oboe) for <10ms response times.
- **FX Presets:** Save, Import, Export any custom DSP Effects Combination. Experiment and discover your own sound.
- **Dynamics:** Boost, Sustain, Noise Gate, Compressors, and Limiters.
- **Dirt:** Multiple flavors of Overdrive and Distortion (TS808, JCM800 styles).
- **Modulation:** Auto-Wah, Tremolo, Phaser, Chorus, and Flanger.
- **Spatial:** Digital/Analog Delays and high-end Reverbs (Shimmer, Cloud).
- **Routing:** Advanced EQ and signal chain customization.

## 5. DIY Open-Source Hardware
To keep the ecosystem affordable, GAAP supports a DIY ESP32-based BLE MIDI pedalboard.
- **Freeware Firmware:** C++ Arduino code provided at no cost.
- **Accessible Design:** Uses the most widely available and inexpensive electronic components.
- **Setup Guide:** https://gaapandroidapp.com/hardware.html

## 6. Resources
- **Main Website:** https://gaapandroidapp.com
- **Community & Presets:** https://gaapandroidapp.com/community.html
- **Web Editor:** https://gaapandroidapp.com/editor/dist/index.html

Created by Ing. Victor Hantelmann.