mirror of
https://github.com/KRTirtho/spotube.git
synced 2025-09-12 23:45:18 +00:00
90 lines
3.6 KiB
Markdown
90 lines
3.6 KiB
Markdown
|
|
|
|
Spotube is a [Flutter](https://flutter.dev) based lightweight spotify client. It utilizes the power of Spotify & Youtube's public API & creates a hazardless, performant & resource friendly User Experience
|
|
|
|
|
|
## Features
|
|
|
|
Following are the features that currently spotube offers:
|
|
|
|
- Open Source
|
|
- No telementry, diagnostics or user data collection
|
|
- Lightweight & resource friendly
|
|
- Native performance (Thanks to Flutter+Skia)
|
|
- Playback control is on user's machine instead of server based
|
|
- Small size & less data hungry
|
|
- No spotify or youtube ads since it uses all public & free APIs (But it's recommended to support the creators by watching/liking/subscribing to the artists youtube channel or add as favourite track in spotify. Mostly buying spotify premium is the best way to support their valuable creations)
|
|
- Lyrics
|
|
- Downloadable track (WIP)
|
|
|
|
## Installation
|
|
|
|
I'm always releasing newer versions of binary of the software each 2-3 month with minor changes & each 6-8 month with major changes. Grab the binaries
|
|
|
|
All the binaries are located in the [releases](https://github.com/krtirtho/spotube/releases), just download
|
|
|
|
### Windows
|
|
|
|
Extract the **`Spotube-windows-x86_64-setup.exe`** & double click on **`install.bat`** & follow along the installer
|
|
|
|
### Linux
|
|
|
|
- #### Ubuntu/Debian
|
|
```bash
|
|
sudo apt install spotube-linux-x86_64.deb
|
|
or
|
|
sudo dpkg -i spotube-linux-x86_64.deb
|
|
```
|
|
- #### Others:
|
|
Navigate to the downloaded **`Spotube_linux-x86_64.AppImage`**
|
|
file & double click to run it
|
|
|
|
**I'll/try to upload the package binaries to linux debian/arch/ubuntu/snap/flatpack/redhat/chocolatey stores or software centers or repositories**
|
|
|
|
## Configuration
|
|
|
|
There are some configurations that needs to be done to start using this software
|
|
|
|
You need a spotify account & a developer app for
|
|
|
|
- clientId
|
|
- clientSecret
|
|
|
|
**Grab credentials:**
|
|
|
|
- Go to https://developer.spotify.com/dashboard/login & login with your spotify account (Skip if you're logged in)
|
|
|
|
|
|
- Create an web app for Spotify Public API
|
|
|
|
|
|
- Give the app a name & description. Then Edit settings & add **http://localhost:4304/auth/spotify/callback** as **Redirect URI** for the app. Its important for authenticating
|
|
|
|
|
|
- Click on **SHOW CLIENT SECRET** to reveal the **clientSecret**. Then copy the **clientID**, **clientSecret** & paste in the **Spotube's** respective fields
|
|
|
|
|
|
Also, you need a [genius](https://genius.com) account for **lyrics** & a API Client for
|
|
|
|
- accessToken
|
|
|
|
> **Note!**: No personal data or any kind of sensitive information won't be collected from spotify. Don't believe? See the code for yourself
|
|
|
|
## TODO:
|
|
|
|
- [ ] Compile, Debug & Build for **MacOS**
|
|
- [x] Add support for show Lyric of currently playing track
|
|
- [ ] Track download
|
|
- [ ] Support for playing/streaming podcasts/shows
|
|
- [ ] Artist, User & Album pages
|
|
|
|
## Things that don't work
|
|
|
|
- Shows & Podcasts aren't supported as it'd require premium anyway
|
|
- OS Media Controls
|
|
- Global Media Shortcuts/Keyboard Media Buttons
|
|
|
|
#### Social handlers
|
|
|
|
Follow me on [Twitter](https://twitter.com/@krtirtho) for newer updates about this application
|