# spotube changelog

> spotube release notes.

- Vendor: spotube
- Category: Operating Systems
- Official site: https://spotube.cc/
- Tracked by: What's New (https://whatsnew.fyi/product/spotube)
- Harvested from: GitHub (KRTirtho/spotube)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### v5.1.2

- Date: 2026-06-05
- Version: v5.1.2
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v5.1.2
- Permalink: https://whatsnew.fyi/product/spotube/releases/v5.1.2

- **fixed** — Fallback to muxed streams if no audio stream is available in newpipe
- **fixed** — Dismiss search dropdown and keyboard on submission
- **fixed** — Custom image helper null exception

###### Bug Fixes

- **newpipe**: Fallback to muxed streams if no audio stream is available
- Dismiss search dropdown and keyboard on submission
- Custom image helper null exception

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v5.1.1...v5.1.2

### v5.1.1

- Date: 2026-02-24
- Version: v5.1.1
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v5.1.1
- Permalink: https://whatsnew.fyi/product/spotube/releases/v5.1.1

- **fixed** — Upgrade NewPipeExtractor to latest version fixing playback issue
- **fixed** — Lyrics not working
- **changed** — Replace windows app icon with a higher resolution version

##### v5.1.1

###### Bug Fixes

- Upgrade NewPipeExtractor to latest version fixing playback issue
- Lyrics not working


##### What's Changed
* chore: replace windows app icon by a higher resolution by @TobseF in https://github.com/KRTirtho/spotube/pull/2838

##### New Contributors
* @TobseF made their first contribution in https://github.com/KRTirtho/spotube/pull/2838

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v5.1.0...v5.1.1

### v5.1.0

- Date: 2025-11-14
- Version: v5.1.0
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v5.1.0
- Permalink: https://whatsnew.fyi/product/spotube/releases/v5.1.0

- **added** — New Audio-Source plugins system allowing custom audio sources created by community
- **added** — NewPipe support for Desktop platforms
- **added** — Dab music source
- **added** — Uncompressed flac playback support
- **added** — Plugin audio source models and API service
- **added** — Filter plugins by abilities in plugins page and show abilities as badge
- **added** — Setting default audio source support
- **added** — Default plugin loading capability
- **added** — Multi-select and bulk actions to queue
- **added** — 16KB page size support for Android
- **changed** — Single connection streaming instead of chunked streaming
- **changed** — Improved download manager with faster download speed through parallel chunked downloading
- **changed** — Move away from track source query and prefer audio quality and codec
- **changed** — Show plugin source and set the only plugin as default if no plugin is there
- **fixed** — Play next not working
- **fixed** — Downloaded tracks are not tagged with metadata
- **fixed** — Download not working in different devices and slow
- **fixed** — Change plugin download directory to application support

##### Highlights

- New Audio-Source plugins. Ability to add custom audio source created by community aside from official supported sources like YT, Piped etc.
- NewPipe support for Desktop platforms
- Single connection streaming instead of chunked streaming
- Improved download manager with faster download speed, thanks to parallel chunked downloading
- Queue batch operations support

###### Features

- Show plugin source and set the only plugin as default if no plugin is there
- **playback**: Add dab music source
- **playback**: Add uncompressed flac playback support
- Add plugin audio source models and api service
- **plugins**: Filter plugins by abilities in plugins page and show abilities as badge
- Add setting default audio source support
- Move away from track source query and preferences audio quality and codec
- Add NewPipe support for desktop platforms
- Add default plugin loading capability
- **queue**: Add multi-select and bulk actions to queue ([#2839](https://github.com/KRTirtho/spotube/issues/2839))
- **android**: Add 16KB page size support

###### Bug Fixes

- Change plugin download directory to application support
- **playback**: Play next not working
- Downloaded tracks are not tagged with metadata
- Download not working in different devices and slow
- **playback**: Use stream instead of chunked serving of audio bytes

##### New Contributors
* @Rahul-Sahani04 made their first contribution in https://github.com/KRTirtho/spotube/pull/2839

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v5.0.0...v5.1.0

### v5.0.0

- Date: 2025-09-11
- Version: v5.0.0
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v5.0.0
- Permalink: https://whatsnew.fyi/product/spotube/releases/v5.0.0

- **added** — Support for any music metadata service through plugins
- **added** — Musicbrainz and Listenbrainz official plugin for music metadata
- **added** — Listenbrainz scrobbling support through plugin
- **added** — ISRC track search for YouTube
- **added** — Connect confirmation dialog
- **added** — Metadata plugin pagination support, feed and playlist CRUD endpoints
- **added** — Local storage API for plugins
- **added** — Webview, TOTP and setInterval APIs for plugins
- **added** — Metadata plugin logout method
- **added** — Playlist endpoint and providers
- **added** — Albums metadata endpoint and provider
- **added** — Artist and album providers
- **added** — Track endpoint for metadata service
- **added** — Plugin form for metadata configuration
- **added** — Automatic plugin repository support from GitHub and Codeberg
- **added** — Plugin update checker and dialog for available updates
- **added** — Plugin scrobbling support and support button
- **added** — Traditional Chinese translation
- **changed** — Playback improvements including reduction of skipping issue and HLS support
- **changed** — Efficient image handling for performance
- **changed** — UI refactors geared towards performance benefits
- **changed** — Offload heavy operations like track source search to secondary thread using Isolate
- **changed** — Enhance local storage and webview APIs with improved error handling and resource management
- **changed** — Update plugin configuration with more fields
- **changed** — Update models to match hetu_spotube_plugin signature
- **changed** — Add repository and plugin API version fields to metadata plugins
- **changed** — Optimize track options and related artists
- **fixed** — Calling /track/:streamId endpoint causes active sourced track to be anything
- **fixed** — Dialogs in bottom sheet not opening on mobile
- **fixed** — Default accent color is orange but shows blue in settings
- **fixed** — Artist images not loading
- **fixed** — Endless playback not working
- **fixed** — NewPipe invalid search content filters on Android
- **fixed** — Create and delete playlist not working
- **fixed** — Local track not working and images of local not showing
- **fixed** — Local playback not working for tracks with special # characters
- **fixed** — Inaccessible streaming URL causing rapid skips
- **fixed** — Fallback to different search result if all streaming URLs are inaccessible
- **fixed** — Skip network requests if cached file already exists
- **fixed** — Yt-dlp playback not working and add partial support for HLS streaming
- **fixed** — Windows webview2 environment permission issue
- **fixed** — Playback not fetching full playlist if playlist is too long
- **fixed** — Tapping on track options doesn't close the menu
- **fixed** — Alternative track sources switch not working
- **fixed** — Lyrics white text in white background and small player buttons
- **fixed** — Japanese translations
- **fixed** — Dutch language corrections
- **security** — Remote path traversal through websocket when devices are on same network

Thanks for supporting Spotube. The app was in a non-working state for a long time due to legal and other issues.
Well, I am happy to report that your Spotube is officially back. Now, even more customizable and community-driven.
I hope users of Spotube will finally be enjoying using Spotube.

##### Highlights

- Support for any music metadata service through plugins.
- Musicbrainz + Listenbrainz official plugin for music metadata.
- Listenbrainz scrobbling support (through plugin)
- Documentation for using and developing your own plugins: https://spotube.krtirtho.dev/docs
- Playback improvements including reduction of skipping issue and HLS support
- Performance improvements:
  - Efficient image handling
  - UI refactors geared towards performance benefits
  - Offloading of heavy operations like track source search to secondary thread (Isolate)

###### Features

- Add ISRC track search for YouTube ([#2594](https://github.com/KRTirtho/spotube/issues/2594))
- Add new icons #2676 by @alexio-dev ([#2678](https://github.com/KRTirtho/spotube/issues/2678))
- Add connect confirmation dialog
- Add metadata api service and models
- **metadata-plugin**: Add pagination support, feed and playlist CRUD endpoints
- **metadata-plugin**: Add local storage api
- Add webview, totp and setInterval apis for plugins
- Enhance local storage and webview APIs with improved error handling and resource management
- **metadata_plugin**: Add logout method
- Update plugin configuration with more fields
- Implement metadata plugins based on hetu
- Update models to match hetu_spotube_plugin signature
- Add user endpoint calls in metadata and paginated async notifiers
- Add playlist endpoint and providers
- Add albums metadata endpoint and provider
- Add artist and album providers
- Add track endpoint for metadata service
- Remove green corp names formally
- **metadata**: Add plugin form
- Add support for entity specific search
- Enhance image handling
- Add support for automatic plugin repository from github and codeberg
- Use isolate for youtube_explode engine
- Add repository and plugin API version fields to metadata plugins
- Update new pipe version
- **metadata**: Add plugin update checker and dialog for available updates
- Optimize track options and related artists
- Add plugin scrobbling support and support button
- Add ErrorBox and NoDefaultMetadataPlugin components

###### Bug Fixes

- Calling /track/:streamId endpoint causes active sourced track to be anything
- **mobile**: Dialogs in bottom sheet are not opening
- Default accent color is orange but it shows blue in settings
- Artist images are not loading up
- CVE: Remote path traversal through websocket when devices are on same network
- Endless playback not working
- **android**: NewPipe invalid search content filters
- Make YoutubeExplode engine faster
- Create and delete playlist not working
- Local track not working and images of local not showing up
- Local playback not working for tracks with special # (hashtag) characters
- Inaccessible streaming url causing rapid skips
- **yt**: Fallback to different search result if all streaming url is inaccessible
- **playback**: Skip network requests if cached file already exists
- Yt-dlp playback not working and add partial support for HLS streaming
- Windows webview2 environment permission issue
- **playback**: Play not fetching full playlist if playlist is too long
- **track_options**: Tapping on option doesn't close the menu
- **playback**: Alternative track sources switch not working
- **ui**: Lyrics white text in white background and small player buttons

###### Translation

- Add Traditional Chinese translation ([#2762](https://github.com/KRTirtho/spotube/issues/2762))
- Fix Japanese translations ([#2732](https://github.com/KRTirtho/spotube/issues/2732))
- Correction of the dutch language ([#1306](https://github.com/KRTirtho/spotube/issues/1306))

##### Pull Requests
*

_[Truncated at 4000 characters — full notes: https://github.com/KRTirtho/spotube/releases/tag/v5.0.0]_

### v4.0.2

- Date: 2025-03-16
- Version: v4.0.2
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v4.0.2
- Permalink: https://whatsnew.fyi/product/spotube/releases/v4.0.2

- **fixed** — Fix empty home screen and "Something went wrong" bug
- **fixed** — Fix invalid access token exception

##### Highlights

- Fixes the empty home screen and "Something went wrong" bug

###### Bug Fixes

- invalid access token exception #2525


**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v4.0.1...v4.0.2

### v4.0.1

- Date: 2025-03-15
- Version: v4.0.1
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v4.0.1
- Permalink: https://whatsnew.fyi/product/spotube/releases/v4.0.1

- **fixed** — Fixed authentication Error 400 or 429 status due to Spotify API change
- **fixed** — Fixed system navigation bar on top of bottom navigation
- **fixed** — Fixed navigation overlaying in app navigation on Android
- **fixed** — Fixed add to playlist not working in smaller screen devices
- **fixed** — Fixed language picker search
- **fixed** — Fixed generate_playlist create playlist not adding tracks nor navigating to playlist page
- **fixed** — Fixed double titlebar in local library folders and massive space in overlay player on desktop
- **fixed** — Fixed lastfm form broken in other locales
- **fixed** — Fixed Spotify login broken due to new totp requirement
- **added** — Added support for x-flac, opus and x-wav formats in local library
- **added** — Added Tagalog language support
- **added** — Added Tamil translation

> **NOTICE**: If login isn't working after installing the app, logout and login.

##### Highlights

- Fixed authentication Error 400 or 429 status due to Spotify API change
- Fixed system navigation bar on top of bottom navigation

###### Bug Fixes

- **android**: navigation overlaying in app navigation
- add to playlist not working in smaller screen devices
- language picker search broken
- **generate_playlist**: create playlist not adding tracks nor navigating to playlist page
- **desktop**: double titlebar in local library folders and massive space in overlay player
- lastfm form broken in other locales #2447
- spotify login broken due to new totp requirement #2494
- spotify authentication 429 errors

###### Features

- **local_library**: add support for x-flac, opus and x-wav
- **translation**: add tagalog language support #2504
- **translation**: add tamil translation for spotube #2501

##### New Contributors
* @JusArthur made their first contribution in https://github.com/KRTirtho/spotube/pull/2504
* @vishnumur777 made their first contribution in https://github.com/KRTirtho/spotube/pull/2501

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v4.0.0...v4.0.1

### v4.0.0

- Date: 2025-03-07
- Version: v4.0.0
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v4.0.0
- Permalink: https://whatsnew.fyi/product/spotube/releases/v4.0.0

- **changed** — Revamped UI from Material V3 to Shadcn design system with more intuitive user interface, performant responsive adaptive design, and better visuals with OLED friendly pure black color palette
- **added** — Alternative YouTube engine support with yt-dlp for desktop platforms and NewPipe for Android
- **added** — Android home screen widget support
- **fixed** — Fixed music skipping, buffering, or not playing at all
- **added** — Custom editable Piped and Invidious instance support
- **fixed** — SafeArea for global bottom items not working
- **fixed** — SafeArea not working for bottom floating widgets
- **fixed** — YouTube video unplayable issue and use more ytClients
- **fixed** — iOS downloads not working due to permission errors
- **fixed** — Remove automaticallyImplyLeading from root tabs
- **fixed** — Android back button not working and safe area issues
- **fixed** — Duplicates in recent section
- **fixed** — YouTube source taking too long to buffer
- **fixed** — YouTube tracks keeps skipping despite being matched correctly
- **fixed** — Follow artist not working
- **fixed** — youtube_explode_dart failing for many videos due to youtube iOS client visitor data change
- **fixed** — Piped API not working
- **added** — Grid/list customizable playbutton view
- **added** — Flag to hide spotify generated images with patterns
- **added** — Show placeholder images where there is no item or on empty page
- **added** — Pause playback when no internet connection

##### Highlights:
- Revamped UI from Material V3 to Shadcn design system 
    - More intuitive user interface
    - Performant, responsive and adaptive design
    - Better visuals, feedbacks and OLED friendly (pure black) color palette
- Alternative YouTube engine support 
    - yt-dlp for desktop platforms
    - NewPipe for Android
- Android: Home screen widget support
- Fixed music skipping, buffering or not playing at all
- Custom editable Piped and Invidious instance support

###### Bug Fixes

- SafeArea for global bottom items not working
- SafeArea not working for bottom floating widgets
- youtube video unplayable issue and use more ytClients
- **ios**: downloads not working due to permission errors (#2180)
- remove automaticallyImplyLeading from root tabs
- **android**: back button not working and safe area issues
- duplicates in recent section
- youtube source taking too long to buffer
- youtube tracks keeps skipping despite being matched correctly
- follow artist not working #2057
- youtube_explode_dart failing for many videos due to youtube ios client visitor data change
- piped api not working

###### Features

- **android**: home widget support (#2148)
- rewrite entire app in shadcn-ui replacing material eww
- grid/list customizable playbutton view
- flag to hide spotify generated images with patterns
- show placeholder images where there is no item or on empty page
- pause playback when no internet connection
- implement yt-dlp for desktop and NewPipeExtractor for Android (#2316)
- custom piped & invidious instance support

##### What's Changed
* fix(ios): downloads not working due to permission errors by @malikmiran in https://github.com/KRTirtho/spotube/pull/2180

##### New Contributors
* @malikmiran made their first contribution in https://github.com/KRTirtho/spotube/pull/2180

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v3.9.0...v4.0.0

### v3.9.0

- Date: 2024-12-08
- Version: v3.9.0
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v3.9.0
- Permalink: https://whatsnew.fyi/product/spotube/releases/v3.9.0

- **added** — Invidious audio source
- **added** — Track caching with export support
- **fixed** — UI glitch when loading more user artists and albums
- **fixed** — Selecting an alternative track source no longer removes the current song from the queue
- **fixed** — Ensure audio session is activated when playback is resumed after interruption on mobile

##### Highlights

- New [Invidious](https://invidious.io/) source addition
- Track caching with export support

###### Bug Fixes

- UI glitch when loading more user artists and albums
- selecting an Alternative Track Source removes the current song from the queue #2039
- **mobile**: ensure audio session is activated when playback is resumed after interruption #2092

###### Features

- add invidious audio source and fix auto skipping tracks (#2005)
- track caching and cached track export support (#2117)

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v3.8.3...v3.9.0

### v3.8.3

- Date: 2024-10-09
- Version: v3.8.3
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v3.8.3
- Permalink: https://whatsnew.fyi/product/spotube/releases/v3.8.3

- **fixed** — Update youtube_explode_dart to 2.2.3 to fix no playback
- **added** — Enable same window webview support on macOS

###### Bug Fixes

- update youtube_explode_dart to 2.2.3 to fix no playback (#1980)

###### Features

- **macos**: enable same window webview support

##### What's Changed
* Update youtube_explode_dart to 2.2.3 by @XaviFortes in https://github.com/KRTirtho/spotube/pull/1980

##### New Contributors
* @XaviFortes made their first contribution in https://github.com/KRTirtho/spotube/pull/1980

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v3.8.2...v3.8.3

### v3.8.2

- Date: 2024-09-30
- Version: v3.8.2
- Original notes: https://github.com/KRTirtho/spotube/releases/tag/v3.8.2
- Permalink: https://whatsnew.fyi/product/spotube/releases/v3.8.2

- **fixed** — Fixed no playback from the app due to recent change in YouTube API
- **fixed** — Fixed endless loading issue by updating youtube_explode_dart dependency version

##### Highlight

- Fixed no playback from the app due to recent change in YouTube API

##### What's Changed
* Update youtube_explode_dart dependency version (fixes endless loading issue) by @sunryze-git in https://github.com/KRTirtho/spotube/pull/1925

##### New Contributors
* @sunryze-git made their first contribution in https://github.com/KRTirtho/spotube/pull/1925

**Full Changelog**: https://github.com/KRTirtho/spotube/compare/v3.8.1...v3.8.2