{"id":15040699,"url":"https://github.com/jedwards1230/libro-client","last_synced_at":"2025-04-14T18:33:51.282Z","repository":{"id":228095840,"uuid":"773087583","full_name":"jedwards1230/libro-client","owner":"jedwards1230","description":"Library for downloading Libro.fm audiobooks","archived":false,"fork":false,"pushed_at":"2024-12-07T18:04:57.000Z","size":18137,"stargazers_count":8,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T16:18:24.904Z","etag":null,"topics":["audiobooks","docker","librofm","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/libro-client","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jedwards1230.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-03-16T17:58:04.000Z","updated_at":"2025-02-21T20:24:33.000Z","dependencies_parsed_at":"2024-03-17T05:00:47.365Z","dependency_job_id":"a50d7d9a-4237-429c-952b-5ddc0ea6f990","html_url":"https://github.com/jedwards1230/libro-client","commit_stats":null,"previous_names":["jedwards1230/libro-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jedwards1230%2Flibro-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jedwards1230%2Flibro-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jedwards1230%2Flibro-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jedwards1230%2Flibro-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jedwards1230","download_url":"https://codeload.github.com/jedwards1230/libro-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248937143,"owners_count":21186170,"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","docker","librofm","typescript"],"created_at":"2024-09-24T20:44:56.455Z","updated_at":"2025-04-14T18:33:51.247Z","avatar_url":"https://github.com/jedwards1230.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Libro.fm CLI Tool\n\nThis is a simple command-line tool for interacting with your Libro.fm library. It allows you to:\n\n- List all audiobooks in your library\n- Download audiobooks to your computer\n- Check for new audiobooks in your library\n- Run as a background service\n\n## Command-line interface\n\n### Installation\n\nThe CLI can be installed as a global package using npm:\n\n```bash\nbun add -g libro-client\n```\n\nTo run the tool, use the following command:\n\n```bash\nlibro\n```\n\nThis will display a list of available commands.\n\n### List audiobooks\n\nTo list all audiobooks in your library, run the following command:\n\n```bash\nlibro list\n```\n\nThis will print a list of audiobook titles to the console.\n\n### Download audiobooks\n\nTo download a specific audiobook, run the following command:\n\n```bash\nlibro get [...isbns]\n```\n\nTo choose an audiobook from your library, run the following command:\n\n```bash\nlibro get\n```\n\nReplace `[...isbns]` with the ISBN of the audiobook you want to download. You can find the ISBN by running the list command.\n\nIf you don't specify an ISBN, the tool will prompt you to select an audiobook from your library.\n\n### Check for new audiobooks\n\nTo check for new audiobooks in your library, run the following command:\n\n```bash\nlibro check\n```\n\nThis will print a list of new audiobooks to the console. You can also use the --json flag to output the data as JSON.\n\n## Background service\n\nThe tool can also be run as a background service. This is useful if you want to automatically download new audiobooks as they become available in your library.\n\nTo run the service, you can use Docker or another process manager.\n\n### Docker\n\nTo run the service using Docker, use the following command:\n\n```bash\ndocker build -t libro .\ndocker run -d libro\n```\n\nOr use the provided `docker-compose.yml` file:\n\n```bash\ndocker-compose up -d\n```\n\n\n## Configuration\n\nYou can set the following environment variables:\n\n```bash\nDEBUG=false\nLIBROFM_USERNAME=\u003cyour_librofm_username\u003e\nLIBROFM_PASSWORD=\u003cyour_librofm_password\u003e\n```\n\n## Disclaimer\n\nThis tool is not affiliated with Libro.fm in any way. Use it at your own risk.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjedwards1230%2Flibro-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjedwards1230%2Flibro-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjedwards1230%2Flibro-client/lists"}