Smart Guitar Tuner ^v0.1.2

• Custom Tunings — Create, edit, and manage unlimited custom tunings
• Record Your Own Sounds — Record 6 seconds of each string for perfect reference
• Built-in Default Sounds — Ready to use out of the box with standard tuning
• Audio Playback — Loop, pause, seek, and replay recorded sounds
• Re-record Anytime — Update individual strings without redoing everything
• Storage Persistence — Tunings survive app updates and reinstallation

For Users

1. Create a tuning — Tap "Add New Tuning" and enter a name (e.g., "Drop D")
2. Record strings — Select your tuning, tap "Record" for each string, and play your guitar
3. Play back — Use the audio player to listen and verify your recordings
4. Re-record — Not satisfied? Tap "Re-record" to capture a better take

For Developers

Prerequisites: Android Studio Ladybug, Android SDK 24+, JDK 11+

git clone https://github.com/aixandrolab/smart-guitar-tuner-android.git
cd smart-guitar-tuner-android

Build debug APK from Android Studio or via command line.

app/
├── src/main/java/com/example/smart_guitar_tuner_android/
│   ├── MainActivity.kt           # Tuning list management
│   ├── StringTunerActivity.kt    # Per-tuning string management
│   ├── RecordingActivity.kt      # Audio recording (6 seconds)
│   ├── AudioPlayerActivity.kt    # Playback with loop/seek
│   ├── SettingsManager.kt        # File-based tuning storage
│   └── ...
├── src/main/res/                 # Layouts, drawables, values
└── src/main/assets/              # Default string sounds (1_string.wav, etc.)

Storage Location

Documents/smart-guitar-tuner/tuners/[Tuning Name]/
├── string_1.wav
├── string_2.wav
└── ... string_6.wav

• RECORD_AUDIO — Required for recording guitar strings (Android 8.0+)
• MANAGE_EXTERNAL_STORAGE — Required for Android 11+ to ensure tunings survive app updates

The app requests these permissions at runtime with clear explanations.

• Audio Format: PCM 16-bit, 44.1 kHz, mono
• Recording Duration: 6 seconds per string
• Playback Controls: Play/Pause, Stop, Loop, Seek bar
• Persistence: WAV files stored in external storage (Documents directory)

• Language: Kotlin 1.9+
• Minimum SDK: Android 8.0 (API 24)
• UI: Material Design Components
• Audio: AudioRecord, MediaPlayer
• Storage: External Storage (Documents directory)
• License: BSD 3-Clause

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: DISCLAIMER.md