Usage Guide

Usage Guide

Getting Started

1. Install: Compile and install the APK on your Android device
2. Permissions: Grant microphone, notification, and storage permissions
3. Navigate: Use the bottom navigation to access different features
4. Effects: In the "Effects" tab, adjust parameters in real time
5. Presets: Save your favorite configurations and mark as favorites
6. Export/Import: Share presets via JSON files
7. Order: Reorder effects by dragging and dropping
8. Background: Enable background processing in settings
9. Tooltips: Long-press controls to see explanations
10. Reset: Use reset buttons to restore default values
11. Test: Speak or play an instrument into the microphone
12. MIDI Learn: Enable MIDI in settings and map external controls to effect parameters
13. Automation: In the "Effects" tab, use automation controls to record and playback parameter changes

Advanced Settings

• Oversampling: Enable in settings for better quality (more CPU usage)
• Background Audio: Keeps processing active with screen off
• State Recovery: Settings are automatically restored
• Permissions: Verify all required permissions are granted

Preset System

• Save presets: Store your configurations with custom names
• Load presets: Quickly access your saved configurations
• Delete presets: Remove presets you no longer use
• Export/Import: Share presets via JSON files
• Favorites: Mark presets as favorites for quick access
• Filter: View only favorites or all presets
• Persistence: Presets are automatically saved to device
• Effect order: Presets also save the custom effect order

Customizable Effect Order

• Drag-and-drop: Reorder effects by dragging and dropping
• Default order: Gain → Distortion → Chorus → Flanger → Phaser → Delay → Reverb
• Persistence: Order is automatically saved
• Real-time: Changes applied instantly

Latency Adjustment

ToneForge allows you to choose between different latency modes, adapting audio processing for better performance or greater stability:

• Low Latency: Prioritizes fast response, ideal for live performance
• Balanced: Compromise between latency and stability, recommended for general use
• Stability: Prioritizes quality and robustness, ideal for recording

The selection can be made in the app settings, with detailed information, latency estimates, and recommendations displayed in the interface.

The selected mode automatically adjusts buffer size, sample rate, and oversampling, optimizing audio for the chosen profile. The choice is saved and automatically restored when opening the app, including after background use.

Note: Low latency mode depends on Android device support. On older devices, it may not be available or have limitations.

Tips for Best Performance

1. Use headphones: Reduces feedback and improves monitoring
2. Check permissions: Ensure all required permissions are granted
3. Background mode: Enable for continuous processing
4. Oversampling: Use for better quality when CPU allows
5. Preset management: Organize your configurations
6. MIDI integration: Use external controllers for hands-free control
7. Automation: Record parameter changes for dynamic performances

---

See Features for a complete list of available features.