{"id":13579741,"url":"https://github.com/nathom/streamrip","last_synced_at":"2025-05-12T15:23:39.744Z","repository":{"id":37245917,"uuid":"350411909","full_name":"nathom/streamrip","owner":"nathom","description":"A scriptable music downloader for Qobuz, Tidal, SoundCloud, and Deezer","archived":false,"fork":false,"pushed_at":"2025-03-12T21:55:37.000Z","size":7546,"stargazers_count":3316,"open_issues_count":196,"forks_count":285,"subscribers_count":37,"default_branch":"dev","last_synced_at":"2025-05-12T15:23:37.723Z","etag":null,"topics":["deezer","hi-res","lossless-music","qobuz","soundcloud","tidal"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nathom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["nathom"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2021-03-22T16:23:36.000Z","updated_at":"2025-05-12T12:46:38.000Z","dependencies_parsed_at":"2023-10-14T18:26:58.308Z","dependency_job_id":"374d6956-d91c-4496-8566-8645d0b29518","html_url":"https://github.com/nathom/streamrip","commit_stats":{"total_commits":735,"total_committers":30,"mean_commits":24.5,"dds":0.09659863945578229,"last_synced_commit":"46b570dbb6f81d604cbaa3bfa379463e0a20a841"},"previous_names":[],"tags_count":55,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathom%2Fstreamrip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathom%2Fstreamrip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathom%2Fstreamrip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathom%2Fstreamrip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nathom","download_url":"https://codeload.github.com/nathom/streamrip/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253764014,"owners_count":21960497,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deezer","hi-res","lossless-music","qobuz","soundcloud","tidal"],"created_at":"2024-08-01T15:01:42.606Z","updated_at":"2025-05-12T15:23:39.712Z","avatar_url":"https://github.com/nathom.png","language":"Python","funding_links":["https://github.com/sponsors/nathom"],"categories":["Python","Table of Contents","Media"],"sub_categories":["Media Downloader","Other"],"readme":"![streamrip logo](https://github.com/nathom/streamrip/blob/dev/demo/logo.svg?raw=true)\n\n[![Downloads](https://pepy.tech/badge/streamrip)](https://pepy.tech/project/streamrip)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)\n\nA scriptable stream downloader for Qobuz, Tidal, Deezer and SoundCloud.\n\n![downloading an album](https://github.com/nathom/streamrip/blob/dev/demo/download_album.png?raw=true)\n\n## Features\n\n- Fast, concurrent downloads powered by `aiohttp`\n- Downloads tracks, albums, playlists, discographies, and labels from Qobuz, Tidal, Deezer, and SoundCloud\n- Supports downloads of Spotify and Apple Music playlists through [last.fm](https://www.last.fm)\n- Automatically converts files to a preferred format\n- Has a database that stores the downloaded tracks' IDs so that repeats are avoided\n- Concurrency and rate limiting\n- Interactive search for all sources\n- Highly customizable through the config file\n- Integration with `youtube-dl`\n\n## Installation\n\nFirst, ensure [Python](https://www.python.org/downloads/) (version 3.10 or greater) and [pip](https://pip.pypa.io/en/stable/installing/) are installed. Then install `ffmpeg`. You may choose not to install this, but some functionality will be limited.\n\n```bash\npip3 install streamrip --upgrade\n```\n\nIf you run into issues, try installing directly from the `dev` branch:\n\n```bash\npip3 install git+https://github.com/nathom/streamrip.git@dev\n```\n\nWhen you type\n\n```bash\nrip\n```\n\nit should show the main help page. If you have no idea what these mean, or are having other issues installing, check out the [detailed installation instructions](https://github.com/nathom/streamrip/wiki#detailed-installation-instructions).\n\nFor Arch Linux users, an AUR package exists. Make sure to install required packages from the AUR before using `makepkg` or use an AUR helper to automatically resolve them.\n```\ngit clone https://aur.archlinux.org/streamrip.git\ncd streamrip\nmakepkg -si\n```\n or\n ```\nparu -S streamrip\n```\n\nAlternatively, for users of Homebrew, you can install streamrip through brew.\n```\nbrew install streamrip\n```\n\n### Streamrip beta\n\nIf you want to get access to the latest and greatest features without waiting for a new release, install\nfrom the `dev` branch with the following command\n\n```bash\npip3 install git+https://github.com/nathom/streamrip.git@dev\n```\n\n## Example Usage\n\n**For Tidal and Qobuz, you NEED a premium subscription.**\n\nDownload an album from Qobuz\n\n```bash\nrip url https://www.qobuz.com/us-en/album/rumours-fleetwood-mac/0603497941032\n```\n\nDownload multiple albums from Qobuz\n\n```bash\nrip url https://www.qobuz.com/us-en/album/back-in-black-ac-dc/0886444889841 https://www.qobuz.com/us-en/album/blue-train-john-coltrane/0060253764852\n```\n\nDownload the album and convert it to `mp3`\n\n```bash\nrip --codec mp3 url https://open.qobuz.com/album/0060253780968\n```\n\nTo set the maximum quality, use the `--quality` option to `0, 1, 2, 3, 4`:\n\n| Quality ID | Audio Quality         | Available Sources                            |\n| ---------- | --------------------- | -------------------------------------------- |\n| 0          | 128 kbps MP3 or AAC   | Deezer, Tidal, SoundCloud (most of the time) |\n| 1          | 320 kbps MP3 or AAC   | Deezer, Tidal, Qobuz, SoundCloud (rarely)    |\n| 2          | 16 bit, 44.1 kHz (CD) | Deezer, Tidal, Qobuz, SoundCloud (rarely)    |\n| 3          | 24 bit, ≤ 96 kHz      | Tidal (MQA), Qobuz, SoundCloud (rarely)      |\n| 4          | 24 bit, ≤ 192 kHz     | Qobuz                                        |\n\n```bash\nrip --quality 3 url https://tidal.com/browse/album/147569387\n```\n\n\u003e Using `4` is generally a waste of space. It is impossible for humans to perceive the difference between sampling rates higher than 44.1 kHz. It may be useful if you're processing/slowing down the audio.\n\nSearch for playlists matching `rap` on Tidal\n\n```bash\nrip search tidal playlist 'rap'\n```\n\n![streamrip interactive search](https://github.com/nathom/streamrip/blob/dev/demo/playlist_search.png?raw=true)\n\nSearch for *Rumours* on Tidal, and download it\n\n```bash\nrip search tidal album 'fleetwood mac rumours'\n```\n\nDownload a last.fm playlist using the lastfm command\n\n```\nrip lastfm https://www.last.fm/user/nathan3895/playlists/12126195\n```\n\nFor more customization, see the config file\n\n```\nrip config open\n```\n\nIf you're confused about anything, see the help pages. The main help pages can be accessed by typing `rip` by itself in the command line. The help pages for each command can be accessed with the `--help` flag. For example, to see the help page for the `url` command, type\n\n```\nrip url --help\n```\n\n![example_help_page.png](https://github.com/nathom/streamrip/blob/dev/demo/example_help_page.png?raw=true)\n\n## Other information\n\nFor more in-depth information about `streamrip`, see the help pages and the [wiki](https://github.com/nathom/streamrip/wiki/).\n\n## Contributions\n\nAll contributions are appreciated! You can help out the project by opening an issue\nor by submitting code.\n\n### Issues\n\nIf you're opening an issue **use the Feature Request or Bug Report templates properly**. This ensures\nthat I have all of the information necessary to debug the issue. If you do not follow the templates,\n**I will silently close the issue** and you'll have to deal with it yourself.\n\n### Code\n\nIf you're new to Git, follow these steps to open your first Pull Request (PR):\n\n- Fork this repository\n- Clone the new repository\n- Commit your changes\n- Open a pull request to the `dev` branch\n\nPlease document any functions or obscure lines of code.\n\n### The Wiki\n\nTo help out `streamrip` users that may be having trouble, consider contributing some information to the wiki.\nNothing is too obvious and everything is appreciated.\n\n## Acknowledgements\n\nThanks to Vitiko98, Sorrow446, and DashLt for their contributions to this project, and the previous projects that made this one possible.\n\n`streamrip` was inspired by:\n\n- [qobuz-dl](https://github.com/vitiko98/qobuz-dl)\n- [Qo-DL Reborn](https://github.com/badumbass/Qo-DL-Reborn)\n- [Tidal-Media-Downloader](https://github.com/yaronzz/Tidal-Media-Downloader)\n- [scdl](https://github.com/flyingrub/scdl)\n\n## Disclaimer\n\nI will not be responsible for how **you** use `streamrip`. By using `streamrip`, you agree to the terms and conditions of the Qobuz, Tidal, and Deezer APIs.\n\n## Sponsorship\n\nConsider becoming a Github sponsor for me if you enjoy my open source software.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathom%2Fstreamrip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnathom%2Fstreamrip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathom%2Fstreamrip/lists"}