SoundLoader 🎵⬇️

SoundLoader is a URL-to-MP3 Soundcloud music downloader app built natively for Android. It supports Soundcloud track, album and playlist URL inputs.

📸 Screenshots

              

✨ Features

• Fast Downloads: Easily download SoundCloud tracks to your Android device's local storage.
• Batch Downloads: Download albums and playlists in the background.
• Kotlin: Written in Kotlin, leveraging modern language features for a safe and efficient codebase.
• Modern Build System: Utilizes Gradle Kotlin DSL (*.gradle.kts) for build scripts, ensuring better type safety and seamless IDE support.

🛠 Tech Stack

• Language: Kotlin
• Platform: Android SDK
• Build Tool: Gradle (Kotlin DSL)

⚡️ Quick Start App

1. Download latest APK from Releases to an Android device.

2. Open APK file to install.

3. Done! Open SoundLoader app to start downloading audio.

💻 Build App from Source Code

To build and run this project locally, you will need Android Studio installed on your machine.

Prerequisites

• Android Studio: Make sure you have the latest version of Android Studio installed.
• Android SDK: API level 24 or higher is recommended (check the build.gradle.kts for specific minSdk and targetSdk configurations).

Installation & Build

1. Clone the repository git clone https://github.com/mvxGREEN/SoundLoader.git

2. Open the project in Android Studio

   • Launch Android Studio.
   • Select Open an existing Android Studio project.
   • Navigate to the cloned directory and open.

3. Sync Gradle

   • Wait for Android Studio to index the files and sync the Gradle dependencies.

4. Run the App

   • Connect an Android device via USB (with USB Debugging enabled) or start an Android Emulator.
   • Click the Run button (green play icon) in the Android Studio toolbar.

💡 Usage

1. Open the SoundLoader app.
2. Paste the URL of the SoundCloud track you wish to download.
3. Tap the download button and wait for the track to be saved to your device.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

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

This project is licensed under the WTFPL (Do What The F*ck You Want To Public License) - see the LICENSE file for details.