Name | audiobook-dl JSON |
Version | 0.7.3 JSON |
download | |
home_page | |
Summary | CLI tool for downloading audiobooks from online sources |
upload_time | 2024-01-26 22:49:04 |
maintainer | |
docs_url | None |
author | |
requires_python | |
license | |
keywords | audiobooks cli downloader |
VCS | |
bugtrack_url | |
requirements | No requirements were recorded. |
Travis-CI | No Travis. |
coveralls test coverage | No coveralls. |
# audiobook-dl ![GitHub release](https://img.shields.io/github/v/release/jo1gi/audiobook-dl) ![GitHub top language](https://img.shields.io/github/languages/top/jo1gi/audiobook-dl) ![License](https://img.shields.io/github/license/jo1gi/audiobook-dl) [![Donate using Ko-Fi](https://img.shields.io/badge/donate-kofi-00b9fe?logo=ko-fi&logoColor=00b9fe)](https://ko-fi.com/jo1gi) CLI tool for downloading audiobooks from online sources. ## Supported Services audiobook-dl currently supports downloading from the following sources: - [audiobooks.com](https://audiobooks.com) - [Blinkist](https://www.blinkist.com) - [Chirp](https://www.chirpbooks.com/) - [eReolen](https://ereolen.dk) - [Everand (previously Scribd)](https://everand.com) - [Librivox](https://librivox.org) - [Nextory](https://nextory.com) - [Overdrive / Libby](https://www.overdrive.com/) - [Podimo](https://podimo.com) - [Saxo](https://saxo.com) - [Storytel](https://www.storytel.com/) / [Mofibo](https://mofibo.com) - [YourCloudLibrary](https://www.yourcloudlibrary.com/) [More info](./supported_sites.md) ## Installation audiobook-dl can be installed from the repo itself or through pip. To get the newest stable version with pip run: ```shell pip install audiobook-dl ``` If you want to use the newest version (can be unstable) run: ```shell pip install "git+https://github.com/jo1gi/audiobook-dl.git" ``` or ```shell git clone https://github.com/jo1gi/audiobook-dl.git cd audiobook-dl python3 setup.py install ``` Some features require [ffmpeg](https://ffmpeg.org/) which can be installed through most package managers or from [ffmpeg.org/download.html](https://ffmpeg.org/download.html). ## Authentication ### Cookies audiobook-dl uses Netscape cookie files for authentication in most cases. I use [this](https://github.com/rotemdan/ExportCookies) extension to export my cookies from the browser. Cookies can be placed in current dir as `cookies.txt` or be given with the `--cookie` argument. ### Login [Some sources](./supported_sites.md) support authentication through login with username and password (and sometimes library). Use the `--username` and `--password` arguments or enter them through an interactive prompt. ## Downloading audiobooks ```shell audiobook-dl -c <cookie file> <url> ``` **Most sites require you to provide the listening page not not just the information page** ## Arguments | Argument | Value | |-------------------|-------------------------------------------------------------------| | url | The url of the page where you listen to the audiobook | | -c/--cookie | Path to a Netscape cookie file | | --combine | Combine all output files into a single file (requires ffmpeg) | | --cover | Only download cover | | -d/--debug | Print debug information | | -o/--output | Output location | | --remove-chars | List of characters that will be removed from output path | | --no-chapters | Don't include chapters in output file | | --output-format | Output file format | | --verbose--ffmpeg | Show ffmpeg output in terminal | | --username | Username to source (Required when using login) | | --password | Password to source (Required when using login) | | --library | Specific library on service (Sometimes required when using login) | ## Output By default, audiobook-dl saves all audiobooks to `{title}` relative to the current path. This can be changed with the `--output` argument. Path can be customized by audiobook with the following fields: - `title` - `author` - `series` - `narrator` Not all fields are available for all audiobooks. The file extension can be changed with the `--output-format` argument. ## Contributions Issues, bug-reports, pull requests or ideas for features and improvements are **very welcome**. ## Donations If you like the project, please consider donating: - [Ko-fi](https://ko-fi.com/jo1gi) - [Buy me a Coffee](https://www.buymeacoffee.com/joakimholm) <details> <summary>Cryptocurrencies</summary> - Bitcoin: bc1qrh8hcnw0fd22y7rmljlmrztwrz2nd5tqckrt44 - Bitcoin Cash: qp6rt9zx7tfyu9e4alxcn5yf4re5pfztvu8yx0rywh - Dash: XfgopGkj4BBpuzsUvrbj9jenXUZ6dXsr3J - Etherium: 0x8f5d2eb6d2a4d4615d2b9b1cfa28b4c5b9d18f9f - Litecoin: ltc1qfz2936a04m2h7t0srxftygjrq759auav7ndfd3 - Monero: 853tLAbK5wQ93mdj884C31JGKBUEJCpM25gEjGGLnuVDc8PEDMJi6uC5Vcz9g37K2PeT8FY1bjEveUWqJXNPotFRLwLnn9a </details>
{ "_id": null, "home_page": "", "name": "audiobook-dl", "maintainer": "", "docs_url": null, "requires_python": "", "maintainer_email": "", "keywords": "audiobooks,cli,downloader", "author": "", "author_email": "Joakim Holm <mail@joakimholm.xyz>", "download_url": "https://files.pythonhosted.org/packages/61/f8/85ce982c7415ff9d116292cb8aa5d313abd50301ab34b2892921e1f92a73/audiobook-dl-0.7.3.tar.gz", "platform": null, "description": "# audiobook-dl\n![GitHub release](https://img.shields.io/github/v/release/jo1gi/audiobook-dl)\n![GitHub top language](https://img.shields.io/github/languages/top/jo1gi/audiobook-dl)\n![License](https://img.shields.io/github/license/jo1gi/audiobook-dl)\n[![Donate using Ko-Fi](https://img.shields.io/badge/donate-kofi-00b9fe?logo=ko-fi&logoColor=00b9fe)](https://ko-fi.com/jo1gi)\n\nCLI tool for downloading audiobooks from online sources.\n\n## Supported Services\naudiobook-dl currently supports downloading from the following sources:\n- [audiobooks.com](https://audiobooks.com)\n- [Blinkist](https://www.blinkist.com)\n- [Chirp](https://www.chirpbooks.com/)\n- [eReolen](https://ereolen.dk)\n- [Everand (previously Scribd)](https://everand.com)\n- [Librivox](https://librivox.org)\n- [Nextory](https://nextory.com)\n- [Overdrive / Libby](https://www.overdrive.com/)\n- [Podimo](https://podimo.com)\n- [Saxo](https://saxo.com)\n- [Storytel](https://www.storytel.com/) / [Mofibo](https://mofibo.com)\n- [YourCloudLibrary](https://www.yourcloudlibrary.com/)\n\n[More info](./supported_sites.md)\n\n## Installation\naudiobook-dl can be installed from the repo itself or through pip.\n\nTo get the newest stable version with pip run:\n```shell\npip install audiobook-dl\n```\n\nIf you want to use the newest version (can be unstable) run:\n```shell\npip install \"git+https://github.com/jo1gi/audiobook-dl.git\"\n```\nor\n```shell\ngit clone https://github.com/jo1gi/audiobook-dl.git\ncd audiobook-dl\npython3 setup.py install\n```\n\nSome features require [ffmpeg](https://ffmpeg.org/) which can be installed\nthrough most package managers or from [ffmpeg.org/download.html](https://ffmpeg.org/download.html).\n\n## Authentication\n\n### Cookies\naudiobook-dl uses Netscape cookie files for authentication in most cases. I use\n[this](https://github.com/rotemdan/ExportCookies) extension to export my cookies\nfrom the browser.\n\nCookies can be placed in current dir as `cookies.txt` or be given with the\n`--cookie` argument.\n\n### Login\n[Some sources](./supported_sites.md) support authentication through login with\nusername and password (and sometimes library). Use the `--username` and\n`--password` arguments or enter them through an interactive prompt.\n\n## Downloading audiobooks\n```shell\naudiobook-dl -c <cookie file> <url>\n```\n**Most sites require you to provide the listening page not not just the\ninformation page**\n\n## Arguments\n\n| Argument | Value |\n|-------------------|-------------------------------------------------------------------|\n| url | The url of the page where you listen to the audiobook |\n| -c/--cookie | Path to a Netscape cookie file |\n| --combine | Combine all output files into a single file (requires ffmpeg) |\n| --cover | Only download cover |\n| -d/--debug | Print debug information |\n| -o/--output | Output location |\n| --remove-chars | List of characters that will be removed from output path |\n| --no-chapters | Don't include chapters in output file |\n| --output-format | Output file format |\n| --verbose--ffmpeg | Show ffmpeg output in terminal |\n| --username | Username to source (Required when using login) |\n| --password | Password to source (Required when using login) |\n| --library | Specific library on service (Sometimes required when using login) |\n\n## Output\nBy default, audiobook-dl saves all audiobooks to `{title}` relative to the\ncurrent path. This can be changed with the `--output` argument. Path can be\ncustomized by audiobook with the following fields:\n- `title`\n- `author`\n- `series`\n- `narrator`\n\nNot all fields are available for all audiobooks.\n\nThe file extension can be changed with the `--output-format` argument.\n\n## Contributions\nIssues, bug-reports, pull requests or ideas for features and improvements are\n**very welcome**.\n\n## Donations\nIf you like the project, please consider donating:\n- [Ko-fi](https://ko-fi.com/jo1gi)\n- [Buy me a Coffee](https://www.buymeacoffee.com/joakimholm)\n<details>\n<summary>Cryptocurrencies</summary>\n\n- Bitcoin: bc1qrh8hcnw0fd22y7rmljlmrztwrz2nd5tqckrt44\n- Bitcoin Cash: qp6rt9zx7tfyu9e4alxcn5yf4re5pfztvu8yx0rywh\n- Dash: XfgopGkj4BBpuzsUvrbj9jenXUZ6dXsr3J\n- Etherium: 0x8f5d2eb6d2a4d4615d2b9b1cfa28b4c5b9d18f9f\n- Litecoin: ltc1qfz2936a04m2h7t0srxftygjrq759auav7ndfd3\n- Monero: 853tLAbK5wQ93mdj884C31JGKBUEJCpM25gEjGGLnuVDc8PEDMJi6uC5Vcz9g37K2PeT8FY1bjEveUWqJXNPotFRLwLnn9a\n\n</details>\n", "bugtrack_url": null, "license": "", "summary": "CLI tool for downloading audiobooks from online sources", "version": "0.7.3", "project_urls": { "Bugtracker": "https://github.com/jo1gi/audiobook-dl/issues", "Homepage": "https://github.com/jo1gi/audiobook-dl" }, "split_keywords": [ "audiobooks", "cli", "downloader" ], "urls": [ { "comment_text": "", "digests": { "blake2b_256": "d7267b02b8b33179f600803144c8c40b75e5d74dd689543ec51e53130d9a2d68", "md5": "36cc728fd8a14ba0475e0b316d02ded3", "sha256": "06241ad7f6aed3ed28c25de1f00e2f4681d41e8a3b1bb34a034d53fc69098744" }, "downloads": -1, "filename": "audiobook_dl-0.7.3-py3-none-any.whl", "has_sig": false, "md5_digest": "36cc728fd8a14ba0475e0b316d02ded3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 67050, "upload_time": "2024-01-26T22:49:02", "upload_time_iso_8601": "2024-01-26T22:49:02.217610Z", "url": "https://files.pythonhosted.org/packages/d7/26/7b02b8b33179f600803144c8c40b75e5d74dd689543ec51e53130d9a2d68/audiobook_dl-0.7.3-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "61f885ce982c7415ff9d116292cb8aa5d313abd50301ab34b2892921e1f92a73", "md5": "459c3f72c6de7200f22e4bd641c08836", "sha256": "be8bdd514b3d518a727d21d71388fb2634fe56fc10914005670b9d49b8c04d10" }, "downloads": -1, "filename": "audiobook-dl-0.7.3.tar.gz", "has_sig": false, "md5_digest": "459c3f72c6de7200f22e4bd641c08836", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51522, "upload_time": "2024-01-26T22:49:04", "upload_time_iso_8601": "2024-01-26T22:49:04.234672Z", "url": "https://files.pythonhosted.org/packages/61/f8/85ce982c7415ff9d116292cb8aa5d313abd50301ab34b2892921e1f92a73/audiobook-dl-0.7.3.tar.gz", "yanked": false, "yanked_reason": null } ], "upload_time": "2024-01-26 22:49:04", "github": true, "gitlab": false, "bitbucket": false, "codeberg": false, "github_user": "jo1gi", "github_project": "audiobook-dl", "travis_ci": false, "coveralls": false, "github_actions": true, "lcname": "audiobook-dl" }