Skip to content

mvxGREEN/VscoLoader

Repository files navigation

VscoLoader App Icon

VscoLoader ⬇️

Build Status License: WTFPL Language: Kotlin Platform: Android

A simple Android application for downloading photos, videos, profiles and collections from VSCO.

📸 Screenshots

              

✨ Features

  • Direct Downloads: Download VSCO images or videos directly to your Android device's local storage.
  • URL-to-MP4: Simply copy and paste the URL of the target media, or click "Share" and share it to VscoLoader, to download VSCO media.
  • Kotlin: Written in Kotlin, leveraging modern language features for a safe and concise codebase.
  • Gradle: 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 VscoLoader app to start downloading media from VSCO.

💻 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.
  • NDK & CMake: Because Chaquopy builds native Python components, ensure you have the Android NDK and CMake installed via the Android Studio SDK Manager.

Installation & Build

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

  2. Open the project in Android Studio

    • Launch Android Studio.
    • Navigate to the cloned directory and open it.
  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 VscoLoader app.
  2. Paste the URL of the VSCO post you wish to download.
  3. Tap the download button and wait for the image/video to be saved to your device.

(Alternatively, use the Android "Share" intent from the official VSCO app to share URL's directly to VscoLoader)

🤝 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.