George Weaver Making dam good stuff, like an eager beaver should
George Weaver

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. While designed for radio stations, it is suitable for anyone needing automated MixCloud uploads.

Early Stage Notice

This project is in active development and not all planned features are implemented yet. Expect bugs, missing functionality, and frequent updates. Source code is available on GitHub with an executable package planned for the future.

Key Features

  • Schedule and automate uploads to MixCloud
  • Template based customisations for uploads
  • Relate files to upload templates using regex patterns in file names
  • Extract dates from filename for upload title
  • Upload multiple shows at once

Roadmap at a glance

In Development Planned
GUI interface for managing upload queues GUI interface for managing upload templates
Complete pre-launch check (including bypass for unexpected restarts) Guided process for obtaining authcode
Robust file handeling methods Packaged executable for easier running

Installation & Setup

Prerequisites

  • Python 3.8+
  • MixCloud API authcode
    • Get in contact to obtain the authcode for your account.
    • An automated process is in development.
  • 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

For a complete setup guide please see the detailed setup guide which is currently being written.

In brief, the tool is configured using a set of configuration records which are stored in a .txt file. Each record defines a template for uploading shows that match certain criteria (e.g. filename patterns). The tool will automatically process files in the specified directory and upload them to MixCloud according to the matching configuration record.

Files

File Types

Due to the way in which the MixCloud handels files througn the API all files must be of type MP3. In the long term other file types can be looked at.

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.

The date can then be used in the file name in the format dd/mm/yy

For example, a file name of 20260310_The_Best_Show.mp3 will produce the date 10/03/26

Upload templates

MixCloud Autobot makes use of upload templates to make automating uploads easier. The templates define the details of the upload such as the title and image used. Templates are automatically matched to files through regular expressions in the file names. The tool will automatically process files in the specified directory and upload them to MixCloud according to the matching configuration record.

The templates are currently stored as .txt files. An example of the format can be found in the full user guide.

Contributions

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.

Useful links and further reading

Read the latest project update below