| Name | soundclouder JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | |
| Summary | A library that uses SoundCloud's public API to download tracks, playlists, albums, or compilations. |
| upload_time | 2023-04-11 21:55:43 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.10 |
| license | MIT License Copyright (c) 2023 Volodymyr (1omka) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
soundcloud
soundcloud-api
playlists
metadata
mp3
opus
id3
tags
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# SoundClouder
[***SoundClouder***](https://github.com/1omka/soundclouder) is a library for downloading publicly available non-Go SoundCloud songs, playlists, albums or compilations. It also applies bundled **metadata** with tags, including album cover. Available formats are **MP3** and **OPUS**(sometimes not) with constant quality of **128kbps**. There is also support for both **HLS** & **Progressive** streams.
## **Disclaimer**
Availability of metadata from SoundCloud API responses is directly depends on whether the author/uploader provides it, so it can be inaccurate.
**For example**: there may be no album title, even if the song is in the album, and in such a situation SoundClouder will set the song title as an album title.
## **Installation**
SoundClouder depends on [mutagen](https://github.com/quodlibet/mutagen) (for metadata embedding) and [requests](https://github.com/psf/requests) libraries.
The prerequisite is also [Python](https://python.org/downloads) version 3.6 or greater (tested in Python 3.10).
How to install from PyPI with pip:
> Linux:
```bash
$ python -m pip install soundclouder
```
> Windows:
```cmd|pwsh
C:\ py.exe -m pip install soundclouder
```
## **Usage**
> Command-line interface:
```bash|cmd|pwsh
soundclouder [--help] -u "https://soundcloud.com/rick-astley-official/never-gonna-give-you-up-4"
```
> In Python:
```python
>>> from soundclouder import SoundClouder
>>> from soundclouder import Streams
>>> SoundClouder(url="...", stream_type=Streams.MP3_HLS)
>>> # With path: (Default - Current Folder)
>>> SoundClouder(url="...", base_path="E:\Music")
>>> ....
```
Raw data
{
"_id": null,
"home_page": "",
"name": "soundclouder",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "soundcloud,soundcloud-api,playlists,metadata,mp3,opus,id3,tags",
"author": "",
"author_email": "\"Volodymyr (1omka)\" <junedevs@protonmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f4/50/b0051736f8325b3d0ea63e3a4e57f87892b4fb0965e4d013a027ffc63cbd/soundclouder-0.0.2.tar.gz",
"platform": null,
"description": "# SoundClouder\r\n\r\n\r\n\r\n[***SoundClouder***](https://github.com/1omka/soundclouder) is a library for downloading publicly available non-Go SoundCloud songs, playlists, albums or compilations. It also applies bundled **metadata** with tags, including album cover. Available formats are **MP3** and **OPUS**(sometimes not) with constant quality of **128kbps**. There is also support for both **HLS** & **Progressive** streams. \r\n\r\n## **Disclaimer**\r\nAvailability of metadata from SoundCloud API responses is directly depends on whether the author/uploader provides it, so it can be inaccurate. \r\n\r\n**For example**: there may be no album title, even if the song is in the album, and in such a situation SoundClouder will set the song title as an album title.\r\n\r\n## **Installation**\r\n\r\nSoundClouder depends on [mutagen](https://github.com/quodlibet/mutagen) (for metadata embedding) and [requests](https://github.com/psf/requests) libraries. \r\n\r\nThe prerequisite is also [Python](https://python.org/downloads) version 3.6 or greater (tested in Python 3.10).\r\n\r\nHow to install from PyPI with pip:\r\n> Linux:\r\n```bash\r\n$ python -m pip install soundclouder\r\n```\r\n> Windows: \r\n```cmd|pwsh\r\nC:\\ py.exe -m pip install soundclouder\r\n```\r\n\r\n## **Usage**\r\n> Command-line interface:\r\n```bash|cmd|pwsh\r\nsoundclouder [--help] -u \"https://soundcloud.com/rick-astley-official/never-gonna-give-you-up-4\"\r\n```\r\n> In Python:\r\n```python\r\n>>> from soundclouder import SoundClouder\r\n>>> from soundclouder import Streams\r\n>>> SoundClouder(url=\"...\", stream_type=Streams.MP3_HLS)\r\n>>> # With path: (Default - Current Folder)\r\n>>> SoundClouder(url=\"...\", base_path=\"E:\\Music\")\r\n>>> ....\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2023 Volodymyr (1omka) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "A library that uses SoundCloud's public API to download tracks, playlists, albums, or compilations.",
"version": "0.0.2",
"split_keywords": [
"soundcloud",
"soundcloud-api",
"playlists",
"metadata",
"mp3",
"opus",
"id3",
"tags"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5f52e06bc6c781d55677a831fc083aa9ab7fc31b22c9ef689030c410fdebb5a9",
"md5": "431a7cc31e8cecae5b4b3055010009d3",
"sha256": "6d76e4a2f1102140c677939949d4f192f34f7f0a236a561088e04c9ceffd858d"
},
"downloads": -1,
"filename": "soundclouder-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "431a7cc31e8cecae5b4b3055010009d3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 12244,
"upload_time": "2023-04-11T21:55:41",
"upload_time_iso_8601": "2023-04-11T21:55:41.428380Z",
"url": "https://files.pythonhosted.org/packages/5f/52/e06bc6c781d55677a831fc083aa9ab7fc31b22c9ef689030c410fdebb5a9/soundclouder-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f450b0051736f8325b3d0ea63e3a4e57f87892b4fb0965e4d013a027ffc63cbd",
"md5": "050ad574692ff155fcd89f998007a5f6",
"sha256": "29130b15e3f0691b8e556a11d00e540810a8a128c1e72f8802908579e868acda"
},
"downloads": -1,
"filename": "soundclouder-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "050ad574692ff155fcd89f998007a5f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 99579,
"upload_time": "2023-04-11T21:55:43",
"upload_time_iso_8601": "2023-04-11T21:55:43.640720Z",
"url": "https://files.pythonhosted.org/packages/f4/50/b0051736f8325b3d0ea63e3a4e57f87892b4fb0965e4d013a027ffc63cbd/soundclouder-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-11 21:55:43",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "soundclouder"
}
