prawel.pl
Menu
My work

Your music & radio · iPhone & iPad

WavVv Music Player

Bring your audio files, personal playlists, and internet radio together. Your music, with every detail in place.

  • Swift
  • SwiftUI
  • iOS
  • AVFoundation
View on the App Store
WavVv Music Player: Now Playing with album artwork, filename, audio quality badges, and playback controls in dark mode

The product

Built around the job.

Give your music collection a home on iPhone and iPad. Add songs from Files or scan a folder, then browse your library by song, album, playlist, or favorite. Build mixes with your own cover art, save the radio stations you love, and see the quality of the file you are playing. Fix titles, artists, and artwork directly in writable originals, without re-encoding the audio. A subtle artwork-colored background, synchronized lyrics, and light and dark appearances make the player feel at home with your collection. No account is required, and music available on your device is ready for offline listening.

Role
Product design & iOS engineering
Release
2026
Status
Released
  • Your own music files
  • Personal playlists & radio
  • No account required

Privacy by design

Your data stays yours.

No account, advertising, or analytics. Your music stays in the folders you choose; radio requests connect to the services you use.

Read the full privacy details

WavVv Music Player does not require an account and has no advertising, usage analytics, or tracking SDKs.

Your music and library

The app keeps its library, playlists, favorites, station list, and lyrics cache on your device. Music remains in the file locations you choose. Saving metadata changes writes supported tags and artwork to the writable original file.

File providers

Folders managed by iCloud Drive or another file provider may download or synchronize files through that provider. Its own privacy policy applies.

Radio and lyrics

Playing a radio station connects to the stream URL you choose and any playlist or redirect destinations it provides. Those services receive ordinary connection information, including your IP address.

System services

Artwork selection, file access, and AirPlay use the relevant Apple or file-provider services. The app does not upload your music library or audio files to prawel.pl.

Product tour

Open any screenshot to view the original at full size.

WavVv Music Player: Now Playing with album artwork, filename, audio quality badges, and playback controls in dark mode Your music, front and center WavVv Music Player: Songs library in light mode with album covers, yellow playback controls, and the mini player Browse your own music files WavVv Music Player: Now Playing showing the current file’s audio format, bit depth, sample rate, and channel information Know what you are listening to WavVv Music Player: Playlists in light mode with custom cover images and the New Playlist action Make every mix your own WavVv Music Player: Radio stations in dark mode with custom covers and saved stream URLs Keep your favorite stations together WavVv Music Player: Metadata editor in light mode with album artwork and editable file tags Put the right details in the file WavVv Music Player: Now Playing in light mode with a subtle background drawn from the album artwork A lighter way to listen WavVv Music Player: Songs library in dark mode with album artwork and yellow play and shuffle controls Your library after dark

Capabilities

What it handles.

Each capability earns its place by removing effort, reducing ambiguity, or making the product safer to rely on.

  • Add individual audio files or scan folders and subfolders while keeping files in their original location

  • Create playlists, choose custom cover images, and arrange songs in your preferred order

  • Save HLS, direct MP3/AAC streams, and M3U/PLS station links with names and custom artwork

  • Browse Songs, Albums, Playlists, and Favorites; search by title, artist, album, or filename

  • Play supported FLAC, MP3, M4A, AAC, WAV, and AIFF files, including offline files stored on your device

  • See format, sample rate, and channels in Now Playing, with bitrate and bit depth where available

  • Edit titles, artists, albums, artwork, and other supported tags in writable original files without re-encoding audio

  • Follow embedded or local LRC/SRT lyrics, with synchronized lines when available

  • Keep listening in the background, use lock-screen controls, and send audio through AirPlay

  • Use queue controls, repeat, and shuffle, with native light and dark appearances

  • Browse and play your library and saved stations in CarPlay, with search, queue controls, shuffle, repeat, and favorites

Changelog

What changed.

Product updates, fixes, and behavior changes, listed by version.

  1. 1.0.2

    • Enable CarPlay audio support with Apple's approved entitlement. Browse Songs, Albums, Playlists, Favorites, and Radio from the car, with search, cover artwork, and pagination for large libraries.
    • Use CarPlay Now Playing for playback, shuffle, repeat, favorites, adding the current song to a playlist, and opening the queue or current album. Play All and Shuffle include the entire selected collection.
    • Share the phone's library, stations, and player with CarPlay, including starting the library from CarPlay without opening the phone window.

  2. 1.0.1

    • Restore the current song or radio station, playback position, queue, shuffle, and repeat after relaunch. Playback restores paused.
    • Edit the play queue: reorder upcoming songs with drag handles, remove individual entries, clear upcoming songs, and save the queue as a playlist.
    • Browse artists and their albums and songs, plus Recently Played, Most Played, and Never Played collections. Listening history stays on the device and survives rescans.
    • Set a sleep timer for 15, 30, 45, 60, or 90 minutes, or stop at the end of the current song. View, replace, or cancel the active timer from Now Playing.
    • Export and restore library backups containing library information, playlists and covers, favorites, listening history, and radio stations. Restore previews and merges entries without duplicating existing items; original audio files must be backed up separately.
    • Reconnect restored folders and files while retaining song identities, favorites, listening history, and playlist order.
    • Undo the removal of an unavailable song, including its favorite status and playlist positions, from the notice or Settings.
    • Automatically reconnect radio streams after failures or prolonged buffering, with connection status in Now Playing and a manual retry when automatic attempts are exhausted.
    • Group albums by album artist, falling back to track artist, and play them in disc and track order. Untagged songs use natural filename ordering.
    • Prepare the next local audio file before the current song ends to support gapless transitions. Audible continuity still depends on the codec, encoder padding, file availability, and output route.
    • Keep the interface responsive during large imports and rescans by moving library matching, reconciliation, metadata processing, and save preparation off the main thread, with throttled progress updates.
    • Preserve favorites, listening history, playlist edits, and unavailable-song removals made while a scan is running.
    • Improve large-text layouts for song rows, playlist titles, artwork controls, collection playback buttons, and the mini player.
    • Expand VoiceOver support with the two-finger double tap for playback, spoken and adjustable playback position, seek actions, queue reordering, and radio and sleep-timer status.
    • Add keyboard shortcuts for playback, dismissing player panels, and saving or cancelling playlist and station edits.
    • Strengthen Increased Contrast, Reduce Motion, and Reduce Transparency support across playback, library notices, and lyrics.
    • Keep library notices and Undo available while VoiceOver or Switch Control is active, announce playlist errors and backup results, and let lyrics open without automatic scrolling.
    • Tapping a playlist tile opens one playlist screen; removed the extra disclosure arrow and duplicate navigation.
    • Queue drag operations use song identities so a changing queue cannot redirect a move to the wrong row.
    • Prevent cancelled scans or failed save preparation from replacing the saved library, and prevent closed file access from being reactivated during app lifecycle changes.

  3. 1.0.0

    • Initial release. Native iPhone and iPad app for iOS 17 and later, with no account or sign-in required.
    • Add individual audio files, select multiple files, or scan a folder and all its subfolders through Files. Open audio shared with Wavvv from other apps.
    • Play music from its original location without copying it into a separate managed library. Support local storage, iCloud Drive, and compatible file providers; offline playback requires files to be available on the device.
    • Access Wavvv's Documents folder through Files and Finder file sharing.
    • Browse songs and albums, mark favorites, sort the library, and search songs, artists, albums, filenames, playlists, and saved radio stations. Album search results open the complete album.
    • Read embedded metadata and cover artwork, with TagLib-based metadata reading and an AVFoundation fallback. Repair supported legacy Polish text-encoding errors in library text without changing source tags.
    • Save configured folders and individual files, access bookmarks, metadata, artwork thumbnails, and favorites across launches. Reimporting the same path refreshes its metadata while preserving identity and favorites.
    • Manage sources in Settings: rescan one or all sources, inspect song counts and scan issues, reconnect moved folders or files, and remove a source from future scans.
    • Reconcile deleted songs after complete folder scans while retaining entries from unavailable or incomplete scans. Report unsupported or broken audio without discarding valid imports.
    • Locate moved songs from their saved folder or nearest available parent. Report unavailable files and remove stale entries from the library, playlists, and queue when playback cannot open them.
    • Remove songs from the library without deleting their original audio files.
    • Play supported MP3, M4A/AAC/ALAC, WAV, AIFF, and FLAC files, including lossless audio where supported by iOS and the file's codec.
    • Play, pause, seek, skip tracks, shuffle, repeat one song or the queue, and play or shuffle a collection.
    • View the play queue and add songs with Play Next or Play Last.
    • Keep playback controls available while browsing with a mini player and an expandable Now Playing screen that can be minimized or swiped down without stopping playback.
    • Display cover artwork, an artwork-colored background, song details, a selectable filename, and animated playback indicators.
    • Show file-quality badges for format, sample rate, channels, lossy bitrate, and lossless bit depth when available.
    • Listen in the background, use lock-screen and Control Center playback controls, adjust system volume, and select an AirPlay output.
    • Handle audio interruptions and headphone disconnection.
    • Create, rename, and delete playlists; select songs, reorder or remove them, and play or shuffle each playlist.
    • Choose custom playlist covers from Photos or Files, or use artwork from the playlist's songs. Save covers for offline use.
    • Add songs to playlists from song menus and Now Playing. Preserve playlist membership, song order, artwork, and favorites across launches.
    • Save stations with a name, stream URL, and optional custom cover from Photos or Files; edit, delete, and browse stations in name order.
    • Support HLS streams, direct MP3/AAC streams, and M3U/PLS station links over HTTP or HTTPS.
    • Play radio through the shared player, background audio, AirPlay, and lock-screen controls, with a live indicator, station navigation, and changing track information when supplied by the stream.
    • Store station details and artwork locally. Radio playback requires a network connection.
    • Edit title, artist, album, album artist, date, genre, track and disc numbers, composer, comments, additional tags, and embedded artwork.
    • Write supported MP3, FLAC, and M4A metadata changes to the original file without re-encoding audio, preserving format-specific tags, favorites, and playlist membership.
    • Coordinate file access, verify edits before atomic replacement, and report read-only, unavailable, unsupported, or externally changed originals.
    • Refresh saved library metadata when opening the editor or playing older entries, including missing audio-quality information.
    • Read neighboring LRC, SRT, and TXT lyric files and supported embedded lyrics, including timestamped lyrics inside audio tags. Neighboring files require access to the containing folder.
    • Display synchronized lyrics with the current line highlighted, tap a line to seek, scroll manually, and use Follow Song to resume following playback.
    • Support plain lyrics, UTF-8 and UTF-16 lyric files, local reloads, and an offline lyrics cache. Load the next song's lyrics when playback changes.
    • Adapt to light and dark appearance with artwork-colored collection backgrounds, native navigation and controls, and Liquid Glass where supported.
    • Support Dynamic Type, VoiceOver labels, Reduce Motion, and Reduce Transparency, including accessible playback controls and lyrics.
    • Provide the Wavvv music-note icon in default, dark, and system-tinted appearances.

Open source & services

Acknowledgements

WavVv Music Player uses open source code from Petrichor by Kushal Pandya and other open source projects.

Product support

Something not behaving?

Include the product version, operating system version, shortest steps to reproduce, and any exact error text. Redact tokens, private URLs, calendar content, and other personal data.

Email support