Home

Awesome

<div align="center"> <img width="600" src="assets/spotube_banner.png" alt="Spotube Logo">

An open source, cross-platform Spotify client compatible across multiple platforms<br /> utilizing Spotify's data API and YouTube, Piped.video or JioSaavn as an audio source,<br /> eliminating the need for Spotify Premium

Btw it's not just another Electron app 😉

<a href="https://spotube.krtirtho.dev"><img alt="Visit the website" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/website_vector.svg"></a> <a href="https://discord.gg/uJ94vxB6vg"><img alt="Discord Server" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg"></a>

<a href="https://patreon.com/krtirtho"><img alt="Support me on Patron" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/patreon-singular_vector.svg"></a> <a href="https://www.buymeacoffee.com/krtirtho"><img alt="Buy me a Coffee" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/buymeacoffee-singular_vector.svg"></a>

HackerNews

<a href="https://opencollective.com/spotube"><img src="https://opencollective.com/spotube/donate/button.png?color=blue" alt="Donate to our Open Collective" height="45"></a>


Spotube Desktop

Spotube Mobile

</div>

🌃 Features

¹ It is still recommended to support creators by engaging with their YouTube channels/Spotify tracks (or preferably by buying their merch/concert tickets/physical media).

❌ Unsupported features

📜 ⬇️ Installation guide

New versions usually release every 3-4 months.<br /> This handy table lists all the methods you can use to install Spotube:

<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://reachify.io/wp-content/uploads/2018/09/mac-download-button-1.png"> </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> <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 temporal 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.

🕳️ 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.

👥 The Spotube team

💼 License

Spotube is open source and licensed under the BSD-4-Clause License.

If you are concerned, you can read the reason of choosing this license.

<details> <summary> <h2><code>[Click to show]</code> 🙏 Services/Package/Plugin Credits</h2> </summary>

Services

  1. Flutter - Flutter transforms the app development process. Build, test, and deploy beautiful mobile, web, desktop, and embedded apps from a single codebase
  2. Spotify API - The Spotify Web API is a RESTful API that provides access to Spotify data
  3. Piped - Piped is a privacy friendly alternative YouTube frontend, which is efficient and scalable by design.
  4. YouTube - YouTube is an American online video-sharing platform headquartered in San Bruno, California. Three former PayPal employees—Chad Hurley, Steve Chen, and Jawed Karim—created the service in February 2005
  5. JioSaavn - JioSaavn is an Indian online music streaming service and a digital distributor of Bollywood, English and other regional Indian music across the world. Since it was founded in 2007 as Saavn, the company has acquired rights to over 5 crore (50 million) music tracks in 15 languages
  6. SongLink - 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
  7. LRCLib - A public synced lyric API
  8. Linux - 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
  9. AUR - AUR stands for Arch User Repository. It is a community-driven repository for Arch-based Linux distributions users
  10. Flatpak - Flatpak is a utility for software deployment and package management for Linux
  11. SponsorBlock - SponsorBlock is an open-source crowdsourced browser extension and open API for skipping sponsor segments in YouTube videos.
  12. Inno Setup - Inno Setup is a free installer for Windows programs by Jordan Russell and Martijn Laan
  13. F-Droid - 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
  14. LastFM - 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 - Android App Links, Deep Links, iOs Universal Links and Custom URL schemes handler for Flutter (desktop included).
  2. args - Library for defining parsers for parsing raw command-line arguments into a set of options and values using GNU and POSIX style options.
  3. async - Utility functions and classes related to the 'dart:async' library.
  4. audio_service_mpris - audio_service platform interface supporting Media Player Remote Interfacing Specification.
  5. audio_service - Flutter plugin to play audio in the background while the screen is off.
  6. 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.
  7. auto_size_text - Flutter widget that automatically resizes text to fit perfectly within its bounds.
  8. bonsoir - A Zeroconf library that allows you to discover network services and to broadcast your own. Based on Apple Bonjour and Android NSD.
  9. build_runner - A build system for Dart code generation and modular compilation.
  10. buttons_tabbar - A Flutter package that implements a TabBar where each label is a toggle button.
  11. cached_network_image - Flutter library to load and cache network images. Can also be used with placeholder and error widgets.
  12. catcher_2 - Plugin for error catching which provides multiple handlers for dealing with errors when they are not caught by the developer.
  13. collection - Collections and utilities functions and classes related to collections.
  14. crypto - Implementations of SHA, MD5, and HMAC cryptographic functions.
  15. curved_navigation_bar - Stunning Animating Curved Shape Navigation Bar. Adjustable color, background color, animation curve, animation duration.
  16. custom_lint - Lint rules are a powerful way to improve the maintainability of a project. Custom Lint allows package authors and developers to easily write custom lint rules.
  17. dart_discord_rpc - Discord Rich Presence for Flutter & Dart apps & games.
  18. dbus - A native Dart implementation of the D-Bus message bus client. This package allows Dart applications to directly access services on the Linux desktop.
  19. device_info_plus - Flutter plugin providing detailed information about the device (make, model, etc.), and Android or iOS version the app is running on.
  20. dio - A powerful HTTP networking package,supports Interceptors,Aborting and canceling a request,Custom adapters, Transformers, etc.
  21. disable_battery_optimization - 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
  22. 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.
  23. 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.
  24. envied_generator - Generator for the Envied package. See https://pub.dev/packages/envied.
  25. envied - Explicitly reads environment variables into a dart file from a .env file for more security and faster start up times.
  26. 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.
  27. file_selector - Flutter plugin for opening and saving files, or selecting directories, using native file selection UI.
  28. fluentui_system_icons - Fluent UI System Icons are a collection of familiar, friendly and modern icons from Microsoft.
  29. flutter_broadcasts - A plugin for sending and receiving broadcasts with Android intents and iOS notifications.
  30. flutter_cache_manager - Generic cache manager for flutter. Saves web files on the storages of the device and saves the cache info using sqflite.
  31. flutter_displaymode - A Flutter plugin to set display mode (resolution, refresh rate) on Android platform. Allows to enable high refresh rate on supported devices.
  32. 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.
  33. flutter_gen_runner - The Flutter code generator for your assets, fonts, colors, … — Get rid of all String-based APIs.
  34. flutter_hooks - A flutter implementation of React hooks. It adds a new kind of widget with enhanced code reuse.
  35. flutter_inappwebview - A Flutter plugin that allows you to add an inline webview, to use an headless webview, and to open an in-app browser window.
  36. flutter_launcher_icons - A package which simplifies the task of updating your Flutter app's launcher icon.
  37. flutter_lints - Recommended lints for Flutter apps, packages, and plugins to encourage good coding practices.
  38. flutter_native_splash - Customize Flutter's default white native splash screen with background color and splash image. Supports dark mode, full screen, and more.
  39. flutter_riverpod - A reactive caching and data-binding framework. Riverpod makes working with asynchronous code a breeze.
  40. 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.
  41. flutter_sharing_intent - A flutter plugin that allow flutter apps to receive photos, videos, text, urls or any other file types from another app.
  42. flutter_svg - An SVG rendering and widget library for Flutter, which allows painting and displaying Scalable Vector Graphics 1.1 files.
  43. form_validator - Simplest form validation library for flutter's form field widgets
  44. freezed_annotation - Annotations for the freezed code-generator. This package does nothing without freezed too.
  45. freezed - Code generation for immutable classes that has a simple syntax/API without compromising on the features.
  46. fuzzywuzzy - An implementation of the popular fuzzywuzzy package in Dart, to suit all your fuzzy string matching/searching needs!
  47. gap - Flutter widgets for easily adding gaps inside Flex widgets such as Columns and Rows or scrolling views.
  48. go_router - A declarative router for Flutter based on Navigation 2 supporting deep linking, data-driven routes and more
  49. google_fonts - A Flutter package to use fonts from fonts.google.com. Supports HTTP fetching, caching, and asset bundling.
  50. hive_flutter - Extension for Hive. Makes it easier to use Hive in Flutter apps.
  51. hive_generator - Extension for Hive. Automatically generates TypeAdapters to store any class.
  52. hive - Lightweight and blazing fast key-value database written in pure Dart. Strongly encrypted using AES-256.
  53. hooks_riverpod - A reactive caching and data-binding framework. Riverpod makes working with asynchronous code a breeze.
  54. html_unescape - A small library for un-escaping HTML. Supports all Named Character References, Decimal Character References and Hexadecimal Character References.
  55. html - APIs for parsing and manipulating HTML content outside the browser.
  56. http - A composable, multi-platform, Future-based API for HTTP requests.
  57. image_picker - Flutter plugin for selecting images from the Android and iOS image library, and taking new pictures with the camera.
  58. intl - Contains code to deal with internationalized/localized messages, date and number formatting and parsing, bi-directional text, and other internationalization issues.
  59. introduction_screen - Introduction/Onboarding package for flutter app with some customizations possibilities
  60. io - Utilities for the Dart VM Runtime including support for ANSI colors, file copying, and standard exit code values.
  61. jiosaavn - Unofficial API client for jiosaavn.com
  62. json_annotation - Classes and helper functions that support JSON code generation via the json_serializable package.
  63. json_serializable - Automatically generate code for converting to and from JSON by annotating Dart classes.
  64. local_notifier - This plugin allows Flutter desktop apps to displaying local notifications.
  65. logger - Small, easy to use and extensible logger which prints beautiful logs.
  66. lrc - A Dart-only package that creates, parses, and handles LRC, which is a format that stores song lyrics.
  67. media_kit_libs_audio - package:media_kit audio (only) playback native libraries for all platforms.
  68. media_kit - A cross-platform video player & audio player for Flutter & Dart. Performant, stable, feature-proof & modular.
  69. metadata_god - Plugin for retrieving and writing audio tags/metadata from audio files
  70. mime - Utilities for handling media (MIME) types, including determining a type from a file extension and file contents.
  71. package_info_plus - Flutter plugin for querying information about the application package, such as CFBundleVersion on iOS or versionCode on Android.
  72. palette_generator - Flutter package for generating palette colors from a source image.
  73. path_provider - Flutter plugin for getting commonly used locations on host platform file systems, such as the temp and app data directories.
  74. 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.
  75. permission_handler - Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
  76. piped_client - API Client for piped.video
  77. popover - A popover is a transient view that appears above other content onscreen when you tap a control or in an area.
  78. process_run - Process run helpers for Linux/Win/Mac and which like feature for finding executables.
  79. pub_api_client - An API Client for Pub to interact with public package information.
  80. pubspec_parse - Simple package for parsing pubspec.yaml files with a type-safe API and rich error reporting.
  81. riverpod_lint - Riverpod_lint is a developer tool for users of Riverpod, designed to help stop common issues and simplify repetitive tasks.
  82. scrobblenaut - A deadly simple LastFM API Wrapper for Dart. So deadly simple that it's gonna hit the mark.
  83. scroll_to_index - Scroll to a specific child of any scrollable widget in Flutter
  84. shared_preferences - Flutter plugin for reading and writing simple key-value pairs. Wraps NSUserDefaults on iOS and SharedPreferences on Android.
  85. shelf_router - A convenient request router for the shelf web-framework, with support for URL-parameters, nested routers and routers generated from source annotations.
  86. shelf_web_socket - A shelf handler that wires up a listener for every connection.
  87. shelf - A model for web server middleware that encourages composition and easy reuse.
  88. sidebarx - flutter multiplatform navigation sidebar / side navigationbar / drawer widget
  89. simple_icons - The Simple Icon pack available as Flutter Icons. Provides over 1500 Free SVG icons for popular brands.
  90. skeleton_text - A package that provides an easy way to add skeleton text loading animation in Flutter project. This project is a part of 101Loop community.
  91. skeletonizer - Converts already built widgets into skeleton loaders with no extra effort.
  92. sliver_tools - A set of useful sliver tools that are missing from the flutter framework
  93. smtc_windows - Windows SystemMediaTransportControls implementation for Flutter giving access to Windows OS Media Control applet.
  94. spotify - An incomplete dart library for interfacing with the Spotify Web API.
  95. stroke_text - A Simple Flutter plugin for applying stroke (border) style to a text widget
  96. system_theme - A plugin to get the current system theme info. Supports Android, Web, Windows, Linux and macOS
  97. timezone - Time zone database and time zone aware DateTime.
  98. titlebar_buttons - A package which provides most of the titlebar buttons from windows, linux and macos.
  99. tray_manager - This plugin allows Flutter desktop apps to defines system tray.
  100. url_launcher - Flutter plugin for launching a URL. Supports web, phone, SMS, and email schemes.
  101. uuid - RFC4122 (v1, v4, v5, v6, v7, v8) UUID Generator and Parser for Dart
  102. version - Provides a simple class for parsing and comparing semantic versions as defined by http://semver.org/
  103. very_good_infinite_list - A library for easily displaying paginated data, created by Very Good Ventures. Great for activity feeds, news feeds, and more.
  104. visibility_detector - A widget that detects the visibility of its child and notifies a callback.
  105. 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.
  106. wikipedia_api - Wikipedia API for dart and flutter
  107. win32_registry - A package that provides a friendly Dart API for accessing the Windows Registry.
  108. window_manager - This plugin allows Flutter desktop apps to resizing and repositioning the window.
  109. xml - A lightweight library for parsing, traversing, querying, transforming and building XML documents.
  110. youtube_explode_dart - A port in dart of the youtube explode library. Supports several API functions without the need of Youtube API Key.
</details> <div align="center"><h4>© Copyright Spotube 2024</h4></div>