Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xtangle/zoundcloud
Chrome extension that adds download buttons to SoundCloud pages.
https://github.com/xtangle/zoundcloud
chrome-extension nightwatch nodejs soundcloud typescript webpack
Last synced: 27 days ago
JSON representation
Chrome extension that adds download buttons to SoundCloud pages.
- Host: GitHub
- URL: https://github.com/xtangle/zoundcloud
- Owner: xtangle
- License: mit
- Created: 2016-11-06T22:48:56.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T03:42:30.000Z (almost 2 years ago)
- Last Synced: 2024-08-07T23:58:07.852Z (5 months ago)
- Topics: chrome-extension, nightwatch, nodejs, soundcloud, typescript, webpack
- Language: TypeScript
- Homepage: https://chrome.google.com/webstore/detail/zoundcloud-downloader/bhnpokjikdldjiimbmoakkfekcnpkkij
- Size: 5.62 MB
- Stars: 31
- Watchers: 3
- Forks: 4
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ZoundCloud Downloader
[](https://chrome.google.com/webstore/detail/zoundcloud-downloader/bhnpokjikdldjiimbmoakkfekcnpkkij)
[](https://travis-ci.com/xtangle/zoundcloud)
[](https://coveralls.io/github/xtangle/zoundcloud?branch=master)
[](https://snyk.io/test/github/xtangle/zoundcloud?targetFile=package.json)
[](https://david-dm.org/xtangle/ZoundCloud)
[](https://david-dm.org/xtangle/ZoundCloud?type=dev)
[](https://www.codefactor.io/repository/github/xtangle/zoundcloud)
## Description
A Google Chrome extension that adds download buttons to SoundCloud web pages.
This extension will add download buttons to:
* Individual track pages.
* User pages (downloads all of a user's tracks).
* Playlist pages (downloads the entire playlist).
* Tracks that are contained in scrollable lists.
By default, when a download is started it will download the mp3 version of the song with metadata (including cover art) added.
It can be configured from the options menu to not add metadata or prefer to download songs in its uploaded format (if available).
Metadata information and cover art is automatically added to files in .mp3 format.
The added metadata includes: cover art, title, album artist, genres, duration, release year, bpm,
artist url, audio source url, and description.
Note: When metadata is enabled, download progress will not show in the browser until the entire song is downloaded.
All tracks will be downloaded to the user's default Downloads folder.
* Tracks are downloaded with the name `track_title`.
* Playlists are downloaded to a folder with the name `user_name - playlist_name`.
* User tracks are downloaded to a folder with the name `user_name`.
If a file with the same name exists, it will not be overwritten. This can be changed from
the options menu.
Special characters in the title will be replaced by an underscore (unless it's a tilda, in which
case it is replaced by a dash (-) symbol).
The extension will attempt to remove strings in track titles matching variations of
'Free Download' or 'Download Link' as the suffix. The regex used for matching is configurable.
## Installation
### From Chrome Web Store
- Install from the [extension page here](https://chrome.google.com/webstore/detail/zoundcloud-downloader/bhnpokjikdldjiimbmoakkfekcnpkkij).
### From Archive
- Go to the [Releases](https://github.com/xtangle/zoundcloud/releases) page and download the `zoundcloud-.zip` file of the release you wish to install.
- Extract the downloaded zip file to a folder anywhere.
- Open Google Chrome and navigate to `chrome://extensions`.
- Click `Load Unpacked` and choose the folder where the contents were extracted to in the first step.
### From Source
The extension is created as a Node.js project and does not come pre-packaged.
To build from source, make sure Node.js (version >= 7.6) and yarn is installed.
- Clone the project from GitHub to a local directory.
- In the project directory, run `yarn install`.
- Run either `yarn run build` (for extra logging) or `yarn run build:prod` (for production build).
- Open Google Chrome and navigate to `chrome://extensions`.
- Click `Load Unpacked` and choose the `dist` folder in this project.
## Todo
* Firefox support.
* Make downloads cancellable.
* Some visual indicator to track current and previous download progress.