Merge branch 'dev' into patch-1

.env.example

@@ -1,7 +1,3 @@
-# The format:
-# SPOTIFY_SECRETS=clintId1:clientSecret1,clientId2:clientSecret2
-SPOTIFY_SECRETS=$SPOTIFY_SECRETS
-
 # 0 or 1
 # 0 = disable
 # 1 = enable
@@ -14,4 +10,3 @@ LASTFM_API_SECRET=$LASTFM_API_SECRET
 RELEASE_CHANNEL=$RELEASE_CHANNEL
 
 HIDE_DONATIONS=$HIDE_DONATIONS
-DISABLE_SPOTIFY_IMAGES=$DISABLE_SPOTIFY_IMAGES

.fvm/fvm_config.json

@@ -1,3 +1,3 @@
 {
-  "flutterSdkVersion": "3.29.2"
+  "flutterSdkVersion": "3.35.2"
 }

.fvmrc

@@ -1,4 +1,4 @@
 {
-  "flutter": "3.29.2",
+  "flutter": "3.35.2",
   "flavors": {}
 }

.github/workflows/pr-lint.yml

@@ -4,7 +4,7 @@ on:
   pull_request:
 
 env:
-  FLUTTER_VERSION: 3.29.2
+  FLUTTER_VERSION: 3.35.2
 
 jobs:
   lint:
@@ -21,7 +21,6 @@ jobs:
         run: |
           envsubst < .env.example > .env
         env:
-          SPOTIFY_SECRETS: xxx:xxx
           ENABLE_UPDATE_CHECK: true
           LASTFM_API_KEY: xxx
           LASTFM_API_SECRET: xxx

.github/workflows/spotube-release-binary.yml

@@ -20,7 +20,7 @@ on:
         description: Dry run without uploading to release
 
 env:
-  FLUTTER_VERSION: 3.29.2
+  FLUTTER_VERSION: 3.35.2
   FLUTTER_CHANNEL: master
 
 permissions:
@@ -56,7 +56,7 @@ jobs:
             files: |
               dist/Spotube-windows-x86_64.nupkg
               dist/Spotube-windows-x86_64-setup.exe
-          - os: macos-latest
+          - os: macos-14
             platform: ios
             arch: all
             files: |
@@ -95,7 +95,7 @@ jobs:
         if: ${{matrix.platform == 'ios'}}
         uses: maxim-lobanov/setup-xcode@v1
         with:
-          xcode-version: "16.1"
+          xcode-version: "16.2"
 
       - name: Install ${{matrix.platform}} dependencies
         run: |

.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "300451adae589accbece3490f4396f10bdf15e6e"
+  revision: "d7b523b356d15fb81e7d340bbe52b47f93937323"
   channel: "stable"
 
 project_type: app
@@ -13,11 +13,11 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: 300451adae589accbece3490f4396f10bdf15e6e
-      base_revision: 300451adae589accbece3490f4396f10bdf15e6e
+      create_revision: d7b523b356d15fb81e7d340bbe52b47f93937323
+      base_revision: d7b523b356d15fb81e7d340bbe52b47f93937323
     - platform: windows
-      create_revision: 300451adae589accbece3490f4396f10bdf15e6e
-      base_revision: 300451adae589accbece3490f4396f10bdf15e6e
+      create_revision: d7b523b356d15fb81e7d340bbe52b47f93937323
+      base_revision: d7b523b356d15fb81e7d340bbe52b47f93937323
 
   # User provided section
 

.vscode/launch.json

@@ -17,6 +17,17 @@
         "dev"
       ]
     },
+    {
+      "name": "spotube (mobile-skia)",
+      "type": "dart",
+      "request": "launch",
+      "program": "lib/main.dart",
+      "args": [
+        "--flavor",
+        "dev",
+        "--no-enable-impeller"
+      ]
+    },
     {
       "name": "spotube (profile)",
       "type": "dart",

.vscode/settings.json

@@ -5,6 +5,7 @@
     "ambiguate",
     "Amoled",
     "Buildless",
+    "configurators",
     "danceability",
     "fuzzywuzzy",
     "gapless",
@@ -29,5 +30,5 @@
     "README.md": "LICENSE,CODE_OF_CONDUCT.md,CONTRIBUTING.md,SECURITY.md,CONTRIBUTION.md,CHANGELOG.md,PRIVACY_POLICY.md",
     "*.dart": "${capture}.g.dart,${capture}.freezed.dart"
   },
-  "dart.flutterSdkPath": ".fvm/versions/3.29.2"
+  "dart.flutterSdkPath": ".fvm/versions/3.35.2"
 }

Makefile

@@ -8,7 +8,7 @@ tar:
 		mkdir -p $(TEMP_DIR)\
 		&& cp -r $(BUNDLE_DIR)/* $(TEMP_DIR)\
 		&& cp linux/spotube.desktop $(TEMP_DIR)\
-		&& cp assets/spotube-logo.png $(TEMP_DIR)\
+		&& cp assets/branding/spotube-logo.png $(TEMP_DIR)\
 		&& cp linux/com.github.KRTirtho.Spotube.appdata.xml $(TEMP_DIR)\
 		&& tar -cJf build/spotube-linux-${VERSION}-${PKG_ARCH}.tar.xz -C $(TEMP_DIR) .\
 		&& rm -rf $(TEMP_DIR)
@@ -53,3 +53,6 @@ dmg:
 		then rm dist/Spotube-macos-universal.dmg;\
 		fi &&\
 		appdmg appdmg.json dist/Spotube-macos-universal.dmg
+
+changelog:
+	git-cliff --unreleased

README.md

@@ -1,47 +1,8 @@
-# 🚨 Spotube is banned from using "Spotify™ API" 🚨
-
-### The developer of Spotube has received a cease and desist letter from Spotify USA Inc. and Spotify AB, asserting a legal threat concerning the distribution and development of any application that utilizes Spotify’s data API in conjunction with content from YouTube® to facilitate ad-free playback of music tracks. The letter contends that this specific use of the Spotify™ APIs contravenes the Spotify™ Agreements and may also infringe upon the rights of music rights holders.
-
-### Consequently, as the official maintainer of Spotube, I will immediately cease all forms of official distribution and development of Spotube that continue to employ the aforementioned 'Spotify™ APIs'
-
-### <ins>Their exact reasoning</ins>: (any) "uses of Spotify’s data API in connection with content from YouTube to provide ad-free playback of music tracks. The use of the Spotify APIs in this manner violates the Spotify Agreements and may also violate the rights of music rights holders."
-
-## So what's now?
-
-> In short, we are cooked (legally)
-
-For now, I've to:
-
-1. Stop distributing/developing Spotube/any app that uses "Spotify™ APIs"
-
-   That means, I can no longer distribute Spotube through the website, GitHub, any app store and immediately have to take down the versions that uses Spotify™ APIs.
-
-1. Stop using their logo/image/name/intellectual property in a manner that "seems infringement"
-1. Forever desist from aiding or assisting any other person or entity in the activities described above
-
----
-
-**For the users of Spotube:**
-
-Don't worry, Spotube is banned only from (or assisting other) using those APIs. As long as the app isn't using them or no way helps anyone else to use them, it's ok.
-
-In future, I'll try to rewrite Spotube to ensure it operates within the bounds of copyright law and platform policies. And give ways for the users to extend the app to their use cases. Work is already in progress to implement this! So expect some big updates soon!
-
-But for eternity, you can't download versions of Spotube that still uses "Spotify™ APIs" from official means (website/Github/app stores). Those will be taken down.
-
-**But newer version of Spotube that _doesn't_ use "Spotify™ APIs" will be available to replace those.**
-
-That means, in the upcoming new versions, you will no longer be able to login with your "Spotify™ Account", access your saved playlists, albums, tracks, followed artists or perform any action on that account or anything that is from "Spotify™" or owned by "Spotify™" (yes the API public data (e.g. track metadata) as well) through Spotube.
-
-**Conclusion:** I'm extremely sorry for this disruption to your day to day music listening experience. Spotube existed and it used by a large number of users because they find it better. And we'll continue to be better than others but legally\* from now on
-
-> Spotube has no affiliation with Spotify™ or any of its subsidiaries.
-
 <div align="center">
-  <img width="600" src="assets/spotube_banner.png" alt="Spotube Logo">
+  <img width="600" src="assets/branding/spotube_banner.png" alt="Spotube Logo">
 
-An open source, cross-platform music client<br />
-utilizing selected music provider API and YouTube®, Piped.video or JioSaavn as an audio source
+A cross-platform extensible open-source music streaming platform.<br>
+Bring your own music metadata/playlist with plugins created by community or by yourself. A small step towards the decentralized music streaming era!
 
 Btw it's not just another Electron app 😉
 
@@ -61,30 +22,316 @@ Btw it's not just another Electron app 😉
 
 ## 🌃 Features
 
-- 🚫 No ads, thanks to the use of public & free music metadata providers and YT Music APIs¹
-- ⬇️ Freely downloadable tracks
-- 🖥️ 📱 Cross-platform support
-- 🪶 Small size & less data usage
-- 🕵️ Anonymous/guest login
-- 🕒 Time synced lyrics
-- ✋ No telemetry, diagnostics or user data collection
-- 🚀 Native performance
-- 📖 Open source/libre software
-- 🔉 Playback control is done locally, not on the server
+- 🧩 Plugin powered, supports any platform or custom music service through plugins.
+- 🗺️ Community driven plugins for popular platforms or create your own.
+- ⬇️ Freely downloadable tracks with tagged metadata.
+- 🖥️ 📱 Cross-platform support.
+- 🪶 Small size & less data usage.
+- 🕒 Time synced lyrics regardless of the plugin support.
+- ✋ No telemetry, diagnostics or user data collection.
+- 🚀 Native performance.
+- 📖 Open source/libre software.
+- 🔉 Playback control is done locally, not on the server.
 
-**¹** It is still **recommended** to support creators by engaging with their YouTube channels/tracks in music platforms (or preferably by buying their merch/concert tickets/physical media).
+## 📜 ⬇️ Installation guide
 
-### ❌ Unsupported features
+New versions usually release every 3-4 months.<br />
+This handy table lists all the methods you can use to install Spotube:
 
-- 🗣️ **Shows & Podcasts:** Shows and Podcasts will <ins>**never be supported**</ins> because the audio tracks are <ins>_only_</ins> available on music providers and accessing them would require premium.
-- 🎧 **Listen Along:** [Coming soon!](https://github.com/KRTirtho/spotube/issues/8)
+<table>
+  <tr>
+    <th>Platform</th>
+    <th>Package/Installation Method</th>
+  </tr>
+  <tr>
+    <td>Windows</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-windows-x86_64-setup.exe">
+        <img width="220" alt="Windows Download" src="https://get.todoist.help/hc/article_attachments/4403191721234/WindowsButton.svg">
+      </a>
+  </tr>
+  <tr>
+    <td>MacOS</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-macos-universal.dmg">
+        <img width="220" alt="MacOS Download" src="https://memory-map.com/wp-content/uploads/download-mac-OS-01.svg">
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td>Android</td>
+    <td>
+      <a href="https://play.google.com/store/apps/details?id=oss.krtirtho.spotube">
+        <img width="220" alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png">
+      </a>
+      <br>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-android-all-arch.apk">
+        <img width="220" alt="APK download" src="https://user-images.githubusercontent.com/114044633/223920025-83687de0-e463-4c5d-8122-e06e4bb7d40c.png">
+      </a>
+      <br/>
+      <a href="https://f-droid.org/packages/oss.krtirtho.spotube">
+        <img width="220" alt="Download from F-Droid" src="https://user-images.githubusercontent.com/61944859/174589876-bace24c0-b3fd-4c4a-bdb4-6fa82b5853ec.png">
+      </a>
+    </td>
+  </tr>
+  <tr>
+  <tr>
+    <td>iOS</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-iOS.ipa">
+        <img width="220" alt="Download iOS IPA" src="https://github.com/user-attachments/assets/3e50d93d-fb39-435c-be6b-337745f7c423">
+      </a>
+      <br/>
+      <blockquote style="color:red">
+        *iPA file only. Requires sideloading with <a href="https://altstore.io/">AltStore</a> or similar tools.
+      </blockquote>
+    </td>
+  </tr>
+  <tr>
+    <td>Flatpak</td>
+    <td>
+      <p><code>flatpak install com.github.KRTirtho.Spotube</code></p>
+      <a href="https://flathub.org/apps/details/com.github.KRTirtho.Spotube">
+        <img width="220" alt="Download on Flathub" src="https://flathub.org/assets/badges/flathub-badge-en.png">
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td>AppImage</td>
+    <td>AppImage's lacking stability led to it's temporary removal. More information at https://github.com/KRTirtho/spotube/issues/1082</td>
+  </tr>
+  <tr>
+    <td>Debian/Ubuntu</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-linux-x86_64.deb">
+        <img width="220" alt="Debian/Ubuntu Download" src="https://user-images.githubusercontent.com/61944859/169097994-e92aff78-fd75-4c93-b6e4-f072a4b5a7ed.png">
+      </a>
+      <p>Then run: <code>sudo apt install ./Spotube-linux-x86_64.deb</code></p>
+    </td>
+  </tr>
+  <tr>
+    <td>Arch/Manjaro</td>
+    <td>
+      <p>With pamac: <code>sudo pamac install spotube-bin</code></p>
+      <p>With yay: <code>yay -Sy spotube-bin</code></p>
+    </td>
+  </tr>
+  <tr>
+    <td>Fedora/OpenSuse</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest/download/Spotube-linux-x86_64.rpm">
+        <img width="220" alt="Fedora/OpenSuse Download" src="https://user-images.githubusercontent.com/61944859/223638350-5926b9da-04d6-4edd-931d-ad533e4ff058.png">
+      </a>
+      <p>For Fedora: <code>sudo dnf install ./Spotube-linux-x86_64.rpm</code></p>
+      <p>For OpenSuse: <code>sudo zypper in ./Spotube-linux-x86_64.rpm</code></p>
+    </td>
+  </tr>
+  <tr>
+    <td>Linux (tarball)</td>
+    <td>
+      <a href="https://github.com/KRTirtho/spotube/releases/latest">
+        <img width="220" alt="Tarball Download" src="https://user-images.githubusercontent.com/61944859/169456985-e0ba1fd4-10e8-4cc0-ab94-337acc6e0295.png">
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td>Macos - <a href="https://brew.sh">Homebrew</a></td>
+    <td>
+<pre lang="bash">
+brew tap krtirtho/apps
+brew install --cask spotube
+</pre>   
+    </td>
+  </tr>
+  <tr>
+    <td>Windows - <a href="https://chocolatey.org">Chocolatey</a></td>
+    <td>
+      <p><code>choco install spotube</code></p>
+    </td>
+  </tr>
+  <tr>
+    <td>Windows - <a href="https://scoop.sh">Scoop</a></td>
+    <td>
+      <p><code>scoop bucket add extras</code></p>
+      <p><code>scoop install spotube</code></p>
+    </td>
+  </tr>
+  <tr>
+    <td>Windows - <a href="https://github.com/microsoft/winget-cli">WinGet</a></td>
+    <td>
+      <p><code>winget install --id KRTirtho.Spotube</code></p>
+    </td>
+  </tr>
+</table>
+
+### 🔄 Nightly Builds
+
+Grab the latest nightly builds of Spotube [from the GitHub Releases](https://github.com/KRTirtho/spotube/releases/tag/nightly).
+
+## 🕳️ Building from source
+
+<a href="https://github.com/KRTirtho/spotube/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/KRTirtho/spotube/spotube-release-binary.yml?+label=Build%20Status"></a>
+
+You can compile Spotube's source code by [following these instructions](CONTRIBUTION.md#your-first-code-contribution).
 
 ## 👥 The Spotube team
 
 - [Kingkor Roy Tirtho](https://github.com/KRTirtho) - The Founder, Maintainer and Lead Developer
+- [Owen Connor](https://github.com/owencz1998) - The Cool Discord Moderator
+- [Piotr Rogowski](https://github.com/karniv00l) - The MacOS Developer
+- [Rusty Apple](https://github.com/RustyApple) - The Mysterious Unknown Guy
 
 ## 💼 License
 
 Spotube is open source and licensed under the [BSD-4-Clause](/LICENSE) License.
 
-If you are concerned, you can [read the reason of choosing this license](https://dev.to/krtirtho/choosing-open-source-license-wisely-1m3p).
+If you are curious, you can [read the reason of choosing this license](https://dev.to/krtirtho/choosing-open-source-license-wisely-1m3p).
+
+<details>
+  <summary>
+    <h2><code>[Click to show]</code> 🙏 Services/Package/Plugin Credits</h2>
+  </summary>
+
+### Services
+
+1. [Flutter](https://flutter.dev) - Flutter transforms the app development process. Build, test, and deploy beautiful mobile, web, desktop, and embedded apps from a single codebase
+1. [MPV](https://mpv.io) - mpv is a free (as in freedom) media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types.
+1. [Musicbrainz](https://musicbrainz.org) - MusicBrainz is a MetaBrainz project that aims to create a collaborative music database that is similar to the freedb project.
+1. [Listenbrainz](https://listenbrainz.org) - ListenBrainz is a open-source project by the MetaBrainz Foundation that allows users to crowdsource and publicly store their digital music listening data.
+1. [Piped](https://piped-docs.kavin.rocks/) - Piped is a privacy friendly alternative YouTube frontend, which is efficient and scalable by design.
+1. [Invidious](https://invidious.io/) - Invidious is an open source alternative front-end to YouTube.
+1. [yt-dlp](https://github.com/yt-dlp/yt-dlp) - A feature-rich command-line audio/video downloader.
+1. [NewPipeExtractor](https://github.com/TeamNewPipe/NewPipeExtractor) - NewPipe's core library for extracting data from streaming sites.
+1. [SongLink](https://song.link) - SongLink is a free smart link service that helps you share music with your audience. It's a one-stop-shop for creating smart links for music, podcasts, and other audio content
+1. [LRCLib](https://lrclib.net/) - A public synced lyric API.
+1. [Linux](https://www.linux.org) - Linux is a family of open-source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution
+1. [AUR](https://aur.archlinux.org) - AUR stands for Arch User Repository. It is a community-driven repository for Arch-based Linux distributions users
+1. [Flatpak](https://flatpak.org) - Flatpak is a utility for software deployment and package management for Linux
+1. [SponsorBlock](https://sponsor.ajay.app) - SponsorBlock is an open-source crowdsourced browser extension and open API for skipping sponsor segments in YouTube videos.
+1. [Inno Setup](https://jrsoftware.org/isinfo.php) - Inno Setup is a free installer for Windows programs by Jordan Russell and Martijn Laan
+1. [F-Droid](https://f-droid.org) - F-Droid is an installable catalogue of FOSS (Free and Open Source Software) applications for the Android platform. The client makes it easy to browse, install, and keep track of updates on your device
+1. [LastFM](https://last.fm) - Last.fm is a music streaming and discovery platform that helps users discover and share new music. It tracks users' music listening habits across many devices and platforms.
+
+### Dependencies
+
+1. [app_links](https://github.com/llfbandit/app_links) - Android App Links, Deep Links, iOs Universal Links and Custom URL schemes handler for Flutter (desktop included).
+1. [args](https://pub.dev/packages/args) - Library for defining parsers for parsing raw command-line arguments into a set of options and values using GNU and POSIX style options.
+1. [async](https://pub.dev/packages/async) - Utility functions and classes related to the 'dart:async' library.
+1. [audio_service](https://pub.dev/packages/audio_service) - Flutter plugin to play audio in the background while the screen is off.
+1. [audio_service_mpris](https://github.com/bdrazhzhov/audio-service-mpris) - audio_service platform interface supporting Media Player Remote Interfacing Specification.
+1. [audio_session](https://github.com/ryanheise/audio_session) - Sets the iOS audio session category and Android audio attributes for your app, and manages your app's audio focus, mixing and ducking behaviour.
+1. [auto_route](https://github.com/Milad-Akarie/auto_route_library) - AutoRoute is a declarative routing solution, where everything needed for navigation is automatically generated for you.
+1. [auto_size_text](https://github.com/leisim/auto_size_text) - Flutter widget that automatically resizes text to fit perfectly within its bounds.
+1. [bonsoir](https://bonsoir.skyost.eu) - A Zeroconf library that allows you to discover network services and to broadcast your own. Based on Apple Bonjour and Android NSD.
+1. [cached_network_image](https://github.com/Baseflow/flutter_cached_network_image) - Flutter library to load and cache network images. Can also be used with placeholder and error widgets.
+1. [connectivity_plus](https://github.com/fluttercommunity/plus_plugins) - Flutter plugin for discovering the state of the network (WiFi & mobile/cellular) connectivity on Android and iOS.
+1. [device_info_plus](https://github.com/fluttercommunity/plus_plugins) - Flutter plugin providing detailed information about the device (make, model, etc.), and Android or iOS version the app is running on.
+1. [dio](https://github.com/cfug/dio) - A powerful HTTP networking package,supports Interceptors,Aborting and canceling a request,Custom adapters, Transformers, etc.
+1. [drift](https://drift.simonbinder.eu/) - Drift is a reactive library to store relational data in Dart and Flutter applications.
+1. [duration](https://github.com/desktop-dart/duration) - Utilities to make working with 'Duration's easier. Formats duration in human readable form and also parses duration in human readable form to Dart's Duration.
+1. [encrypt](https://pub.dev/packages/encrypt) - A set of high-level APIs over PointyCastle for two-way cryptography.
+1. [envied](https://github.com/petercinibulk/envied) - Explicitly reads environment variables into a dart file from a .env file for more security and faster start up times.
+1. [file_picker](https://github.com/miguelpruivo/plugins_flutter_file_picker) - A package that allows you to use a native file explorer to pick single or multiple absolute file paths, with extension filtering support.
+1. [file_selector](https://pub.dev/packages/file_selector) - Flutter plugin for opening and saving files, or selecting directories, using native file selection UI.
+1. [fluentui_system_icons](https://github.com/microsoft/fluentui-system-icons/tree/main) - Fluent UI System Icons are a collection of familiar, friendly and modern icons from Microsoft.
+1. [flutter_cache_manager](https://github.com/Baseflow/flutter_cache_manager/tree/develop/flutter_cache_manager) - Generic cache manager for flutter. Saves web files on the storages of the device and saves the cache info using sqflite.
+1. [flutter_discord_rpc](https://pub.dev/packages/flutter_discord_rpc) - Discord RPC support for Flutter desktop platforms
+1. [flutter_displaymode](https://github.com/ajinasokan/flutter_displaymode) - A Flutter plugin to set display mode (resolution, refresh rate) on Android platform. Allows to enable high refresh rate on supported devices.
+1. [flutter_feather_icons](https://github.com/muj-programmer/flutter_feather_icons) - Feather is a collection of simply beautiful open source icons. Each icon is designed on a 24x24 grid with an emphasis on simplicity, consistency and usability.
+1. [flutter_form_builder](https://github.com/flutter-form-builder-ecosystem) - This package helps in creation of forms in Flutter by removing the boilerplate code, reusing validation, react to changes, and collect final user input.
+1. [flutter_hooks](https://github.com/rrousselGit/flutter_hooks) - A flutter implementation of React hooks. It adds a new kind of widget with enhanced code reuse.
+1. [flutter_inappwebview](https://inappwebview.dev/) - A Flutter plugin that allows you to add an inline webview, to use an headless webview, and to open an in-app browser window.
+1. [flutter_native_splash](https://pub.dev/packages/flutter_native_splash) - Customize Flutter's default white native splash screen with background color and splash image. Supports dark mode, full screen, and more.
+1. [flutter_riverpod](https://riverpod.dev) - A reactive caching and data-binding framework. Riverpod makes working with asynchronous code a breeze.
+1. [flutter_secure_storage](https://pub.dev/packages/flutter_secure_storage) - Flutter Secure Storage provides API to store data in secure storage. Keychain is used in iOS, KeyStore based solution is used in Android.
+1. [flutter_sharing_intent](https://github.com/bhagat-techind/flutter_sharing_intent.git) - A flutter plugin that allow flutter apps to receive photos, videos, text, urls or any other file types from another app.
+1. [flutter_undraw](https://github.com/KRTirtho/flutter_undraw) - Undraw.co Illustrations for Flutter with customization options
+1. [form_builder_validators](https://github.com/flutter-form-builder-ecosystem) - Form Builder Validators set of validators for FlutterFormBuilder. Provides common validators and a way to make your own.
+1. [form_validator](https://github.com/TheMisir/form-validator) - Simplest form validation library for flutter's form field widgets
+1. [freezed_annotation](https://pub.dev/packages/freezed_annotation) - Annotations for the freezed code-generator. This package does nothing without freezed too.
+1. [fuzzywuzzy](https://github.com/sphericalkat/dart-fuzzywuzzy) - An implementation of the popular fuzzywuzzy package in Dart, to suit all your fuzzy string matching/searching needs!
+1. [gap](https://github.com/letsar/gap) - Flutter widgets for easily adding gaps inside Flex widgets such as Columns and Rows or scrolling views.
+1. [google_fonts](https://pub.dev/packages/google_fonts) - A Flutter package to use fonts from fonts.google.com. Supports HTTP fetching, caching, and asset bundling.
+1. [home_widget](https://pub.dev/packages/home_widget) - A plugin to provide a common interface for creating HomeScreen Widgets for Android and iOS.
+1. [hooks_riverpod](https://riverpod.dev) - A reactive caching and data-binding framework. Riverpod makes working with asynchronous code a breeze.
+1. [html](https://pub.dev/packages/html) - APIs for parsing and manipulating HTML content outside the browser.
+1. [html_unescape](https://github.com/filiph/html_unescape) - A small library for un-escaping HTML. Supports all Named Character References, Decimal Character References and Hexadecimal Character References.
+1. [http](https://pub.dev/packages/http) - A composable, multi-platform, Future-based API for HTTP requests.
+1. [image_picker](https://pub.dev/packages/image_picker) - Flutter plugin for selecting images from the Android and iOS image library, and taking new pictures with the camera.
+1. [intl](https://pub.dev/packages/intl) - Contains code to deal with internationalized/localized messages, date and number formatting and parsing, bi-directional text, and other internationalization issues.
+1. [invidious](https://pub.dev/packages/invidious) - Invidious API client for Dart and Flutter.
+1. [jiosaavn](https://github.com/KRTirtho/jiosaavn) - Unofficial API client for jiosaavn.com
+1. [json_annotation](https://pub.dev/packages/json_annotation) - Classes and helper functions that support JSON code generation via the `json_serializable` package.
+1. [local_notifier](https://github.com/leanflutter/local_notifier) - This plugin allows Flutter desktop apps to displaying local notifications.
+1. [logger](https://pub.dev/packages/logger) - Small, easy to use and extensible logger which prints beautiful logs.
+1. [logging](https://pub.dev/packages/logging) - Provides APIs for debugging and error logging, similar to loggers in other languages, such as the Closure JS Logger and java.util.logging.Logger.
+1. [lrc](https://pub.dev/packages/lrc) - A Dart-only package that creates, parses, and handles LRC, which is a format that stores song lyrics.
+1. [media_kit](https://github.com/media-kit/media-kit) - A cross-platform video player & audio player for Flutter & Dart. Performant, stable, feature-proof & modular.
+1. [media_kit_libs_audio](https://github.com/media-kit/media-kit.git) - package:media_kit audio (only) playback native libraries for all platforms.
+1. [metadata_god](https://pub.dev/packages/metadata_god) - Plugin for retrieving and writing audio tags/metadata from audio files
+1. [mime](https://pub.dev/packages/mime) - Utilities for handling media (MIME) types, including determining a type from a file extension and file contents.
+1. [open_file](https://pub.dev/packages/open_file) - A plug-in that can call native APP to open files with string result in flutter, support iOS(UTI) / android(intent) / PC(ffi) / web(dart:html)
+1. [package_info_plus](https://github.com/fluttercommunity/plus_plugins) - Flutter plugin for querying information about the application package, such as CFBundleVersion on iOS or versionCode on Android.
+1. [palette_generator](https://pub.dev/packages/palette_generator) - Flutter package for generating palette colors from a source image.
+1. [path](https://pub.dev/packages/path) - A string-based path manipulation library. All of the path operations you know and love, with solid support for Windows, POSIX (Linux and Mac OS X), and the web.
+1. [path_provider](https://pub.dev/packages/path_provider) - Flutter plugin for getting commonly used locations on host platform file systems, such as the temp and app data directories.
+1. [permission_handler](https://pub.dev/packages/permission_handler) - Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
+1. [piped_client](https://github.com/KRTirtho/piped_client) - API Client for piped.video
+1. [riverpod](https://riverpod.dev) - A reactive caching and data-binding framework. Riverpod makes working with asynchronous code a breeze.
+1. [scroll_to_index](https://github.com/quire-io/scroll-to-index) - Scroll to a specific child of any scrollable widget in Flutter
+1. [shadcn_flutter](https://github.com/sunarya-thito/shadcn_flutter) - Beautifully designed components from Shadcn/UI is now available for Flutter
+1. [shared_preferences](https://pub.dev/packages/shared_preferences) - Flutter plugin for reading and writing simple key-value pairs. Wraps NSUserDefaults on iOS and SharedPreferences on Android.
+1. [shelf](https://pub.dev/packages/shelf) - A model for web server middleware that encourages composition and easy reuse.
+1. [shelf_router](https://pub.dev/packages/shelf_router) - A convenient request router for the shelf web-framework, with support for URL-parameters, nested routers and routers generated from source annotations.
+1. [shelf_web_socket](https://pub.dev/packages/shelf_web_socket) - A shelf handler that wires up a listener for every connection.
+1. [simple_icons](https://teavelopment.com/) - The Simple Icon pack available as Flutter Icons. Provides over 1500 Free SVG icons for popular brands.
+1. [skeletonizer](https://github.com/Milad-Akarie/skeletonizer) - Converts already built widgets into skeleton loaders with no extra effort.
+1. [sliding_up_panel](https://github.com/akshathjain/sliding_up_panel) - A draggable Flutter widget that makes implementing a SlidingUpPanel much easier!
+1. [sliver_tools](https://github.com/Kavantix) - A set of useful sliver tools that are missing from the flutter framework
+1. [smtc_windows](https://pub.dev/packages/smtc_windows) - Windows `SystemMediaTransportControls` implementation for Flutter giving access to Windows OS Media Control applet.
+1. [sqlite3](https://github.com/simolus3/sqlite3.dart/tree/main/sqlite3) - Provides lightweight yet convenient bindings to SQLite by using dart:ffi
+1. [sqlite3_flutter_libs](https://github.com/simolus3/sqlite3.dart/tree/main/sqlite3_flutter_libs) - Flutter plugin to include native sqlite3 libraries with your app
+1. [stroke_text](https://github.com/MohamedAbd0/stroke_text) - A Simple Flutter plugin for applying stroke (border) style to a text widget
+1. [system_theme](https://github.com/bdlukaa/system_theme/tree/master/system_theme) - A plugin to get the current system theme info. Supports Android, Web, Windows, Linux and macOS
+1. [test](https://pub.dev/packages/test) - A full featured library for writing and running Dart tests across platforms.
+1. [timezone](https://pub.dev/packages/timezone) - Time zone database and time zone aware DateTime.
+1. [titlebar_buttons](https://github.com/gtk-flutter/titlebar_buttons) - A package which provides most of the titlebar buttons from windows, linux and macos.
+1. [tray_manager](https://github.com/leanflutter/tray_manager) - This plugin allows Flutter desktop apps to defines system tray.
+1. [url_launcher](https://pub.dev/packages/url_launcher) - Flutter plugin for launching a URL. Supports web, phone, SMS, and email schemes.
+1. [uuid](https://pub.dev/packages/uuid) - RFC4122 (v1, v4, v5, v6, v7, v8) UUID Generator and Parser for Dart
+1. [version](https://github.com/dartninja/version) - Provides a simple class for parsing and comparing semantic versions as defined by http://semver.org/
+1. [very_good_infinite_list](https://github.com/VeryGoodOpenSource/very_good_infinite_list) - A library for easily displaying paginated data, created by Very Good Ventures. Great for activity feeds, news feeds, and more.
+1. [visibility_detector](https://pub.dev/packages/visibility_detector) - A widget that detects the visibility of its child and notifies a callback.
+1. [web_socket_channel](https://pub.dev/packages/web_socket_channel) - StreamChannel wrappers for WebSockets. Provides a cross-platform WebSocketChannel API, a cross-platform implementation of that API that communicates over an underlying StreamChannel.
+1. [wikipedia_api](https://github.com/KRTirtho/wikipedia_api) - Wikipedia API for dart and flutter
+1. [win32_registry](https://pub.dev/packages/win32_registry) - A package that provides a friendly Dart API for accessing the Windows Registry.
+1. [window_manager](https://github.com/leanflutter/window_manager) - This plugin allows Flutter desktop apps to resizing and repositioning the window.
+1. [youtube_explode_dart](https://github.com/Hexer10/youtube_explode_dart) - A port in dart of the youtube explode library. Supports several API functions without the need of Youtube API Key.
+1. [http_parser](https://pub.dev/packages/http_parser) - A platform-independent package for parsing and serializing HTTP formats.
+1. [collection](https://pub.dev/packages/collection) - Collections and utilities functions and classes related to collections.
+1. [otp_util](https://github.com/dushiling) - otp_util is a dart package to generate and verify one-time passwords,it It provides two methods TOPT and HOTP.They are Time-based OTPs and Counter-based OTPs.
+1. [dio_http2_adapter](https://github.com/cfug/dio) - An adapter that combines HTTP/2 and dio. Supports reusing connections, header compression, etc.
+1. [build_runner](https://pub.dev/packages/build_runner) - A build system for Dart code generation and modular compilation.
+1. [envied_generator](https://github.com/petercinibulk/envied) - Generator for the Envied package. See https://pub.dev/packages/envied.
+1. [flutter_gen_runner](https://github.com/FlutterGen/flutter_gen) - The Flutter code generator for your assets, fonts, colors, … — Get rid of all String-based APIs.
+1. [flutter_launcher_icons](https://github.com/fluttercommunity/flutter_launcher_icons) - A package which simplifies the task of updating your Flutter app's launcher icon.
+1. [flutter_lints](https://pub.dev/packages/flutter_lints) - Recommended lints for Flutter apps, packages, and plugins to encourage good coding practices.
+1. [json_serializable](https://pub.dev/packages/json_serializable) - Automatically generate code for converting to and from JSON by annotating Dart classes.
+1. [freezed](https://pub.dev/packages/freezed) - Code generation for immutable classes that has a simple syntax/API without compromising on the features.
+1. [process_run](https://github.com/tekartik/process_run.dart/blob/master/packages/process_run) - Process run helpers for Linux/Win/Mac and which like feature for finding executables.
+1. [pubspec_parse](https://pub.dev/packages/pubspec_parse) - Simple package for parsing pubspec.yaml files with a type-safe API and rich error reporting.
+1. [pub_api_client](https://github.com/leoafarias/pub_api_client) - An API Client for Pub to interact with public package information.
+1. [xml](https://github.com/renggli/dart-xml) - A lightweight library for parsing, traversing, querying, transforming and building XML documents.
+1. [io](https://pub.dev/packages/io) - Utilities for the Dart VM Runtime including support for ANSI colors, file copying, and standard exit code values.
+1. [drift_dev](https://drift.simonbinder.eu/) - Dev-dependency for users of drift. Contains the generator and development tools.
+1. [auto_route_generator](https://github.com/Milad-Akarie/auto_route_library) - AutoRoute is a declarative routing solution, where everything needed for navigation is automatically generated for you.
+1. [desktop_webview_window](https://github.com/MixinNetwork/flutter-plugins/tree/main/packages/desktop_webview_window) - Show a webview window on your flutter desktop application.
+1. [disable_battery_optimization](https://github.com/pvsvamsi/Disable-Battery-Optimizations) - Flutter plugin to check and disable battery optimizations. Also shows custom steps to disable the optimizations in devices like mi, xiaomi, samsung, oppo, huawei, oneplus etc
+1. [draggable_scrollbar](https://github.com/fluttercommunity/flutter-draggable-scrollbar) - A scrollbar that can be dragged for quickly navigation through a vertical list. Additional option is showing label next to scrollthumb with information about current item.
+1. [flutter_broadcasts](https://github.com/KRTirtho/flutter_broadcasts.git) - A plugin for sending and receiving broadcasts with Android intents and iOS notifications.
+1. [scrobblenaut](https://github.com/Nebulino/Scrobblenaut) - A deadly simple LastFM API Wrapper for Dart. So deadly simple that it's gonna hit the mark.
+1. [yt_dlp_dart](https://github.com/KRTirtho/yt_dlp_dart.git) - yt-dlp binding in Dart
+1. [flutter_new_pipe_extractor](https://github.com/KRTirtho/flutter_new_pipe_extractor) - NewPipeExtractor binding for Flutter (Android only)
+</details>
+
+<div align="center"><h4>© Copyright Spotube 2025</h4></div>

android/app/build.gradle

@@ -33,7 +33,7 @@ def composeVersion = "1.4.8"
 android {
     namespace "oss.krtirtho.spotube"
     
-    compileSdkVersion 35
+    compileSdkVersion 36
 
     ndkVersion = "27.0.12077973"
 

android/app/proguard-rules.pro

@@ -1,3 +1,12 @@
+#Flutter Wrapper
+# -keep class io.flutter.app.** { *; }
+-keep class io.flutter.plugin.**  { *; }
+-keep class io.flutter.util.**  { *; }
+-keep class io.flutter.view.**  { *; }
+# -keep class io.flutter.**  { *; }
+-keep class io.flutter.plugins.**  { *; }
+-keep class de.prosiebensat1digital.** { *; }
+
 -keep class androidx.lifecycle.DefaultLifecycleObserver
 
 -keepnames class kotlinx.serialization.** { *; }

android/app/src/main/AndroidManifest.xml

@@ -57,10 +57,6 @@
 
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
-
-        <data
-          android:host="open.spotify.com"
-          android:scheme="https" />
       </intent-filter>
 
       <intent-filter>
@@ -74,8 +70,6 @@
 
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
-        <!-- Accepts URIs that begin with "spotify:// -->
-        <data android:scheme="spotify" />
         <data android:scheme="spotube" />
       </intent-filter>
 

appdmg.json

@@ -1,6 +1,6 @@
 {
   "title": "Spotube",
-  "icon": "assets/spotube-logo-macos.png",
+  "icon": "assets/branding/spotube-logo-macos.png",
   "contents": [
     {
       "x": 448,

assets/fonts/Ubuntu_Mono/UFL.txt

@@ -0,0 +1,96 @@
+-------------------------------
+UBUNTU FONT LICENCE Version 1.0
+-------------------------------
+
+PREAMBLE
+This licence allows the licensed fonts to be used, studied, modified and
+redistributed freely. The fonts, including any derivative works, can be
+bundled, embedded, and redistributed provided the terms of this licence
+are met. The fonts and derivatives, however, cannot be released under
+any other licence. The requirement for fonts to remain under this
+licence does not require any document created using the fonts or their
+derivatives to be published under this licence, as long as the primary
+purpose of the document is not to be a vehicle for the distribution of
+the fonts.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this licence and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Original Version" refers to the collection of Font Software components
+as received under this licence.
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to
+a new environment.
+
+"Copyright Holder(s)" refers to all individuals and companies who have a
+copyright ownership of the Font Software.
+
+"Substantially Changed" refers to Modified Versions which can be easily
+identified as dissimilar to the Font Software by users of the Font
+Software comparing the Original Version with the Modified Version.
+
+To "Propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification and with or without charging
+a redistribution fee), making available to the public, and in some
+countries other activities as well.
+
+PERMISSION & CONDITIONS
+This licence does not grant any rights under trademark law and all such
+rights are reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to propagate the Font Software, subject to
+the below conditions:
+
+1) Each copy of the Font Software must contain the above copyright
+notice and this licence. These can be included either as stand-alone
+text files, human-readable headers or in the appropriate machine-
+readable metadata fields within text or binary files as long as those
+fields can be easily viewed by the user.
+
+2) The font name complies with the following:
+(a) The Original Version must retain its name, unmodified.
+(b) Modified Versions which are Substantially Changed must be renamed to
+avoid use of the name of the Original Version or similar names entirely.
+(c) Modified Versions which are not Substantially Changed must be
+renamed to both (i) retain the name of the Original Version and (ii) add
+additional naming elements to distinguish the Modified Version from the
+Original Version. The name of such Modified Versions must be the name of
+the Original Version, with "derivative X" where X represents the name of
+the new work, appended to that name.
+
+3) The name(s) of the Copyright Holder(s) and any contributor to the
+Font Software shall not be used to promote, endorse or advertise any
+Modified Version, except (i) as required by this licence, (ii) to
+acknowledge the contribution(s) of the Copyright Holder(s) or (iii) with
+their explicit written permission.
+
+4) The Font Software, modified or unmodified, in part or in whole, must
+be distributed entirely under this licence, and must not be distributed
+under any other licence. The requirement for fonts to remain under this
+licence does not affect any document created using the Font Software,
+except any version of the Font Software extracted from a document
+created using the Font Software may only be distributed under this
+licence.
+
+TERMINATION
+This licence becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+DEALINGS IN THE FONT SOFTWARE.

choco-struct/spotube.nuspec

@@ -15,7 +15,7 @@ enclosed in quotation marks, you should use an editor that supports UTF-8, not t
     <authors>Kingkor Roy Tirtho</authors>
     <projectUrl>https://spotube.krtirtho.dev</projectUrl>
     <iconUrl>
-      https://rawcdn.githack.com/KRTirtho/spotube/7edb0bb834eb18c05551e30a891720a6abf53dbe/assets/spotube-logo.png</iconUrl>
+      https://rawcdn.githack.com/KRTirtho/spotube/7edb0bb834eb18c05551e30a891720a6abf53dbe/assets/branding/spotube-logo.png</iconUrl>
     <copyright>2022 Spotube</copyright>
     <!-- If there is a license Url available, it is required for the community feed -->
     <licenseUrl>https://github.com/KRTirtho/spotube/blob/master/LICENSE</licenseUrl>

cli/commands/build/linux.dart

@@ -74,7 +74,7 @@ class LinuxBuildCommand extends Command with BuildCommandCommonSteps {
     ).copy(
       join(tempDir, "com.github.KRTirtho.Spotube.appdata.xml"),
     );
-    await File(join(cwd.path, "assets", "spotube-logo.png")).copy(
+    await File(join(cwd.path, "assets", "branding", "spotube-logo.png")).copy(
       join(tempDir, "spotube-logo.png"),
     );
 

cliff.toml

@@ -0,0 +1,92 @@
+# git-cliff ~ configuration file
+# https://git-cliff.org/docs/configuration
+
+
+[changelog]
+# A Tera template to be rendered for each release in the changelog.
+# See https://keats.github.io/tera/docs/#introduction
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}](<REPO>/compare/v{{ previous.version | trim_start_matches(pat="v") }}...v{{ version | trim_start_matches(pat="v") }}) ({{ timestamp | date(format="%Y-%m-%d") }})
+{% else %}\
+    ## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}**{{ commit.scope }}**: {% endif %}\
+            {% if commit.breaking %}[**breaking**] {% endif %}\
+            {{ commit.message | upper_first }}\
+    {% endfor %}
+{% endfor %}
+"""
+# Remove leading and trailing whitespaces from the changelog's body.
+trim = true
+# Render body even when there are no releases to process.
+render_always = true
+# An array of regex based postprocessors to modify the changelog.
+postprocessors = [
+    # Replace the placeholder <REPO> with a URL.
+    { pattern = '<REPO>', replace = "https://github.com/KRTirtho/spotube" },
+]
+# render body even when there are no releases to process
+# render_always = true
+# output file path
+# output = "test.md"
+
+[git]
+# Parse commits according to the conventional commits specification.
+# See https://www.conventionalcommits.org
+conventional_commits = true
+# Exclude commits that do not match the conventional commits specification.
+filter_unconventional = true
+# Require all commits to be conventional.
+# Takes precedence over filter_unconventional.
+require_conventional = false
+# Split commits on newlines, treating each line as an individual commit.
+split_commits = false
+# An array of regex based parsers to modify commit messages prior to further processing.
+commit_preprocessors = [
+    # Replace issue numbers with link templates to be updated in `changelog.postprocessors`.
+    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](<REPO>/issues/${2}))" },
+    # Check spelling of the commit message using https://github.com/crate-ci/typos.
+    # If the spelling is incorrect, it will be fixed automatically.
+    #{ pattern = '.*', replace_command = 'typos --write-changes -' },
+]
+# Prevent commits that are breaking from being excluded by commit parsers.
+protect_breaking_commits = false
+# An array of regex based parsers for extracting data from the commit message.
+# Assigns commits to groups.
+# Optionally sets the commit's scope and can decide to exclude commits from further processing.
+commit_parsers = [
+    { message = "^feat", group = "<!-- 0 -->Features" },
+    { message = "^fix", group = "<!-- 1 -->Bug Fixes" },
+    # { message = "^doc", group = "<!-- 3 -->📚 Documentation" },
+    # { message = "^perf", group = "<!-- 4 -->⚡ Performance" },
+    # { message = "^refactor", group = "<!-- 2 -->🚜 Refactor" },
+    # { message = "^style", group = "<!-- 5 -->🎨 Styling" },
+    # { message = "^test", group = "<!-- 6 -->🧪 Testing" },
+    # { message = "^chore\\(release\\): prepare for", skip = true },
+    # { message = "^chore\\(deps.*\\)", skip = true },
+    # { message = "^chore\\(pr\\)", skip = true },
+    # { message = "^chore\\(pull\\)", skip = true },
+    # { message = "^chore|^ci", group = "<!-- 7 -->⚙️ Miscellaneous Tasks" },
+    # { body = ".*security", group = "<!-- 8 -->🛡️ Security" },
+    # { message = "^revert", group = "<!-- 9 -->◀️ Revert" },
+    # { message = ".*", group = "<!-- 10 -->💼 Other" },
+]
+# Exclude commits that are not matched by any commit parser.
+filter_commits = true
+# An array of link parsers for extracting external references, and turning them into URLs, using regex.
+link_parsers = []
+# Include only the tags that belong to the current branch.
+use_branch_tags = false
+# Order releases topologically instead of chronologically.
+topo_order = false
+# Order releases topologically instead of chronologically.
+topo_order_commits = true
+# Order of commits in each group/release within the changelog.
+# Allowed values: newest, oldest
+sort_commits = "oldest"
+# Process submodules commits
+recurse_submodules = false

flutter_launcher_icons-nightly.yaml

@@ -1,6 +1,6 @@
 flutter_launcher_icons:
   android: true
   ios: true
-  image_path: "assets/spotube-nightly-logo.png"
-  adaptive_icon_foreground: "assets/spotube-nightly-logo-foreground.png"
+  image_path: "assets/branding/spotube-nightly-logo.png"
+  adaptive_icon_foreground: "assets/branding/spotube-nightly-logo-foreground.png"
   adaptive_icon_background: "#242832"

flutter_launcher_icons.yaml

@@ -1,19 +1,19 @@
 # flutter pub run flutter_launcher_icons
 flutter_launcher_icons:
-  image_path: "assets/spotube-logo.png"
+  image_path: "assets/branding/spotube-logo.png"
 
   android: true
-  # image_path_android: "assets/icon/icon.png"
+  # image_path_android: "assets/branding/icon/icon.png"
   min_sdk_android: 21 # android min sdk min:16, default 21
   adaptive_icon_background: "#242832"
-  adaptive_icon_foreground: "assets/spotube-logo-foreground.png"
-  # adaptive_icon_monochrome: "assets/icon/monochrome.png"
+  adaptive_icon_foreground: "assets/branding/spotube-logo-foreground.png"
+  # adaptive_icon_monochrome: "assets/branding/icon/monochrome.png"
 
   ios: true
-  # image_path_ios: "assets/icon/icon.png"
+  # image_path_ios: "assets/branding/icon/icon.png"
   remove_alpha_channel_ios: true
-  # image_path_ios_dark_transparent: "assets/icon/icon_dark.png"
-  # image_path_ios_tinted_grayscale: "assets/icon/icon_tinted.png"
+  # image_path_ios_dark_transparent: "assets/branding/icon/icon_dark.png"
+  # image_path_ios_tinted_grayscale: "assets/branding/icon/icon_tinted.png"
   # desaturate_tinted_to_grayscale_ios: true
 
   web:
@@ -21,9 +21,9 @@ flutter_launcher_icons:
 
   windows:
     generate: true
-    image_path: "assets/spotube-logo.png"
+    image_path: "assets/branding/spotube-logo.png"
     icon_size: 48 # min:48, max:256, default: 48
 
   macos:
     generate: true
-    image_path: "assets/spotube-logo-macos.png"
+    image_path: "assets/branding/spotube-logo-macos.png"

flutter_native_splash-nightly.yaml

@@ -1,9 +1,9 @@
 flutter_native_splash:
-  background_image: assets/bengali-patterns-bg.jpg
-  image: assets/spotube-nightly-logo.png
-  branding: assets/branding.png
+  background_image: assets/images/bengali-patterns-bg.jpg
+  image: assets/branding/spotube-nightly-logo.png
+  branding: assets/branding/branding.png
   android_12:
-    image: assets/spotube-nightly-logo_android12.png
-    branding: assets/branding.png
+    image: assets/branding/spotube-nightly-logo_android12.png
+    branding: assets/branding/branding.png
     color: "#000000"
     icon_background_color: "#000000"

l10n.yaml

@@ -2,4 +2,3 @@ arb-dir: lib/l10n
 template-arb-file: app_en.arb
 output-dir: lib/l10n/generated
 untranslated-messages-file: untranslated_messages.json
-synthetic-package: false

lib/collections/assets.gen.dart

@@ -9,220 +9,89 @@
 
 import 'package:flutter/widgets.dart';
 
-class $AssetsBackgroundsGen {
-  const $AssetsBackgroundsGen();
+class $AssetsBrandingGen {
+  const $AssetsBrandingGen();
 
-  /// File path: assets/backgrounds/xmas-effect.png
-  AssetGenImage get xmasEffect =>
-      const AssetGenImage('assets/backgrounds/xmas-effect.png');
+  /// File path: assets/branding/spotube-logo-light.png
+  AssetGenImage get spotubeLogoLight =>
+      const AssetGenImage('assets/branding/spotube-logo-light.png');
+
+  /// File path: assets/branding/spotube-logo.ico
+  String get spotubeLogoIco => 'assets/branding/spotube-logo.ico';
+
+  /// File path: assets/branding/spotube-logo.png
+  AssetGenImage get spotubeLogoPng =>
+      const AssetGenImage('assets/branding/spotube-logo.png');
 
   /// List of all assets
-  List<AssetGenImage> get values => [xmasEffect];
+  List<dynamic> get values =>
+      [spotubeLogoLight, spotubeLogoIco, spotubeLogoPng];
 }
 
-class $AssetsLogosGen {
-  const $AssetsLogosGen();
+class $AssetsImagesGen {
+  const $AssetsImagesGen();
 
-  /// File path: assets/logos/songlink-transparent.png
-  AssetGenImage get songlinkTransparent =>
-      const AssetGenImage('assets/logos/songlink-transparent.png');
+  /// File path: assets/images/album-placeholder.png
+  AssetGenImage get albumPlaceholder =>
+      const AssetGenImage('assets/images/album-placeholder.png');
 
-  /// File path: assets/logos/songlink.png
-  AssetGenImage get songlink =>
-      const AssetGenImage('assets/logos/songlink.png');
+  /// File path: assets/images/bengali-patterns-bg.jpg
+  AssetGenImage get bengaliPatternsBg =>
+      const AssetGenImage('assets/images/bengali-patterns-bg.jpg');
 
-  /// List of all assets
-  List<AssetGenImage> get values => [songlinkTransparent, songlink];
-}
+  /// File path: assets/images/liked-tracks.jpg
+  AssetGenImage get likedTracks =>
+      const AssetGenImage('assets/images/liked-tracks.jpg');
 
-class $AssetsPatternsGen {
-  const $AssetsPatternsGen();
+  /// Directory path: assets/images/logos
+  $AssetsImagesLogosGen get logos => const $AssetsImagesLogosGen();
 
-  /// File path: assets/patterns/black_white_visualized.jpg
-  AssetGenImage get blackWhiteVisualized =>
-      const AssetGenImage('assets/patterns/black_white_visualized.jpg');
+  /// File path: assets/images/placeholder.png
+  AssetGenImage get placeholder =>
+      const AssetGenImage('assets/images/placeholder.png');
 
-  /// File path: assets/patterns/brazil_carnival.jpg
-  AssetGenImage get brazilCarnival =>
-      const AssetGenImage('assets/patterns/brazil_carnival.jpg');
-
-  /// File path: assets/patterns/cotton_balls.jpg
-  AssetGenImage get cottonBalls =>
-      const AssetGenImage('assets/patterns/cotton_balls.jpg');
-
-  /// File path: assets/patterns/cute_worms.jpg
-  AssetGenImage get cuteWorms =>
-      const AssetGenImage('assets/patterns/cute_worms.jpg');
-
-  /// File path: assets/patterns/flash_cross_axis.jpg
-  AssetGenImage get flashCrossAxis =>
-      const AssetGenImage('assets/patterns/flash_cross_axis.jpg');
-
-  /// File path: assets/patterns/memphis_shapes.jpg
-  AssetGenImage get memphisShapes =>
-      const AssetGenImage('assets/patterns/memphis_shapes.jpg');
-
-  /// File path: assets/patterns/oval_gloomy.jpg
-  AssetGenImage get ovalGloomy =>
-      const AssetGenImage('assets/patterns/oval_gloomy.jpg');
-
-  /// File path: assets/patterns/oval_sunny.jpg
-  AssetGenImage get ovalSunny =>
-      const AssetGenImage('assets/patterns/oval_sunny.jpg');
-
-  /// File path: assets/patterns/red_nimbuses.jpg
-  AssetGenImage get redNimbuses =>
-      const AssetGenImage('assets/patterns/red_nimbuses.jpg');
-
-  /// File path: assets/patterns/tree_bark.jpg
-  AssetGenImage get treeBark =>
-      const AssetGenImage('assets/patterns/tree_bark.jpg');
-
-  /// File path: assets/patterns/vibrant_pentagons.jpg
-  AssetGenImage get vibrantPentagons =>
-      const AssetGenImage('assets/patterns/vibrant_pentagons.jpg');
-
-  /// File path: assets/patterns/wiring_pattern.jpg
-  AssetGenImage get wiringPattern =>
-      const AssetGenImage('assets/patterns/wiring_pattern.jpg');
-
-  /// File path: assets/patterns/zigzags_gloomy.jpg
-  AssetGenImage get zigzagsGloomy =>
-      const AssetGenImage('assets/patterns/zigzags_gloomy.jpg');
-
-  /// File path: assets/patterns/zigzags_sunny.jpg
-  AssetGenImage get zigzagsSunny =>
-      const AssetGenImage('assets/patterns/zigzags_sunny.jpg');
+  /// File path: assets/images/user-placeholder.png
+  AssetGenImage get userPlaceholder =>
+      const AssetGenImage('assets/images/user-placeholder.png');
 
   /// List of all assets
   List<AssetGenImage> get values => [
-        blackWhiteVisualized,
-        brazilCarnival,
-        cottonBalls,
-        cuteWorms,
-        flashCrossAxis,
-        memphisShapes,
-        ovalGloomy,
-        ovalSunny,
-        redNimbuses,
-        treeBark,
-        vibrantPentagons,
-        wiringPattern,
-        zigzagsGloomy,
-        zigzagsSunny
+        albumPlaceholder,
+        bengaliPatternsBg,
+        likedTracks,
+        placeholder,
+        userPlaceholder
       ];
 }
 
-class $AssetsTutorialGen {
-  const $AssetsTutorialGen();
+class $AssetsImagesLogosGen {
+  const $AssetsImagesLogosGen();
 
-  /// File path: assets/tutorial/step-1.png
-  AssetGenImage get step1 => const AssetGenImage('assets/tutorial/step-1.png');
+  /// File path: assets/images/logos/invidious.jpg
+  AssetGenImage get invidious =>
+      const AssetGenImage('assets/images/logos/invidious.jpg');
 
-  /// File path: assets/tutorial/step-2.png
-  AssetGenImage get step2 => const AssetGenImage('assets/tutorial/step-2.png');
+  /// File path: assets/images/logos/jiosaavn.png
+  AssetGenImage get jiosaavn =>
+      const AssetGenImage('assets/images/logos/jiosaavn.png');
 
-  /// File path: assets/tutorial/step-3.png
-  AssetGenImage get step3 => const AssetGenImage('assets/tutorial/step-3.png');
+  /// File path: assets/images/logos/songlink-transparent.png
+  AssetGenImage get songlinkTransparent =>
+      const AssetGenImage('assets/images/logos/songlink-transparent.png');
 
   /// List of all assets
-  List<AssetGenImage> get values => [step1, step2, step3];
+  List<AssetGenImage> get values => [invidious, jiosaavn, songlinkTransparent];
 }
 
 class Assets {
   Assets._();
 
   static const String license = 'LICENSE';
-  static const AssetGenImage albumPlaceholder =
-      AssetGenImage('assets/album-placeholder.png');
-  static const $AssetsBackgroundsGen backgrounds = $AssetsBackgroundsGen();
-  static const AssetGenImage bengaliPatternsBg =
-      AssetGenImage('assets/bengali-patterns-bg.jpg');
-  static const AssetGenImage branding = AssetGenImage('assets/branding.png');
-  static const AssetGenImage emptyBox = AssetGenImage('assets/empty_box.png');
-  static const AssetGenImage invidious = AssetGenImage('assets/invidious.jpg');
-  static const AssetGenImage jiosaavn = AssetGenImage('assets/jiosaavn.png');
-  static const AssetGenImage likedTracks =
-      AssetGenImage('assets/liked-tracks.jpg');
-  static const $AssetsLogosGen logos = $AssetsLogosGen();
-  static const $AssetsPatternsGen patterns = $AssetsPatternsGen();
-  static const AssetGenImage placeholder =
-      AssetGenImage('assets/placeholder.png');
-  static const AssetGenImage spotubeHeroBanner =
-      AssetGenImage('assets/spotube-hero-banner.png');
-  static const AssetGenImage spotubeLogoForeground =
-      AssetGenImage('assets/spotube-logo-foreground.png');
-  static const AssetGenImage spotubeLogoItem =
-      AssetGenImage('assets/spotube-logo-item.png');
-  static const AssetGenImage spotubeLogoLight =
-      AssetGenImage('assets/spotube-logo-light.png');
-  static const AssetGenImage spotubeLogoMacos =
-      AssetGenImage('assets/spotube-logo-macos.png');
-  static const AssetGenImage spotubeLogoBmp =
-      AssetGenImage('assets/spotube-logo.bmp');
-  static const String spotubeLogoIco = 'assets/spotube-logo.ico';
-  static const AssetGenImage spotubeLogoPng =
-      AssetGenImage('assets/spotube-logo.png');
-  static const AssetGenImage spotubeLogoAndroid12 =
-      AssetGenImage('assets/spotube-logo_android12.png');
-  static const AssetGenImage spotubeNightlyItem =
-      AssetGenImage('assets/spotube-nightly-item.png');
-  static const AssetGenImage spotubeNightlyLogoForegroundPng =
-      AssetGenImage('assets/spotube-nightly-logo-foreground.png');
-  static const String spotubeNightlyLogoForegroundSvg =
-      'assets/spotube-nightly-logo-foreground.svg';
-  static const AssetGenImage spotubeNightlyLogo =
-      AssetGenImage('assets/spotube-nightly-logo.png');
-  static const AssetGenImage spotubeNightlyLogoAndroid12 =
-      AssetGenImage('assets/spotube-nightly-logo_android12.png');
-  static const AssetGenImage spotubeScreenshot =
-      AssetGenImage('assets/spotube-screenshot.png');
-  static const AssetGenImage spotubeTallCapsule =
-      AssetGenImage('assets/spotube-tall-capsule.png');
-  static const AssetGenImage spotubeWideCapsuleLarge =
-      AssetGenImage('assets/spotube-wide-capsule-large.png');
-  static const AssetGenImage spotubeWideCapsuleSmall =
-      AssetGenImage('assets/spotube-wide-capsule-small.png');
-  static const AssetGenImage spotubeBanner =
-      AssetGenImage('assets/spotube_banner.png');
-  static const AssetGenImage success = AssetGenImage('assets/success.png');
-  static const $AssetsTutorialGen tutorial = $AssetsTutorialGen();
-  static const AssetGenImage userPlaceholder =
-      AssetGenImage('assets/user-placeholder.png');
+  static const $AssetsBrandingGen branding = $AssetsBrandingGen();
+  static const $AssetsImagesGen images = $AssetsImagesGen();
 
   /// List of all assets
-  static List<dynamic> get values => [
-        license,
-        albumPlaceholder,
-        bengaliPatternsBg,
-        branding,
-        emptyBox,
-        invidious,
-        jiosaavn,
-        likedTracks,
-        placeholder,
-        spotubeHeroBanner,
-        spotubeLogoForeground,
-        spotubeLogoItem,
-        spotubeLogoLight,
-        spotubeLogoMacos,
-        spotubeLogoBmp,
-        spotubeLogoIco,
-        spotubeLogoPng,
-        spotubeLogoAndroid12,
-        spotubeNightlyItem,
-        spotubeNightlyLogoForegroundPng,
-        spotubeNightlyLogoForegroundSvg,
-        spotubeNightlyLogo,
-        spotubeNightlyLogoAndroid12,
-        spotubeScreenshot,
-        spotubeTallCapsule,
-        spotubeWideCapsuleLarge,
-        spotubeWideCapsuleSmall,
-        spotubeBanner,
-        success,
-        userPlaceholder
-      ];
+  static List<String> get values => [license];
 }
 
 class AssetGenImage {

lib/collections/env.dart

@@ -10,9 +10,6 @@ enum ReleaseChannel {
 
 @Envied(obfuscate: true, requireEnvFile: true, path: ".env")
 abstract class Env {
-  @EnviedField(varName: 'SPOTIFY_SECRETS')
-  static final String rawSpotifySecrets = _Env.rawSpotifySecrets;
-
   @EnviedField(varName: 'LASTFM_API_KEY')
   static final String lastFmApiKey = _Env.lastFmApiKey;
 
@@ -24,25 +21,12 @@ abstract class Env {
 
   static bool get hideDonations => _hideDonations == 1;
 
-  static final spotifySecrets = rawSpotifySecrets.split(',').map((e) {
-    final secrets = e.trim().split(":").map((e) => e.trim());
-    return {
-      "clientId": secrets.first,
-      "clientSecret": secrets.last,
-    };
-  }).toList();
-
   @EnviedField(varName: 'ENABLE_UPDATE_CHECK', defaultValue: "1")
   static final String _enableUpdateChecker = _Env._enableUpdateChecker;
 
   @EnviedField(varName: "RELEASE_CHANNEL", defaultValue: "nightly")
   static final String _releaseChannel = _Env._releaseChannel;
 
-  @EnviedField(varName: "DISABLE_SPOTIFY_IMAGES", defaultValue: "0")
-  static final String _disableSpotifyImages = _Env._disableSpotifyImages;
-
-  static bool get disableSpotifyImages => _disableSpotifyImages == "1";
-
   static ReleaseChannel get releaseChannel => _releaseChannel == "stable"
       ? ReleaseChannel.stable
       : ReleaseChannel.nightly;

lib/collections/fake.dart

@@ -1,231 +1,112 @@
-import 'package:spotify/spotify.dart';
 import 'package:spotube/models/database/database.dart';
-import 'package:spotube/models/spotify/home_feed.dart';
-import 'package:spotube/models/spotify_friends.dart';
+import 'package:spotube/models/metadata/metadata.dart';
 import 'package:spotube/provider/history/summary.dart';
 
 abstract class FakeData {
-  static final Image image = Image()
-    ..height = 1
-    ..width = 1
-    ..url = "https://dummyimage.com/100x100/cfcfcf/cfcfcf.jpg";
+  static final SpotubeImageObject image = SpotubeImageObject(
+    height: 100,
+    width: 100,
+    url: "https://dummyimage.com/100x100/cfcfcf/cfcfcf.jpg",
+  );
 
-  static final Followers followers = Followers()
-    ..href = "text"
-    ..total = 1;
-
-  static final Artist artist = Artist()
-    ..id = "1"
-    ..name = "Wow artist Good!"
-    ..images = [image]
-    ..popularity = 1
-    ..type = "type"
-    ..uri = "uri"
-    ..externalUrls = externalUrls
-    ..genres = ["genre"]
-    ..href = "text"
-    ..followers = followers;
-
-  static final externalIds = ExternalIds()
-    ..isrc = "text"
-    ..ean = "text"
-    ..upc = "text";
-
-  static final externalUrls = ExternalUrls()..spotify = "text";
-
-  static final Album album = Album()
-    ..id = "1"
-    ..genres = ["genre"]
-    ..label = "label"
-    ..popularity = 1
-    ..albumType = AlbumType.album
-    ..artists = [artist]
-    ..availableMarkets = [Market.BD]
-    ..externalUrls = externalUrls
-    ..href = "text"
-    ..images = [image]
-    ..name = "Another good album"
-    ..releaseDate = "2021-01-01"
-    ..releaseDatePrecision = DatePrecision.day
-    ..tracks = [track]
-    ..type = "type"
-    ..uri = "uri"
-    ..externalIds = externalIds
-    ..copyrights = [
-      Copyright()
-        ..type = CopyrightType.C
-        ..text = "text",
-    ];
-
-  static final ArtistSimple artistSimple = ArtistSimple()
-    ..id = "1"
-    ..name = "What an artist"
-    ..type = "type"
-    ..uri = "uri"
-    ..externalUrls = externalUrls;
-
-  static final AlbumSimple albumSimple = AlbumSimple()
-    ..id = "1"
-    ..albumType = AlbumType.album
-    ..artists = [artistSimple]
-    ..availableMarkets = [Market.BD]
-    ..externalUrls = externalUrls
-    ..href = "text"
-    ..images = [image]
-    ..name = "A good album"
-    ..releaseDate = "2021-01-01"
-    ..releaseDatePrecision = DatePrecision.day
-    ..type = "type"
-    ..uri = "uri";
-
-  static final Track track = Track()
-    ..id = "1"
-    ..artists = [artist, artist, artist]
-    ..album = albumSimple
-    ..availableMarkets = [Market.BD]
-    ..discNumber = 1
-    ..durationMs = 50000
-    ..explicit = false
-    ..externalUrls = externalUrls
-    ..href = "text"
-    ..name = "A Track Name"
-    ..popularity = 1
-    ..previewUrl = "url"
-    ..trackNumber = 1
-    ..type = "type"
-    ..uri = "uri"
-    ..externalIds = externalIds
-    ..isPlayable = true
-    ..explicit = false
-    ..linkedFrom = trackLink;
-
-  static final TrackLink trackLink = TrackLink()
-    ..id = "1"
-    ..type = "type"
-    ..uri = "uri"
-    ..externalUrls = {"spotify": "text"}
-    ..href = "text";
-
-  static final Paging<Track> paging = Paging()
-    ..href = "text"
-    ..itemsNative = [track.toJson()]
-    ..limit = 1
-    ..next = "text"
-    ..offset = 1
-    ..previous = "text"
-    ..total = 1;
-
-  static final User user = User()
-    ..id = "1"
-    ..displayName = "Your Name"
-    ..birthdate = "2021-01-01"
-    ..country = Market.BD
-    ..email = "test@email.com"
-    ..followers = followers
-    ..href = "text"
-    ..images = [image]
-    ..type = "type"
-    ..uri = "uri";
-
-  static final TracksLink tracksLink = TracksLink()
-    ..href = "text"
-    ..total = 1;
-
-  static final Playlist playlist = Playlist()
-    ..id = "1"
-    ..collaborative = false
-    ..description = "A very good playlist description"
-    ..externalUrls = externalUrls
-    ..followers = followers
-    ..href = "text"
-    ..images = [image]
-    ..name = "A good playlist"
-    ..owner = user
-    ..public = true
-    ..snapshotId = "text"
-    ..tracks = paging
-    ..tracksLink = tracksLink
-    ..type = "type"
-    ..uri = "uri";
-
-  static final PlaylistSimple playlistSimple = PlaylistSimple()
-    ..id = "1"
-    ..collaborative = false
-    ..externalUrls = externalUrls
-    ..href = "text"
-    ..images = [image]
-    ..name = "A good playlist"
-    ..owner = user
-    ..public = true
-    ..snapshotId = "text"
-    ..tracksLink = tracksLink
-    ..type = "type"
-    ..description = "A very good playlist description"
-    ..uri = "uri";
-
-  static final Category category = Category()
-    ..href = "text"
-    ..icons = [image]
-    ..id = "1"
-    ..name = "category";
-
-  static final friends = SpotifyFriends(
-    friends: [
-      for (var i = 0; i < 3; i++)
-        SpotifyFriendActivity(
-          user: const SpotifyFriend(
-            name: "name",
-            imageUrl: "imageUrl",
-            uri: "uri",
-          ),
-          track: SpotifyActivityTrack(
-            name: "name",
-            artist: const SpotifyActivityArtist(
-              name: "name",
-              uri: "uri",
-            ),
-            album: const SpotifyActivityAlbum(
-              name: "name",
-              uri: "uri",
-            ),
-            context: SpotifyActivityContext(
-              name: "name",
-              index: i,
-              uri: "uri",
-            ),
-            imageUrl: "imageUrl",
-            uri: "uri",
-          ),
-        ),
+  static final SpotubeFullArtistObject artist = SpotubeFullArtistObject(
+    id: "1",
+    name: "What an artist",
+    externalUri: "https://example.com",
+    followers: 10000,
+    genres: ["genre"],
+    images: [
+      SpotubeImageObject(
+        height: 100,
+        width: 100,
+        url: "https://dummyimage.com/100x100/cfcfcf/cfcfcf.jpg",
+      ),
     ],
   );
 
-  static final feedSection = SpotifyHomeFeedSection(
-    typename: "HomeGenericSectionData",
-    uri: "spotify:section:lol",
-    title: "Dummy",
-    items: [
-      for (int i = 0; i < 10; i++)
-        SpotifyHomeFeedSectionItem(
-          typename: "PlaylistResponseWrapper",
-          playlist: SpotifySectionPlaylist(
-            name: "Playlist $i",
-            description: "Really super important description $i",
-            format: "daily-mix",
-            images: [
-              const SpotifySectionItemImage(
-                height: 1,
-                width: 1,
-                url: "https://dummyimage.com/100x100/cfcfcf/cfcfcf.jpg",
-              ),
-            ],
-            owner: "Spotify",
-            uri: "spotify:playlist:id",
-          ),
-        )
+  static final SpotubeFullAlbumObject album = SpotubeFullAlbumObject(
+    id: "1",
+    name: "A good album",
+    externalUri: "https://example.com",
+    artists: [artistSimple],
+    releaseDate: "2021-01-01",
+    albumType: SpotubeAlbumType.album,
+    images: [image],
+    totalTracks: 10,
+    genres: ["genre"],
+    recordLabel: "Record Label",
+  );
+
+  static final SpotubeSimpleArtistObject artistSimple =
+      SpotubeSimpleArtistObject(
+    id: "1",
+    name: "What an artist",
+    externalUri: "https://example.com",
+    images: null,
+  );
+
+  static final SpotubeSimpleAlbumObject albumSimple = SpotubeSimpleAlbumObject(
+    albumType: SpotubeAlbumType.album,
+    artists: [],
+    externalUri: "https://example.com",
+    id: "1",
+    name: "A good album",
+    releaseDate: "2021-01-01",
+    images: [
+      SpotubeImageObject(
+        height: 1,
+        width: 1,
+        url: "https://dummyimage.com/100x100/cfcfcf/cfcfcf.jpg",
+      )
     ],
   );
 
+  static final SpotubeFullTrackObject track = SpotubeTrackObject.full(
+    id: "1",
+    name: "A good track",
+    externalUri: "https://example.com",
+    album: albumSimple,
+    durationMs: 3 * 60 * 1000, // 3 minutes
+    isrc: "USUM72112345",
+    explicit: false,
+  ) as SpotubeFullTrackObject;
+
+  static final SpotubeUserObject user = SpotubeUserObject(
+    id: "1",
+    name: "User Name",
+    externalUri: "https://example.com",
+    images: [image],
+  );
+
+  static final SpotubeFullPlaylistObject playlist = SpotubeFullPlaylistObject(
+      id: "1",
+      name: "A good playlist",
+      description: "A very good playlist description",
+      externalUri: "https://example.com",
+      collaborative: false,
+      public: true,
+      owner: user,
+      images: [image],
+      collaborators: [user]);
+
+  static final SpotubeSimplePlaylistObject playlistSimple =
+      SpotubeSimplePlaylistObject(
+    id: "1",
+    name: "A good playlist",
+    description: "A very good playlist description",
+    externalUri: "https://example.com",
+    owner: user,
+    images: [image],
+  );
+
+  static final SpotubeBrowseSectionObject browseSection =
+      SpotubeBrowseSectionObject(
+          id: "section-id",
+          title: "Browse Section",
+          browseMore: true,
+          externalUri: "https://example.com/browse/section",
+          items: [playlistSimple, playlistSimple, playlistSimple]);
+
   static const historySummary = PlaybackHistorySummary(
     albums: 1,
     artists: 1,

lib/collections/fonts.gen.dart

@@ -13,6 +13,12 @@ class FontFamily {
   /// Font family: BootstrapIcons
   static const String bootstrapIcons = 'BootstrapIcons';
 
+  /// Font family: Cookie
+  static const String cookie = 'Cookie';
+
   /// Font family: RadixIcons
   static const String radixIcons = 'RadixIcons';
+
+  /// Font family: Ubuntu Mono
+  static const String ubuntuMono = 'Ubuntu Mono';
 }

lib/collections/http-override.dart

@@ -0,0 +1,17 @@
+import 'dart:io';
+
+const allowList = [
+  "spotify.com",
+];
+
+class BadCertificateAllowlistOverrides extends HttpOverrides {
+  @override
+  HttpClient createHttpClient(SecurityContext? context) {
+    return super.createHttpClient(context)
+      ..badCertificateCallback = (X509Certificate cert, String host, int port) {
+        return allowList.any((allowedHost) {
+          return host.endsWith(allowedHost);
+        });
+      };
+  }
+}

lib/collections/language_codes.dart

@@ -137,6 +137,10 @@ abstract class LanguageLocals {
       name: "Simplified Chinese",
       nativeName: "简体中文",
     ),
+    "zh_TW": const ISOLanguageName(
+      name: "Traditional Chinese",
+      nativeName: "繁體中文（台灣）",
+    ),
     // "cv": const ISOLanguageName(
     //   name: "Chuvash",
     //   nativeName: "чӑваш чӗлхи",

lib/collections/markets.dart

@@ -1,8 +1,8 @@
 // Country Codes contributed by momobobe <https://github.com/momobobe>
 
-import 'package:spotify/spotify.dart';
+import 'package:spotube/models/metadata/market.dart';
 
-final spotifyMarkets = [
+final marketsMap = [
   (Market.AL, "Albania (AL)"),
   (Market.DZ, "Algeria (DZ)"),
   (Market.AD, "Andorra (AD)"),

lib/collections/routes.dart

@@ -3,7 +3,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:hooks_riverpod/hooks_riverpod.dart';
 import 'package:spotube/collections/routes.gr.dart';
-import 'package:spotube/provider/authentication/authentication.dart';
+import 'package:spotube/provider/metadata_plugin/core/auth.dart';
 import 'package:spotube/services/kv_store/kv_store.dart';
 
 final rootNavigatorKey = GlobalKey<NavigatorState>();
@@ -28,9 +28,10 @@ class AppRouter extends RootStackRouter {
               guards: [
                 AutoRouteGuardCallback(
                   (resolver, router) async {
-                    final auth = await ref.read(authenticationProvider.future);
+                    final authenticated = await ref
+                        .read(metadataPluginAuthenticatedProvider.future);
 
-                    if (auth == null && !KVStoreService.doneGettingStarted) {
+                    if (!authenticated && !KVStoreService.doneGettingStarted) {
                       resolver.redirect(const GettingStartedRoute());
                     } else {
                       resolver.next(true);
@@ -40,16 +41,8 @@ class AppRouter extends RootStackRouter {
               ],
             ),
             AutoRoute(
-              path: "home/genres",
-              page: GenreRoute.page,
-            ),
-            AutoRoute(
-              path: "home/genre/:categoryId",
-              page: GenrePlaylistsRoute.page,
-            ),
-            AutoRoute(
-              path: "home/feeds/:feedId",
-              page: HomeFeedSectionRoute.page,
+              path: "home/sections/:sectionId",
+              page: HomeBrowseSectionItemsRoute.page,
             ),
             AutoRoute(
               path: "search",
@@ -86,14 +79,6 @@ class AppRouter extends RootStackRouter {
               page: LocalLibraryRoute.page,
               // parentNavigatorKey: shellRouteNavigatorKey,
             ),
-            AutoRoute(
-              path: "library/generate",
-              page: PlaylistGeneratorRoute.page,
-            ),
-            AutoRoute(
-              path: "library/generate/result",
-              page: PlaylistGenerateResultRoute.page,
-            ),
             AutoRoute(
               path: "lyrics",
               page: LyricsRoute.page,
@@ -102,6 +87,14 @@ class AppRouter extends RootStackRouter {
               path: "settings",
               page: SettingsRoute.page,
             ),
+            AutoRoute(
+              path: "settings/metadata-provider",
+              page: SettingsMetadataProviderRoute.page,
+            ),
+            AutoRoute(
+              path: "settings/metadata-provider/metadata-form",
+              page: SettingsMetadataProviderFormRoute.page,
+            ),
             AutoRoute(
               path: "settings/blacklist",
               page: BlackListRoute.page,
@@ -115,6 +108,10 @@ class AppRouter extends RootStackRouter {
               path: "settings/about",
               page: AboutSpotubeRoute.page,
             ),
+            AutoRoute(
+              path: "settings/scrobbling",
+              page: SettingsScrobblingRoute.page,
+            ),
             AutoRoute(
               path: "album/:id",
               page: AlbumRoute.page,
@@ -221,11 +218,6 @@ class AppRouter extends RootStackRouter {
           page: GettingStartedRoute.page,
           // parentNavigatorKey: rootNavigatorKey,
         ),
-        AutoRoute(
-          path: "/login",
-          page: WebViewLoginRoute.page,
-          // parentNavigatorKey: rootNavigatorKey,
-        ),
         AutoRoute(
           path: "/lastfm-login",
           page: LastFMLoginRoute.page,

lib/collections/spotube_icons.dart

@@ -105,7 +105,6 @@ abstract class SpotubeIcons {
   static const file = FeatherIcons.file;
   static const stream = Icons.stream_rounded;
   static const lastFm = SimpleIcons.lastdotfm;
-  static const spotify = SimpleIcons.spotify;
   static const eye = FeatherIcons.eye;
   static const noEye = FeatherIcons.eyeOff;
   static const normalize = FeatherIcons.barChart2;
@@ -135,4 +134,9 @@ abstract class SpotubeIcons {
   static const list = FeatherIcons.list;
   static const device = FeatherIcons.smartphone;
   static const engine = FeatherIcons.server;
+  static const extensions = FeatherIcons.package;
+  static const message = FeatherIcons.send;
+  static const upload = FeatherIcons.uploadCloud;
+  static const plugin = Icons.extension_outlined;
+  static const warning = FeatherIcons.alertTriangle;
 }

lib/components/dialogs/playlist_add_track_dialog.dart

@@ -1,18 +1,18 @@
 import 'package:flutter_hooks/flutter_hooks.dart';
 import 'package:hooks_riverpod/hooks_riverpod.dart';
 import 'package:shadcn_flutter/shadcn_flutter.dart';
+import 'package:spotube/models/metadata/metadata.dart';
 
-import 'package:spotify/spotify.dart';
 import 'package:spotube/modules/playlist/playlist_create_dialog.dart';
 import 'package:spotube/components/image/universal_image.dart';
 import 'package:spotube/extensions/context.dart';
-import 'package:spotube/extensions/image.dart';
-import 'package:spotube/provider/spotify/spotify.dart';
+import 'package:spotube/provider/metadata_plugin/library/playlists.dart';
+import 'package:spotube/provider/metadata_plugin/core/user.dart';
 
 class PlaylistAddTrackDialog extends HookConsumerWidget {
   /// The id of the playlist this dialog was opened from
   final String? openFromPlaylist;
-  final List<Track> tracks;
+  final List<SpotubeTrackObject> tracks;
   const PlaylistAddTrackDialog({
     required this.tracks,
     required this.openFromPlaylist,
@@ -22,24 +22,23 @@ class PlaylistAddTrackDialog extends HookConsumerWidget {
   @override
   Widget build(BuildContext context, ref) {
     final typography = Theme.of(context).typography;
-    final userPlaylists = ref.watch(favoritePlaylistsProvider);
+    final userPlaylists = ref.watch(metadataPluginSavedPlaylistsProvider);
     final favoritePlaylistsNotifier =
-        ref.watch(favoritePlaylistsProvider.notifier);
+        ref.watch(metadataPluginSavedPlaylistsProvider.notifier);
 
-    final me = ref.watch(meProvider);
+    final me = ref.watch(metadataPluginUserProvider);
 
     final filteredPlaylists = useMemoized(
       () =>
           userPlaylists.asData?.value.items
               .where(
                 (playlist) =>
-                    playlist.owner?.id != null &&
-                    playlist.owner!.id == me.asData?.value.id &&
+                    playlist.owner.id == me.asData?.value?.id &&
                     playlist.id != openFromPlaylist,
               )
               .toList() ??
           [],
-      [userPlaylists.asData?.value, me.asData?.value.id, openFromPlaylist],
+      [userPlaylists.asData?.value, me.asData?.value?.id, openFromPlaylist],
     );
 
     final playlistsCheck = useState(<String, bool>{});
@@ -60,7 +59,7 @@ class PlaylistAddTrackDialog extends HookConsumerWidget {
         selectedPlaylists.map(
           (playlistId) => favoritePlaylistsNotifier.addTracks(
             playlistId,
-            tracks.map((e) => e.id!).toList(),
+            tracks.map((e) => e.id).toList(),
           ),
         ),
       ).then((_) => context.mounted ? Navigator.pop(context, true) : null);
@@ -109,8 +108,7 @@ class PlaylistAddTrackDialog extends HookConsumerWidget {
                         },
                       ),
                       leading: Avatar(
-                        initials:
-                            Avatar.getInitials(playlist.name ?? "Playlist"),
+                        initials: Avatar.getInitials(playlist.name),
                         provider: UniversalImage.imageProvider(
                           playlist.images.asUrlString(
                             placeholder: ImagePlaceholder.collection,
@@ -124,20 +122,20 @@ class PlaylistAddTrackDialog extends HookConsumerWidget {
                         onChanged: (val) {
                           playlistsCheck.value = {
                             ...playlistsCheck.value,
-                            playlist.id!: val == CheckboxState.checked,
+                            playlist.id: val == CheckboxState.checked,
                           };
                         },
                       ),
                       onPressed: () {
                         playlistsCheck.value = {
                           ...playlistsCheck.value,
-                          playlist.id!:
+                          playlist.id:
                               !(playlistsCheck.value[playlist.id] ?? false),
                         };
                       },
                       child: Padding(
                         padding: const EdgeInsets.only(left: 8.0),
-                        child: Text(playlist.name!),
+                        child: Text(playlist.name),
                       ),
                     );
                   },

lib/components/dialogs/replace_downloaded_dialog.dart

@@ -1,13 +1,13 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:shadcn_flutter/shadcn_flutter.dart';
 
-import 'package:spotify/spotify.dart';
 import 'package:spotube/extensions/context.dart';
+import 'package:spotube/models/metadata/metadata.dart';
 
 final replaceDownloadedFileState = StateProvider<bool?>((ref) => null);
 
 class ReplaceDownloadedDialog extends ConsumerWidget {
-  final Track track;
+  final SpotubeTrackObject track;
   const ReplaceDownloadedDialog({required this.track, super.key});
 
   @override
@@ -16,7 +16,7 @@ class ReplaceDownloadedDialog extends ConsumerWidget {
     final replaceAll = ref.watch(replaceDownloadedFileState);
 
     return AlertDialog(
-      title: Text(context.l10n.track_exists(track.name ?? "")),
+      title: Text(context.l10n.track_exists(track.name)),
       content: RadioGroup(
         value: groupValue,
         onChanged: (value) {