Welcome to sunny 🌞

Tool to download freely available music from bandcamp.

Automatically organize files to folder, ID3 tags (including album art).

Demo

Motivation

Sunny is hugely inspired by SoundScrape, the main motivation for writing this was speed and customizability.

• SoundScrape downloads sequentially whereas Sunny does parallelly, giving a huge boost of speed.
• Track format can be customized.

Format

By default files are saved in this structure in current directory if --path option is not passed.

Artist ├── Album │   ├── 01 - Track.mp3 │   ├── 02 - Track.mp3 │   ├── 03 - Track.mp3 │   ├── 04 - Track.mp3

Install

sh cargo install sunny

Usage

```sh

whole discography of an artist by url

sunny https://65daysofstatic.bandcamp.com/music

whole discography just by the name of the artist

sunny 65daysofstatic

single album

sunny https://clevergirl.bandcamp.com/album/no-drum-and-bass-in-the-jazz-room

single track

sunny https://65daysofstatic.bandcamp.com/track/twenty-four-twelve-twenty

specify path to download to

sunny yvetteyoung --path=~/Music ```

CLI options

``` USAGE: sunny [OPTIONS]

ARGS: Artist's bandcamp username or full url

OPTIONS: -p, --path

        Directory path where downloads should be saved to.
        By default files are saved in the current directory.

-t, --track-format <FORMAT>

        Specify track format: default is '{num} - {track}'

        available keys:
            {num} - track number
            {track} - track
            {artist} - artist
            {album} - album

        usage:
            -t='{num} - {track} - {album} {artist}'

        expands to:
            2 - ATrack - SomeAlbum SomeArtist

        note that `.mp3` is appended automatically.

    --dry-run
        Do not do anything; just show what would happen

-h, --help
        Print help information

-l, --list-available
        list albums/tracks available to download

-s, --skip-albums <ALBUMS>...
        Skip downloading these albums, note that albums need to be delimited by ','
        eg: -s 'one,two' or --skip-albums='one,two'

-V, --version
        Print version information

```

Contributing

Contributions, issues and feature requests are welcome!