Skip to content

About

An iOS port of LastWave, based on the original macOS version.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,235 Commits

Folders and files

Repository files navigation

LastWave Banner

LastWave for iOS

A YouTube Music client for iPhone and iPad, built with Flutter. Lossless addons, synced lyrics and more.


Telegram Support Telegram Channel Discord Community


Overview

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.


Features

Playback

  • Stream any track or video from YouTube Music
  • Background audio playback & system media controls
  • High-res audio downloads with embedded metadata & .lrc lyrics
  • Download & cache for offline listening
  • Skip silence & sleep timer

Audio

  • Bit-Perfect audio output (direct hardware bypass)
  • Lossless FLAC addon support (up to 24-bit Hi-Res)
  • 15-band Parametric Equalizer & AutoEQ presets
  • Audio normalization (ReplayGain / LUFS)
  • Real-time tempo & pitch control

Lyrics & Discovery

  • Live millisecond-synchronized lyrics (LRCLIB)
  • Lyrics romanization for non-Latin scripts (Japanese, Korean, etc.)
  • Multi-language lyrics translation
  • Spotify Canvas & animated video backgrounds
  • Personalized quick picks, mood radios & genre discovery
  • Search songs, albums, artists, videos, and playlists

Library & Account

  • Full library management & offline cached library
  • Spotify Integration (Account login, Liked Songs sync & deep links)
  • Import public playlists from Spotify & Apple Music
  • YouTube Music account login & bidirectional sync
  • Local & cloud playlists with custom reordering
  • Custom audio tag editing & cover art selection

Social

  • Listen together with friends in real-time
  • Built-in Last.fm scrobbler with background tracking
  • Safe Discord Rich Presence with live album art
  • Export and share lyrics as aesthetic quote cards

Interface

  • Clean WinUI & Fluent design interface
  • Real-time acrylic blur and backdrop refraction
  • Dynamic color theming + preset palettes
  • Light, Dark, and Pure Black modes
  • Global media hotkeys & mini-player

Getting Started

Installation

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

Quick Setup

  1. Install the signed build on your device.
  2. (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.
  3. Start streaming music, exploring smart radios, and enjoying synced lyrics.

Building from Source

Prerequisites

  • 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, see pubspec.yaml)

Build Instructions

# 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-codesign

lib/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.


Support the Project

If LastWave has been useful to you, consider supporting its development.

Buy Me A Coffee UPI (Buy Me A Chai) GitHub Sponsors

Acknowledgements

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

Contributors

LastWave wouldn't be possible without our incredible community of contributors. Thank you for making it better every day!

Contributors


Disclaimer

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.

About

An iOS port of LastWave, based on the original macOS version.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages