Skip to content

George-wvr/MixCloud-AutoBot

Repository files navigation

MixCloud AutoBot

Automate and bulk-upload your shows to MixCloud with ease!

MixCloud AutoBot is a Python tool designed to simplify the process of uploading shows to MixCloud. It automatically sets metadata (name, image, details) based on filename patterns, supports bulk uploads, and allows for scheduled uploads through a queue system.


⚠️ Early Stage Notice

This project is in active development and not all planned features are implemented yet. Expect bugs, missing functionality, and frequent updates. Contributions and feedback are welcome!


🔧 Features

Currently Implemented

  • Metadata Automation: Set show metadata (name, image, details) using regex patterns in filenames.
  • Date Handling: Extract and format dates from filenames (e.g., yyyymmdddd/mm/yy).
  • Bulk Uploads: Upload multiple shows at once.

Planned Features

  • Guided process for obtaining an Auth Code from Mixcloud
  • Folder Monitoring: Automatically upload new files added to a monitored folder.
  • Queue System: Schedule uploads to avoid MixCloud processing conflicts.
  • Improved GUI for easier control and configuration.
  • Packaged executable.
  • Improved scheduling and error handling.

🛠️ Installation & Setup

Prerequisites

  • Python 3.8+
  • MixCloud API authcode (required to connect your account)
  • Required libraries: requests

Installation

  • Clone the Repository
  • Please reach out to obtain the Auth Code from me as this needs to be setup per account.
    • An automated process is in development.

Setup

Please see the guide on my website for the full guide on how to setup the tool and configuration records: George Weaver


🚀 Usage

Filename Format

To take advantage of the ability to automatically place the date into the showname the first 8 characters of the filename must be the date in yyyymmdd format.

  • Example: 20260201_MyShow.mp3 Then within the configuration record use [DATE] to place the formatted date within the name.
  • Formatted dates are given in the format dd/mm/yy

🤝 Contributing

Contributions are welcome! Here’s how you can help:

  • Report bugs or suggest features by opening an issue.
  • Submit pull requests for bug fixes or new features.
  • Test the tool and provide feedback.

📧 Contact

For questions or feedback, please open a GitHub issue or reach out.


Happy uploading! 🎶

About

Automatically upload shows and tracks to Mixcloud

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages