| Name | qobuz-dl JSON |
| Version |
0.9.9.10
JSON |
| download |
| home_page | https://github.com/vitiko98/Qobuz-DL |
| Summary | The complete Lossless and Hi-Res music downloader for Qobuz |
| upload_time | 2023-03-26 19:34:04 |
| maintainer | |
| docs_url | None |
| author | Vitiko |
| requires_python | >=3.6 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# qobuz-dl
Search, explore and download Lossless and Hi-Res music from [Qobuz](https://www.qobuz.com/).
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=VZWSWVGZGJRMU&source=url)
## Features
* Download FLAC and MP3 files from Qobuz
* Explore and download music directly from your terminal with **interactive** or **lucky** mode
* Download albums, tracks, artists, playlists and labels with **download** mode
* Download music from last.fm playlists (Spotify, Apple Music and Youtube playlists are also supported through this method)
* Queue support on **interactive** mode
* Effective duplicate handling with own portable database
* Support for albums with multiple discs
* Support for M3U playlists
* Downloads URLs from text file
* Extended tags
* And more
## Getting started
> You'll need an **active subscription**
#### Install qobuz-dl with pip
##### Linux / MAC OS
```
pip3 install --upgrade qobuz-dl
```
##### Windows
```
pip3 install windows-curses
pip3 install --upgrade qobuz-dl
```
#### Run qobuz-dl and enter your credentials
##### Linux / MAC OS
```
qobuz-dl
```
##### Windows
```
qobuz-dl.exe
```
> If something fails, run `qobuz-dl -r` to reset your config file.
## Examples
### Download mode
Download URL in 24B<96khz quality
```
qobuz-dl dl https://play.qobuz.com/album/qxjbxh1dc3xyb -q 7
```
Download multiple URLs to custom directory
```
qobuz-dl dl https://play.qobuz.com/artist/2038380 https://play.qobuz.com/album/ip8qjy1m6dakc -d "Some pop from 2020"
```
Download multiple URLs from text file
```
qobuz-dl dl this_txt_file_has_urls.txt
```
Download albums from a label and also embed cover art images into the downloaded files
```
qobuz-dl dl https://play.qobuz.com/label/7526 --embed-art
```
Download a Qobuz playlist in maximum quality
```
qobuz-dl dl https://play.qobuz.com/playlist/5388296 -q 27
```
Download all the music from an artist except singles, EPs and VA releases
```
qobuz-dl dl https://play.qobuz.com/artist/2528676 --albums-only
```
#### Last.fm playlists
> Last.fm has a new feature for creating playlists: you can create your own based on the music you listen to or you can import one from popular streaming services like Spotify, Apple Music and Youtube. Visit: `https://www.last.fm/user/<your profile>/playlists` (e.g. https://www.last.fm/user/vitiko98/playlists) to get started.
Download a last.fm playlist in the maximum quality
```
qobuz-dl dl https://www.last.fm/user/vitiko98/playlists/11887574 -q 27
```
Run `qobuz-dl dl --help` for more info.
### Interactive mode
Run interactive mode with a limit of 10 results
```
qobuz-dl fun -l 10
```
Type your search query
```
Logging...
Logged: OK
Membership: Studio
Enter your search: [Ctrl + c to quit]
- fka twigs magdalene
```
`qobuz-dl` will bring up a nice list of releases. Now choose whatever releases you want to download (everything else is interactive).
Run `qobuz-dl fun --help` for more info.
### Lucky mode
Download the first album result
```
qobuz-dl lucky playboi carti die lit
```
Download the first 5 artist results
```
qobuz-dl lucky joy division -n 5 --type artist
```
Download the first 3 track results in 320 quality
```
qobuz-dl lucky eric dolphy remastered --type track -n 3 -q 5
```
Download the first track result without cover art
```
qobuz-dl lucky jay z story of oj --type track --no-cover
```
Run `qobuz-dl lucky --help` for more info.
### Other
Reset your config file
```
qobuz-dl -r
```
By default, `qobuz-dl` will skip already downloaded items by ID with the message `This release ID ({item_id}) was already downloaded`. To avoid this check, add the flag `--no-db` at the end of a command. In extreme cases (e.g. lost collection), you can run `qobuz-dl -p` to completely reset the database.
## Usage
```
usage: qobuz-dl [-h] [-r] {fun,dl,lucky} ...
The ultimate Qobuz music downloader.
See usage examples on https://github.com/vitiko98/qobuz-dl
optional arguments:
-h, --help show this help message and exit
-r, --reset create/reset config file
-p, --purge purge/delete downloaded-IDs database
commands:
run qobuz-dl <command> --help for more info
(e.g. qobuz-dl fun --help)
{fun,dl,lucky}
fun interactive mode
dl input mode
lucky lucky mode
```
## Module usage
Using `qobuz-dl` as a module is really easy. Basically, the only thing you need is `QobuzDL` from `core`.
```python
import logging
from qobuz_dl.core import QobuzDL
logging.basicConfig(level=logging.INFO)
email = "your@email.com"
password = "your_password"
qobuz = QobuzDL()
qobuz.get_tokens() # get 'app_id' and 'secrets' attrs
qobuz.initialize_client(email, password, qobuz.app_id, qobuz.secrets)
qobuz.handle_url("https://play.qobuz.com/album/va4j3hdlwaubc")
```
Attributes, methods and parameters have been named as self-explanatory as possible.
## A note about Qo-DL
`qobuz-dl` is inspired in the discontinued Qo-DL-Reborn. This tool uses two modules from Qo-DL: `qopy` and `spoofer`, both written by Sorrow446 and DashLt.
## Disclaimer
* This tool was written for educational purposes. I will not be responsible if you use this program in bad faith. By using it, you are accepting the [Qobuz API Terms of Use](https://static.qobuz.com/apps/api/QobuzAPI-TermsofUse.pdf).
* `qobuz-dl` is not affiliated with Qobuz
Raw data
{
"_id": null,
"home_page": "https://github.com/vitiko98/Qobuz-DL",
"name": "qobuz-dl",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Vitiko",
"author_email": "vhnz98@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8c/5b/ae62a2607b64134efcefccfb0b858b6017506c72738606c3b30e3bab3ea0/qobuz-dl-0.9.9.10.tar.gz",
"platform": null,
"description": "# qobuz-dl\nSearch, explore and download Lossless and Hi-Res music from [Qobuz](https://www.qobuz.com/).\n[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=VZWSWVGZGJRMU&source=url)\n\n## Features\n\n* Download FLAC and MP3 files from Qobuz\n* Explore and download music directly from your terminal with **interactive** or **lucky** mode\n* Download albums, tracks, artists, playlists and labels with **download** mode\n* Download music from last.fm playlists (Spotify, Apple Music and Youtube playlists are also supported through this method)\n* Queue support on **interactive** mode\n* Effective duplicate handling with own portable database\n* Support for albums with multiple discs\n* Support for M3U playlists\n* Downloads URLs from text file\n* Extended tags\n* And more\n\n## Getting started\n\n> You'll need an **active subscription**\n\n#### Install qobuz-dl with pip\n##### Linux / MAC OS\n```\npip3 install --upgrade qobuz-dl\n```\n##### Windows\n```\npip3 install windows-curses\npip3 install --upgrade qobuz-dl\n```\n#### Run qobuz-dl and enter your credentials\n##### Linux / MAC OS\n```\nqobuz-dl\n```\n##### Windows\n```\nqobuz-dl.exe\n```\n\n> If something fails, run `qobuz-dl -r` to reset your config file.\n\n## Examples\n\n### Download mode\nDownload URL in 24B<96khz quality\n```\nqobuz-dl dl https://play.qobuz.com/album/qxjbxh1dc3xyb -q 7\n```\nDownload multiple URLs to custom directory\n```\nqobuz-dl dl https://play.qobuz.com/artist/2038380 https://play.qobuz.com/album/ip8qjy1m6dakc -d \"Some pop from 2020\"\n```\nDownload multiple URLs from text file\n```\nqobuz-dl dl this_txt_file_has_urls.txt\n```\nDownload albums from a label and also embed cover art images into the downloaded files\n```\nqobuz-dl dl https://play.qobuz.com/label/7526 --embed-art\n```\nDownload a Qobuz playlist in maximum quality\n```\nqobuz-dl dl https://play.qobuz.com/playlist/5388296 -q 27\n```\nDownload all the music from an artist except singles, EPs and VA releases\n```\nqobuz-dl dl https://play.qobuz.com/artist/2528676 --albums-only\n```\n\n#### Last.fm playlists\n> Last.fm has a new feature for creating playlists: you can create your own based on the music you listen to or you can import one from popular streaming services like Spotify, Apple Music and Youtube. Visit: `https://www.last.fm/user/<your profile>/playlists` (e.g. https://www.last.fm/user/vitiko98/playlists) to get started.\n\nDownload a last.fm playlist in the maximum quality\n```\nqobuz-dl dl https://www.last.fm/user/vitiko98/playlists/11887574 -q 27\n```\n\nRun `qobuz-dl dl --help` for more info.\n\n### Interactive mode\nRun interactive mode with a limit of 10 results\n```\nqobuz-dl fun -l 10\n```\nType your search query\n```\nLogging...\nLogged: OK\nMembership: Studio\n\n\nEnter your search: [Ctrl + c to quit]\n- fka twigs magdalene\n```\n`qobuz-dl` will bring up a nice list of releases. Now choose whatever releases you want to download (everything else is interactive).\n\nRun `qobuz-dl fun --help` for more info.\n\n### Lucky mode\nDownload the first album result\n```\nqobuz-dl lucky playboi carti die lit\n```\nDownload the first 5 artist results\n```\nqobuz-dl lucky joy division -n 5 --type artist\n```\nDownload the first 3 track results in 320 quality\n```\nqobuz-dl lucky eric dolphy remastered --type track -n 3 -q 5\n```\nDownload the first track result without cover art\n```\nqobuz-dl lucky jay z story of oj --type track --no-cover\n```\n\nRun `qobuz-dl lucky --help` for more info.\n\n### Other\nReset your config file\n```\nqobuz-dl -r\n```\n\nBy default, `qobuz-dl` will skip already downloaded items by ID with the message `This release ID ({item_id}) was already downloaded`. To avoid this check, add the flag `--no-db` at the end of a command. In extreme cases (e.g. lost collection), you can run `qobuz-dl -p` to completely reset the database.\n\n## Usage\n```\nusage: qobuz-dl [-h] [-r] {fun,dl,lucky} ...\n\nThe ultimate Qobuz music downloader.\nSee usage examples on https://github.com/vitiko98/qobuz-dl\n\noptional arguments:\n -h, --help show this help message and exit\n -r, --reset create/reset config file\n -p, --purge purge/delete downloaded-IDs database\n\ncommands:\n run qobuz-dl <command> --help for more info\n (e.g. qobuz-dl fun --help)\n\n {fun,dl,lucky}\n fun interactive mode\n dl input mode\n lucky lucky mode\n```\n\n## Module usage \nUsing `qobuz-dl` as a module is really easy. Basically, the only thing you need is `QobuzDL` from `core`.\n\n```python\nimport logging\nfrom qobuz_dl.core import QobuzDL\n\nlogging.basicConfig(level=logging.INFO)\n\nemail = \"your@email.com\"\npassword = \"your_password\"\n\nqobuz = QobuzDL()\nqobuz.get_tokens() # get 'app_id' and 'secrets' attrs\nqobuz.initialize_client(email, password, qobuz.app_id, qobuz.secrets)\n\nqobuz.handle_url(\"https://play.qobuz.com/album/va4j3hdlwaubc\")\n```\n\nAttributes, methods and parameters have been named as self-explanatory as possible.\n\n## A note about Qo-DL\n`qobuz-dl` is inspired in the discontinued Qo-DL-Reborn. This tool uses two modules from Qo-DL: `qopy` and `spoofer`, both written by Sorrow446 and DashLt.\n## Disclaimer\n* This tool was written for educational purposes. I will not be responsible if you use this program in bad faith. By using it, you are accepting the [Qobuz API Terms of Use](https://static.qobuz.com/apps/api/QobuzAPI-TermsofUse.pdf).\n* `qobuz-dl` is not affiliated with Qobuz\n",
"bugtrack_url": null,
"license": "",
"summary": "The complete Lossless and Hi-Res music downloader for Qobuz",
"version": "0.9.9.10",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3da4ec855fa6157a64c3c62086204442881f6ddf497f189fa4f3999f2190afff",
"md5": "ecef3dee02efc5466a374e782258d6f3",
"sha256": "48e6b09cc03b4f1621867667afd91f550cbe9823729ffa8e9400b90631ebcd4d"
},
"downloads": -1,
"filename": "qobuz_dl-0.9.9.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ecef3dee02efc5466a374e782258d6f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 37670,
"upload_time": "2023-03-26T19:34:02",
"upload_time_iso_8601": "2023-03-26T19:34:02.031009Z",
"url": "https://files.pythonhosted.org/packages/3d/a4/ec855fa6157a64c3c62086204442881f6ddf497f189fa4f3999f2190afff/qobuz_dl-0.9.9.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8c5bae62a2607b64134efcefccfb0b858b6017506c72738606c3b30e3bab3ea0",
"md5": "985837a373fbd79ea5b011d8e68f6eb7",
"sha256": "abb4d4977b1c83e8aca0b074c49bc92c2b6f254ecefa880c95fb6dd0eef7a9be"
},
"downloads": -1,
"filename": "qobuz-dl-0.9.9.10.tar.gz",
"has_sig": false,
"md5_digest": "985837a373fbd79ea5b011d8e68f6eb7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 35976,
"upload_time": "2023-03-26T19:34:04",
"upload_time_iso_8601": "2023-03-26T19:34:04.794179Z",
"url": "https://files.pythonhosted.org/packages/8c/5b/ae62a2607b64134efcefccfb0b858b6017506c72738606c3b30e3bab3ea0/qobuz-dl-0.9.9.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-26 19:34:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "vitiko98",
"github_project": "Qobuz-DL",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "qobuz-dl"
}
