A YouTube Music client for iPhone and iPad, built with Flutter. Lossless addons, synced lyrics and more.
LastWave for iOS is the iPhone and iPad port of original LastWave codebase. It shares the Flutter codebase with the desktop app, and its mobile interface follows the design of the Android app, LastWave-Native. See UPSTREAM_NOTICES.md for what was adapted from where.
The port is a work in progress. The feature list below comes from the shared codebase, and not everything on it has been verified on iOS yet. In particular, background playback is declared but still needs on-device testing, and desktop-only items (Bit-Perfect output, system tray, global hotkeys, Discord Rich Presence, mini-player window) do not apply on iPhone or iPad.
|
|
|
|
|
|
There is no App Store release. The GitHub Actions workflow LastWave iOS builds an unsigned .ipa on every push to main; download it from the workflow run's artifacts (kept for 14 days). An unsigned build has to be signed before it will install on a device, for example with Xcode or a sideloading tool. It requires iOS 15 or later.
| Platform | Source |
|---|---|
| iPhone / iPad | This repository (unsigned .ipa from CI, or build from source below) |
| Windows, Linux, macOS | Original desktop releases |
| Android | LastWave-Native |
- Install the signed build on your device.
- (Optional) Open Settings → Audio to configure:
- Equalizer Presets: Apply parametric EQ curves or headphone correction.
- Lossless Addons: Enable the modular addon service for Hi-Res FLAC playback.
- Start streaming music, exploring smart radios, and enjoying synced lyrics.
- macOS with Xcode and CocoaPods installed (iOS builds only run on a Mac)
- Flutter SDK 3.47.9, the version CI uses (Dart
^3.13.3, seepubspec.yaml)
# Clone the repository
git clone https://github.com/Clash-Projects/LastWave-iOS.git
cd LastWave-iOS
# Generate the build-time secrets file (lib/core/env/secrets.g.dart).
# Works without a .env; see .env.example for the optional values.
dart tool/obfuscate_secrets.dart
# Generate and configure the iOS host project
bash tool/prepare_ios.sh
# Install dependencies
flutter pub get
# Build an unsigned release
flutter build ios --release --no-codesignlib/core/env/secrets.g.dart is gitignored, so the app will not compile until the obfuscate_secrets.dart step has run.
Tip
For local development and hot reload, connect a device or start a simulator and run flutter run.
If LastWave has been useful to you, consider supporting its development.
LastWave for iOS builds on the original LastWave codebase and adapts UI from LastWave-Native, both by Clash-Projects. It is made possible thanks to these open-source projects:
- media_kit — Audio playback engine powered by libmpv
- Limusic — InnerTube client registry & stream resolution fast path
- LRCLIB — Real-time millisecond-synchronized lyrics database
- NewPipe — Signature decipher patterns & extraction logic
- fluent_ui — WinUI & Fluent design system for desktop
LastWave wouldn't be possible without our incredible community of contributors. Thank you for making it better every day!
LastWave is an open-source, non-commercial application developed strictly for educational and research purposes.
- No Affiliation: This project is not affiliated with, funded, authorized, endorsed by, or in any way associated with Google LLC, YouTube, YouTube Music, Spotify, Apple Inc., Last.fm, or any of their subsidiaries.
- Content Delivery: LastWave does not host, store on private servers, or distribute copyrighted media. All playback streams and metadata are resolved directly from public endpoints.
- Trademarks: All product names, logos, trademarks, and registered trademarks belong to their respective owners.

