Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pforret/shmixcloud

Download Mixcloud shows and add album art to m4a files
https://github.com/pforret/shmixcloud

bash-scripting bashew download mixcloud

Last synced: about 2 months ago
JSON representation

Download Mixcloud shows and add album art to m4a files

Awesome Lists containing this project

README

        

![bash_unit CI](https://github.com/pforret/shmixcloud/workflows/bash_unit%20CI/badge.svg)
![Shellcheck CI](https://github.com/pforret/shmixcloud/workflows/Shellcheck%20CI/badge.svg)
![GH Language](https://img.shields.io/github/languages/top/pforret/shmixcloud)
![GH stars](https://img.shields.io/github/stars/pforret/shmixcloud)
![GH tag](https://img.shields.io/github/v/tag/pforret/shmixcloud)
![GH License](https://img.shields.io/github/license/pforret/shmixcloud)
[![basher install](https://img.shields.io/badge/basher-install-white?logo=gnu-bash&style=flat)](https://basher.gitparade.com/package/)

# shmixcloud

![shmixcloud](assets/shmixcloud.jpg)

- Download Mixcloud shows to disk to be used on USB stick for e.g. 🚗 (tested on BMW X1 😉)
- download N most recent shows (default: 10)
- add Title, Author, Album, Image to (M4A) audio file

## 🔥 Usage

```
Program: shmixcloud 3.0.3 by [email protected]
Updated: 2023-11-09 11:18
Description: Download Mixcloud shows to disk to be used in e.g. car
Usage: shmixcloud [-h] [-q] [-v] [-f] [-f] [-Q] [-l ] [-o ] [-t ] [-A ] [-B ] [-C ] [-D ] [-F ] [-G ] [-I ] [-N ] [-P ] [-S ] [-T ]
Flags, options and parameters:
-h|--help : [flag] show usage [default: off]
-q|--quiet : [flag] no output [default: off]
-v|--verbose : [flag] output more [default: off]
-f|--force : [flag] do not ask for confirmation (always yes) [default: off]
-f|--force : [flag] do not ask for confirmation (always yes) [default: off]
-Q|--qrcode : [flag] add QR encode of URL to image [default: off]
-l|--log_dir > : [option] folder for log files [default: /home/pforret/log/shmixcloud]
-o|--out_dir > : [option] output folder for the m4a/mp3 files (default: derive from URL)
-t|--tmp_dir > : [option] folder for temp files [default: /tmp/shmixcloud]
-A|--AUDIO > : [option] audio format to use [default: m4a]
-B|--DOWNLOADER >: [option] binary to use for downloading [default: yt-dlp]
-C|--COMMENT > : [option] comment metadata for audio file [default: %c %a]
-D|--DAYS > : [option] maximum days to go back [default: 365]
-F|--FONT > : [option] font to use for subtitle [default: Helvetica]
-G|--FONTSIZE >: [option] font size [default: 32]
-I|--FILTER > : [option] only download matching mixes [default: /]
-N|--NUMBER > : [option] maximum downloads from this playlist [default: 10]
-P|--PIXELS > : [option] resolution image (width/height in pixels) [default: 500]
-S|--SUBTITLE >: [option] subtitle for the image [default: %u @ %y]
-T|--TITLE > : [option] title metadata for audio file [default: %d: %t (%mmin)]
: [parameter] action to perform: download/update/check
: [parameter] Mixcloud URL of a user or a playlist (optional)
```

## ⚡️ Examples

```bash
$ shmixcloud download https://www.mixcloud.com/djsupermarkt_tooslowtd/
# files will be stored in ./djsupermarkt_tooslowtd/
$ shmixcloud -N 20 download https://www.mixcloud.com/DjBlasto/playlists/discosauro/
# files will be stored in ./DjBlasto/discosauro/
```

File info (Apple+I) will look like this:\
![](assets/apple_info.png)

## 🚀 Installation

with [basher](https://github.com/basherpm/basher)

$ basher install pforret/shmixcloud

or with `git`

$ git clone https://github.com/pforret/shmixcloud.git
$ cd shmixcloud

## 📝 Acknowledgements

* script created with [bashew](https://github.com/pforret/bashew)

© 2021 Peter Forret