{"id":16009668,"url":"https://github.com/fwcd/mixcloud-uploader","last_synced_at":"2026-03-03T09:08:47.197Z","repository":{"id":49652061,"uuid":"517708794","full_name":"fwcd/mixcloud-uploader","owner":"fwcd","description":"CLI tool for uploading Mixxx recordings to Mixcloud","archived":false,"fork":false,"pushed_at":"2022-10-04T13:19:03.000Z","size":47,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-15T16:40:19.155Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fwcd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-25T14:56:02.000Z","updated_at":"2023-02-23T12:22:57.000Z","dependencies_parsed_at":"2023-01-19T06:01:08.290Z","dependency_job_id":null,"html_url":"https://github.com/fwcd/mixcloud-uploader","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fwcd/mixcloud-uploader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fwcd%2Fmixcloud-uploader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fwcd%2Fmixcloud-uploader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fwcd%2Fmixcloud-uploader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fwcd%2Fmixcloud-uploader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fwcd","download_url":"https://codeload.github.com/fwcd/mixcloud-uploader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fwcd%2Fmixcloud-uploader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30038672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T06:58:30.252Z","status":"ssl_error","status_checked_at":"2026-03-03T06:58:15.329Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-08T13:03:26.259Z","updated_at":"2026-03-03T09:08:47.174Z","avatar_url":"https://github.com/fwcd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mixcloud Uploader\n\n[![Typecheck](https://github.com/fwcd/mixcloud-uploader/actions/workflows/typecheck.yml/badge.svg)](https://github.com/fwcd/mixcloud-uploader/actions/workflows/typecheck.yml)\n\nA small tool for uploading [Mixxx](https://www.mixxx.org) recordings to [Mixcloud](https://www.mixcloud.com), along with tracklists and optional artwork.\n\n## Usage\n\nTo use the tool, first obtain a client id and secret by [registering an API application](https://www.mixcloud.com/developers/create/). You can either pass these credentials as parameters (`--client-id` and `--client-secret`) or, more conveniently, create a file at `~/.config/mixcloud-uploader/auth.json`:\n\n```json\n{\n  \"client-id\": \"YOUR_CLIENT_ID\",\n  \"client-secret\": \"YOUR_CLIENT_SECRET\"\n}\n```\n\nTo upload the latest mix from your `~/Music/Mixxx/Recordings` (customizable via `--recordings-dir`), just run\n\n```sh\nmixcloud-uploader --name YOUR_MIX_NAME\n```\n\nTo choose a custom recording, make sure that `YOUR_RECORDING_NAME.wav` and `YOUR_RECORDING_NAME.cue` are located in the aforementioned directory and pass\n\n```sh\nmixcloud-uploader --name YOUR_MIX_NAME --recording-name YOUR_RECORDING_NAME\n```\n\nFor a more detailed overview of the available flags, invoke\n\n```sh\nmixcloud-uploader --help\n```\n\n### Presets\n\nIf you upload mixes regularly with a mostly fixed naming scheme, having to specify the upload parameters every time can become verbose. For this reason, this tool supports _presets_, which can be defined in `~/.config/mixcloud-uploader/config.json`, e.g. like this:\n\n```json\n{\n  \"presets\": {\n    \"pop\": {\n      \"name\": \"My Pop Mix No. (\\\\d+)\",\n      \"artwork\": \"path/to/some/artwork.png\",\n      \"tags\": [\"pop\"]\n    }\n  }\n}\n```\n\nWhen invoked as follows, the tool will then query the existing uploads to find a name with an autoincremented mix number and use the remaining parameters from the preset:\n\n```sh\nmixcloud-uploader --preset pop\n```\n\n### JSON Schemas\n\nThere are JSON schemas available for the configuration files, which can be added to your VSCode settings as follows:\n\n```json\n{\n  \"json.schemas\": [\n    {\n      \"fileMatch\": [\".config/mixcloud-uploader/config.json\"],\n      \"url\": \"https://raw.githubusercontent.com/fwcd/mixcloud-uploader/main/config.schema.json\"\n    },\n    {\n      \"fileMatch\": [\".config/mixcloud-uploader/auth.json\"],\n      \"url\": \"https://raw.githubusercontent.com/fwcd/mixcloud-uploader/main/auth.schema.json\"\n    }\n  ]\n}\n```\n\nAdding these schemas lets VSCode provide code completion and linting in these configuration files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffwcd%2Fmixcloud-uploader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffwcd%2Fmixcloud-uploader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffwcd%2Fmixcloud-uploader/lists"}