{"id":13623783,"url":"https://github.com/jo1gi/audiobook-dl","last_synced_at":"2025-12-14T15:31:58.636Z","repository":{"id":41506783,"uuid":"331098682","full_name":"jo1gi/audiobook-dl","owner":"jo1gi","description":"Audiobook CLI downloader","archived":false,"fork":false,"pushed_at":"2025-01-23T09:45:10.000Z","size":302,"stargazers_count":294,"open_issues_count":59,"forks_count":50,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-26T02:03:16.057Z","etag":null,"topics":["audiobooks","cli","downloader"],"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/jo1gi.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":"supported_sites.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"jo1gi"}},"created_at":"2021-01-19T20:17:31.000Z","updated_at":"2025-03-24T22:39:23.000Z","dependencies_parsed_at":"2022-07-08T02:20:41.927Z","dependency_job_id":"9df39d65-8349-4693-aa4a-20610420b86b","html_url":"https://github.com/jo1gi/audiobook-dl","commit_stats":{"total_commits":170,"total_committers":4,"mean_commits":42.5,"dds":0.05294117647058827,"last_synced_commit":"ef4d93a506ec38c06dc2f4b0ff1d513af0d0c27c"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jo1gi%2Faudiobook-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jo1gi%2Faudiobook-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jo1gi%2Faudiobook-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jo1gi%2Faudiobook-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jo1gi","download_url":"https://codeload.github.com/jo1gi/audiobook-dl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249148082,"owners_count":21220469,"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":["audiobooks","cli","downloader"],"created_at":"2024-08-01T21:01:35.558Z","updated_at":"2025-12-14T15:31:58.593Z","avatar_url":"https://github.com/jo1gi.png","language":"Python","funding_links":["https://ko-fi.com/jo1gi","https://www.buymeacoffee.com/joakimholm"],"categories":["Python"],"sub_categories":[],"readme":"# 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\u0026logoColor=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](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 \u003ccookie file\u003e \u003curl\u003e\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## Configuration\naudiobook-dl can be configured using a configuration file, which should be placed at:\n- Windows: `C:\\\\Users\\\\$user\\\\AppData\\\\Local\\\\jo1gi\\\\audiobook-dl\\\\audiobook-dl.toml`\n- Mac: `/Users/$user/Library/Application Support/audiobook-dl/audiobook-dl.toml`\n- Linux `$XDG_CONFIG_DIR/audiobook-dl/audiobook-dl.toml`\n\n### Authentications\nSource credentials can be provided in the configuration file:\n```toml\n[sources.yourcloudlibrary]\nusername = \"yourusername\"\npassword = \"supersecretpassword\"\nlibrary = \"hometown\"\n```\n\nCookie files can be specified in a similar way:\n```toml\n[sources.everand]\ncookie_file = \"./everand_cookies.txt\"\n```\nPaths are relative to the configuration directory.\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\u003cdetails\u003e\n\u003csummary\u003eCryptocurrencies\u003c/summary\u003e\n\n- Bitcoin: bc1qrh8hcnw0fd22y7rmljlmrztwrz2nd5tqckrt44\n- Bitcoin Cash: qp6rt9zx7tfyu9e4alxcn5yf4re5pfztvu8yx0rywh\n- Dash: XfgopGkj4BBpuzsUvrbj9jenXUZ6dXsr3J\n- Etherium: 0x8f5d2eb6d2a4d4615d2b9b1cfa28b4c5b9d18f9f\n- Litecoin: ltc1qfz2936a04m2h7t0srxftygjrq759auav7ndfd3\n- Monero: 853tLAbK5wQ93mdj884C31JGKBUEJCpM25gEjGGLnuVDc8PEDMJi6uC5Vcz9g37K2PeT8FY1bjEveUWqJXNPotFRLwLnn9a\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjo1gi%2Faudiobook-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjo1gi%2Faudiobook-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjo1gi%2Faudiobook-dl/lists"}