SpotHack

Convert your Spotify Playlists to offline versions that are always up to date, without paying the Premium.

Download Project · Start Developing

⭐ Don't forget to Starring ⭐

📋 Table of Contents

📋 Table of Contents

• About The Project
• Download & Installation
• Getting Started with Development
• API Credentials
• Contributing
• License
• Disclaimer

🔍 About The Project

⚙️ How it works?

After you select your music or playlist, our Download Machine will, with the YouTube Scraper or the YouTube API, search for the music video, with the query starting with the artists name followed by the track name. Once we get the YouTube ID we can download the music video and convert it to .mp3 with ffmpeg.

📱 Pages

Click to expand pages

Login Page

• Enter your APIs tokens (if not configured on APK building).
• Login !!

Home Page

• Shortcuts to "Outdated Playlists", "Downloads Manager", "Settings Page" and others ...

---

Search Pages

• Search for your favorite musics and playlists.
• Download them !!

---

Download Page

• Follow the download status of your musics.
• Know about the errors.

---

Settings Page

• Change the "Root Path", "Download Default Source", "Music Time Limit", and the Render Mode.

---

Outdate Playlist Page

• Follow your playlist Status.
• Download the news musics.
• Delete the old ones.

---

Add Playlist Page

• Reference a Playlist to a folder, if we can't do it.

⬇️ Download & Installation

You can download this App in the Releases or build the code with some changes that you may want.

• Download APK - (don't forget the API Credentials)
• Download and Build the Code
• Download APK 🔑 for my friends - (need password to install 🔒)

🚀 Getting Started with Development

To get a local copy up and running follow these simple example steps.

1. Prerequisites

Start by installing the following tools:

• Git - Version Control System

• Yarn - Package Manager

• For run the project you will need the React Native Environment configured. You can follow the ReactNative Official Documentation;

Note: This project was only tested and developed for Android, so I don't know if it works properly in IOS. Is recommended that you run it in an Android Phone;

2. Cloning

Now clone the repository to your local machine. You can do this using Git:

$ git clone https://github.com/Darguima/SpotHack.git
# or
$ git clone git@github.com:Darguima/SpotHack.git

3. Dependencies

Install the dependencies using Yarn:

$ yarn

4. Set credentials for third-party APIs 🪪

This App use 2 third-party APIs:

• Spotify Api (Web Api)
• Youtube Api (YouTube Data API v3)

You can save this credentials in a .env file or input them directly on the App. To get the required credentials you can follow our tutorial.

4. Setup 🛠️

• To setup the application you can use:

yarn start
yarn android

At this moment you should have a Android Emulator with SpotHack running

5. Building the APK

Generate a KeyStore 🔑

Fill in the required inputs (and remember the password):

$ keytool -genkey -v -keystore android/app/spothack.keystore -alias spothack -keyalg RSA -keysize 2048 -validity 10000

Edit the gradle ✏️

Edit the file android/app/build.gradle, changing storePassword and keyPassword to the previous password.

Assemble 🧑‍🏭

cd android
./gradlew assembleRelease

Based on this tutorial.

---

API Credentials🪪

For store the credentials you can create a file .env with the next structure or you can input the credentials directly in the App, on Login Screen.

SPOTIFY_CLIENT_ID= ...
SPOTIFY_CLIENT_SECRET= ...
YOUTUBE_API_KEY= ...

Spotify

As the entire App is based on Spotify's repertoire, it is required have access to their API, or in others words: a Client Id and a Client Secret. To get this tokens you can follow the next tutorial:

1. Access the Spotify Developer Dashboard.

2. Login with any Spotify Account.

3. Click on Create App (name of your choice).

4. Edit the Settings - add com.darguima.spothack://oauthredirect to Redirect URIs

5. Go to Users and Access > Add new user and fill in with your users accounts.

6. Now you are able to copy the Client ID and the Client Secret

spotifyCredentails.mp4

YouTube

Unlike Spotify, YouTube API is not essential for the App flow, so you can omit this key without problems, but if for some reason the YouTube Scrape Server is not working, this can be a plan B for Music Download. To get the API Key is a little more complicated than Spotify; Follow the next steps:

1. Access the Google Cloud Platform Console.

2. Login with any Google Account.

3. Click on Select a Project > New Project.

4. Create a project with a name of your choice and Select it.

5. Select in Navigation Menu > APIs and services > Library

6. Search and Enable YouTube Data API v3

7. Go to OAuth consent Screen and select External > Create, then fill in the required inputs and continue to the end.

8. Go to Credentials and click Create Credentials > API key. Now you can copy the key!

YoutubeCredentials.mp4

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

⚖️ License

Distributed under the MIT LICENSE. See LICENSE file for more information.

⚠️ Disclaimer

This project can be considered a piracy service to download music. No source code here was used in production, nor was it ever used with the idea of making money. I only disposed of the code as open source because this is a study project. If you want to use it as a service, use it at your own risk, but remember that artists and publishers are likely to own the downloaded music.