scdl


Namescdl JSON
Version 2.7.6 PyPI version JSON
download
home_pagehttps://github.com/flyingrub/scdl
SummaryDownload Music from Souncloud
upload_time2024-04-28 02:16:34
maintainerNone
docs_urlNone
authorFlyinGrub
requires_python>=3.7
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Soundcloud Music Downloader
## Description

This script is able to download music from SoundCloud and set id3tag to the downloaded music.
Compatible with Windows, OS X, Linux.


## System requirements

* python3
* ffmpeg

## Installation Instructions
https://github.com/flyingrub/scdl/wiki/Installation-Instruction

## Configuration
There is a configuration file left in `~/.config/scdl/scdl.cfg`

## Examples:
```
# Download track & repost of the user QUANTA
scdl -l https://soundcloud.com/quanta-uk -a

# Download likes of the user Blastoyz
scdl -l https://soundcloud.com/kobiblastoyz -f

# Download one track
scdl -l https://soundcloud.com/jumpstreetpsy/low-extender

# Download one playlist
scdl -l https://soundcloud.com/pandadub/sets/the-lost-ship

# Download only new tracks from a playlist
scdl -l https://soundcloud.com/pandadub/sets/the-lost-ship --download-archive archive.txt -c

# Sync playlist
scdl -l https://soundcloud.com/pandadub/sets/the-lost-ship --sync archive.txt

# Download your likes (with authentification token)
scdl me -f
```

## Options:
```
-h --help                       Show this screen
--version                       Show version
-l [url]                        URL can be track/playlist/user
-n [maxtracks]                  Download the n last tracks of a playlist according to the creation date
-s                              Download the stream of a user (token needed)
-a                              Download all tracks of user (including reposts)
-t                              Download all uploads of a user (no reposts)
-f                              Download all favorites of a user
-C                              Download all commented by a user
-p                              Download all playlists of a user
-r                              Download all reposts of user
-c                              Continue if a downloaded file already exists
--force-metadata                This will set metadata on already downloaded track
-o [offset]                     Begin with a custom offset
--addtimestamp                  Add track creation timestamp to filename,
                                which allows for chronological sorting
--addtofile                     Add artist to filename if missing
--debug                         Set log level to DEBUG
--download-archive [file]       Keep track of track IDs in an archive file,
                                and skip already-downloaded files
--error                         Set log level to ERROR
--extract-artist                Set artist tag from title instead of username
--hide-progress                 Hide the wget progress bar
--hidewarnings                  Hide Warnings. (use with precaution)
--max-size [max-size]           Skip tracks larger than size (k/m/g)
--min-size [min-size]           Skip tracks smaller than size (k/m/g)
--no-playlist-folder            Download playlist tracks into main directory,
                                instead of making a playlist subfolder
--onlymp3                       Download only the streamable mp3 file,
                                even if track has a Downloadable file
--path [path]                   Use a custom path for downloaded files
--remove                        Remove any files not downloaded from execution
--sync [file]	                Compare an archive file to a playlist and downloads/removes any changed tracks
--flac                          Convert original files to .flac
--no-album-tag                  On some player track get the same cover art if from the same album, this prevent it
--original-art                  Download original cover art
--original-name                 Do not change name of original file downloads
--no-original                   Do not download original file; only mp3 or m4a
--only-original                 Only download songs with original file available
--name-format [format]          Specify the downloaded file name format
--playlist-name-format [format] Specify the downloaded file name format, if it is being downloaded as part of a playlist
--client-id [id]                Specify the client_id to use
--auth-token [token]            Specify the auth token to use
--overwrite                     Overwrite file if it already exists
--strict-playlist               Abort playlist downloading if one track fails to download
```


## Features
* Automatically detect the type of link provided
* Download all songs from a user
* Download all songs and reposts from a user
* Download all songs from one playlist
* Download all songs from all playlists from a user
* Download all songs from a user's favorites
* Download only new tracks from a list (playlist, favorites, etc.)
* Sync Playlist
* Set the tags with mutagen (Title / Artist / Album / Artwork)
* Create playlist files when downloading a playlist


## License

[GPL v2](https://www.gnu.org/licenses/gpl-2.0.txt), original author [flyingrub](https://github.com/flyingrub)

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/flyingrub/scdl",
    "name": "scdl",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": "FlyinGrub",
    "author_email": "flyinggrub@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/db/55/37998968ee88072c030ca58d24c2527209550ba0c4b468176ee97076bb90/scdl-2.7.6.tar.gz",
    "platform": null,
    "description": "# Soundcloud Music Downloader\n## Description\n\nThis script is able to download music from SoundCloud and set id3tag to the downloaded music.\nCompatible with Windows, OS X, Linux.\n\n\n## System requirements\n\n* python3\n* ffmpeg\n\n## Installation Instructions\nhttps://github.com/flyingrub/scdl/wiki/Installation-Instruction\n\n## Configuration\nThere is a configuration file left in `~/.config/scdl/scdl.cfg`\n\n## Examples:\n```\n# Download track & repost of the user QUANTA\nscdl -l https://soundcloud.com/quanta-uk -a\n\n# Download likes of the user Blastoyz\nscdl -l https://soundcloud.com/kobiblastoyz -f\n\n# Download one track\nscdl -l https://soundcloud.com/jumpstreetpsy/low-extender\n\n# Download one playlist\nscdl -l https://soundcloud.com/pandadub/sets/the-lost-ship\n\n# Download only new tracks from a playlist\nscdl -l https://soundcloud.com/pandadub/sets/the-lost-ship --download-archive archive.txt -c\n\n# Sync playlist\nscdl -l https://soundcloud.com/pandadub/sets/the-lost-ship --sync archive.txt\n\n# Download your likes (with authentification token)\nscdl me -f\n```\n\n## Options:\n```\n-h --help                       Show this screen\n--version                       Show version\n-l [url]                        URL can be track/playlist/user\n-n [maxtracks]                  Download the n last tracks of a playlist according to the creation date\n-s                              Download the stream of a user (token needed)\n-a                              Download all tracks of user (including reposts)\n-t                              Download all uploads of a user (no reposts)\n-f                              Download all favorites of a user\n-C                              Download all commented by a user\n-p                              Download all playlists of a user\n-r                              Download all reposts of user\n-c                              Continue if a downloaded file already exists\n--force-metadata                This will set metadata on already downloaded track\n-o [offset]                     Begin with a custom offset\n--addtimestamp                  Add track creation timestamp to filename,\n                                which allows for chronological sorting\n--addtofile                     Add artist to filename if missing\n--debug                         Set log level to DEBUG\n--download-archive [file]       Keep track of track IDs in an archive file,\n                                and skip already-downloaded files\n--error                         Set log level to ERROR\n--extract-artist                Set artist tag from title instead of username\n--hide-progress                 Hide the wget progress bar\n--hidewarnings                  Hide Warnings. (use with precaution)\n--max-size [max-size]           Skip tracks larger than size (k/m/g)\n--min-size [min-size]           Skip tracks smaller than size (k/m/g)\n--no-playlist-folder            Download playlist tracks into main directory,\n                                instead of making a playlist subfolder\n--onlymp3                       Download only the streamable mp3 file,\n                                even if track has a Downloadable file\n--path [path]                   Use a custom path for downloaded files\n--remove                        Remove any files not downloaded from execution\n--sync [file]\t                Compare an archive file to a playlist and downloads/removes any changed tracks\n--flac                          Convert original files to .flac\n--no-album-tag                  On some player track get the same cover art if from the same album, this prevent it\n--original-art                  Download original cover art\n--original-name                 Do not change name of original file downloads\n--no-original                   Do not download original file; only mp3 or m4a\n--only-original                 Only download songs with original file available\n--name-format [format]          Specify the downloaded file name format\n--playlist-name-format [format] Specify the downloaded file name format, if it is being downloaded as part of a playlist\n--client-id [id]                Specify the client_id to use\n--auth-token [token]            Specify the auth token to use\n--overwrite                     Overwrite file if it already exists\n--strict-playlist               Abort playlist downloading if one track fails to download\n```\n\n\n## Features\n* Automatically detect the type of link provided\n* Download all songs from a user\n* Download all songs and reposts from a user\n* Download all songs from one playlist\n* Download all songs from all playlists from a user\n* Download all songs from a user's favorites\n* Download only new tracks from a list (playlist, favorites, etc.)\n* Sync Playlist\n* Set the tags with mutagen (Title / Artist / Album / Artwork)\n* Create playlist files when downloading a playlist\n\n\n## License\n\n[GPL v2](https://www.gnu.org/licenses/gpl-2.0.txt), original author [flyingrub](https://github.com/flyingrub)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Download Music from Souncloud",
    "version": "2.7.6",
    "project_urls": {
        "Homepage": "https://github.com/flyingrub/scdl"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2b8548bb923e523984217dcdb46a57d85a11970773c002cedb80f5f0ca22111c",
                "md5": "9c4fcc628caa04a72f31b07e3c83e0f7",
                "sha256": "4d900d85d86d63aa997da3958acec24ebcb30d7435816ce67054e531c9784c19"
            },
            "downloads": -1,
            "filename": "scdl-2.7.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9c4fcc628caa04a72f31b07e3c83e0f7",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 21301,
            "upload_time": "2024-04-28T02:16:32",
            "upload_time_iso_8601": "2024-04-28T02:16:32.647229Z",
            "url": "https://files.pythonhosted.org/packages/2b/85/48bb923e523984217dcdb46a57d85a11970773c002cedb80f5f0ca22111c/scdl-2.7.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "db5537998968ee88072c030ca58d24c2527209550ba0c4b468176ee97076bb90",
                "md5": "8a131258df17238fa61ace91e70a35b1",
                "sha256": "cb0599021d9671b6e35c87a6c3c31b7f4df80ef8ff6f8c9891b6af24c2ac0eaf"
            },
            "downloads": -1,
            "filename": "scdl-2.7.6.tar.gz",
            "has_sig": false,
            "md5_digest": "8a131258df17238fa61ace91e70a35b1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 21233,
            "upload_time": "2024-04-28T02:16:34",
            "upload_time_iso_8601": "2024-04-28T02:16:34.900736Z",
            "url": "https://files.pythonhosted.org/packages/db/55/37998968ee88072c030ca58d24c2527209550ba0c4b468176ee97076bb90/scdl-2.7.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-28 02:16:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "flyingrub",
    "github_project": "scdl",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "scdl"
}
        
Elapsed time: 0.25740s