Skip to content

Repository files navigation

Tune Tangler

Yet another music looper app

📚 Documentation

🧩 App capabilities

  • Recording: microphone/USB (device-dependent), auto-gain/echo-cancel/noise-suppress when supported
  • Import: pick an audio file for a track
  • Playback: start/stop/pause/resume, loop modes (single/loop), seek, range playback (start/end), time/position
  • Live control: volume, balance (pan), speed (0.5–2.0)
  • Track management: rename (including emoji), shortcut keys, move/swap recordings, delete recording
  • Sharing: raw file or “processed” (trim/vol/pan/speed)—processed export on Android (MediaCodec + Sonic); on other platforms the raw file is shared when processing would be required
  • Layout: configurable grid (rows/columns), lazy loading for performance
  • Themes: light/dark/system, accent color
  • Localization: EN/PL (switch at runtime)
  • Permissions: microphone, notifications (Android), file access where applicable
  • Profiles: save/load/delete setting profiles
  • Project export/import: save the whole project (grid, all tracks, recordings) to ZIP and load it later with full validation — main menu → Save project / Load project (guide)

🚀 Quick start

🔧 One-time configuration

Do these once per machine or repository; see each doc for details.

Topic Doc
Developer machine (Flutter, SDK, make dev-setup) Setup, Quick start
Optional pre-commit hook Git hooks
CI secrets overview Workflows
APK/AAB release signing Release signing
F-Droid (GitLab + fdroiddata fork) F-Droid

🛠️ Development

📋 Project

🔍 How to find things

🆕 New developer

  1. 📱 Installation — basics
  2. 🔧 Setup — one-time environment
  3. ⚡ Quick start — first successful run

🔧 Day-to-day development

  1. 🔨 Makefile — analyze, test, run
  2. 🎨 Icon generation — regenerate assets
  3. 🎣 Git hooks — optional local checks

🚀 Release and deployment

  1. 🚀 Workflows — what runs on main and manual release
  2. 🔐 Release signing — one-time keystore + GitHub secrets
  3. 📦 F-Droid — one-time GitLab/fork setup, then per-release workflow
  4. 📝 Store listings & screenshots — Fastlane text + make screenshots → metadata/android/…/images/

📚 Need help? See Issues or Discussions.

📄 License

MIT License

Used by

Contributors

Languages