dubc/sacad repository overview

SACAD on Github⁠

SACAD is a multi platform command line tool to download album covers without manual intervention, ideal for integration in scripts, audio players, etc.

This container sets sane defaults and a cron to run sacad_r. Logs are output to /music/sacad.log each cron run.

Set your variables:

IMG_SIZE 300
IMG_NAME folder.jpg

IMG_SIZE can be whatever you want. 300 is a good size for web and apps and is a fast download considering all images are optimised and crunched.

IMG_NAME can be folder.png or cover.png or cover.jpg etc.

To choose the cron PERIODIC value you select the appropriate tag. Tag can be any of the below:

15min hourly daily weekly monthly

⁠Docker Usage

1. docker-compose.yml <- Easiest and recommended to get keep your album art always complete.

version: '3.5'
services:
  sacad:
    image: dubc/sacad:hourly
    container_name: sacad
    restart: unless-stopped
    environment:
      - IMG_SIZE=300
      - IMG_NAME=folder.jpg
    volumes:
      - /srv/Music:/music

1. Not recommended but you can run the docker container in interactive mode. Mount your Music directory to /music

docker run -it -v /srv/some_path/Music:/music -e IMG_SIZE=300 -e IMG_NAME=folder.jpg dubc/sacad:hourly /bin/sh

or exec into the container if already running in compose

docker exec -it sacad /bin/sh

1. View logs for progress