{"id":13607887,"url":"https://github.com/costis94/bookcut","last_synced_at":"2025-04-12T14:31:26.327Z","repository":{"id":44042465,"uuid":"280670150","full_name":"costis94/bookcut","owner":"costis94","description":"Command Line Interface tool to download, organise and search free ebooks from your terminal in a moment. ","archived":false,"fork":false,"pushed_at":"2022-02-12T18:47:04.000Z","size":177,"stargazers_count":189,"open_issues_count":7,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T02:46:27.719Z","etag":null,"topics":["command-line-tool","ebook","epub","free-ebooks","genre","isbn","libgen","openlibrary","organiser","python","python3","terminal-based"],"latest_commit_sha":null,"homepage":"","language":"Python","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/costis94.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-18T14:13:17.000Z","updated_at":"2025-03-23T22:53:41.000Z","dependencies_parsed_at":"2022-09-19T14:01:36.443Z","dependency_job_id":null,"html_url":"https://github.com/costis94/bookcut","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costis94%2Fbookcut","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costis94%2Fbookcut/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costis94%2Fbookcut/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costis94%2Fbookcut/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/costis94","download_url":"https://codeload.github.com/costis94/bookcut/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248581155,"owners_count":21128112,"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":["command-line-tool","ebook","epub","free-ebooks","genre","isbn","libgen","openlibrary","organiser","python","python3","terminal-based"],"created_at":"2024-08-01T19:01:22.507Z","updated_at":"2025-04-12T14:31:25.959Z","avatar_url":"https://github.com/costis94.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\n\u003cimg src=\"https://i.imgur.com/ZUX2ehE.png\" width=\"256\" height=\"69\"\u003e\n\n[![Downloads](https://pepy.tech/badge/bookcut)](https://pepy.tech/project/bookcut) ![pypi](https://img.shields.io/pypi/v/pip.svg)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\nBookCut is a Python Command Line Interface tool, that help the user to download **free e-books**,\n**organise** them in folders by genre, **retrieve** book details by *ISBN* or *title*,\nget a list with **all the books from a writer** and save them to .txt file.\n\n*With the help of LibGen, ArXiv and OpenLibrary.*\n\n\n## REQUIREMENTS\n\n* Python 3\n* python3-pip\n\n\n## Installation\n\n* **Install with pip:**\n\n```bash\npip install bookcut\n#or if you have also Python 2\npip3 install bookcut\n```\n\n\n## Usage\n\n### Searching and downloading books:\n\n* Download a **single** book:\n\n```bash\nbookcut book -b \"White Fang\" -a \"Jack London\"\n```\n\n* Download a **list** of books:\n\n```bash\nbookcut list \"FreeEbooksToDownload.txt\"\n```\n\n* Organise a **folder** full of e-books to folders according to genre:\n\n```bash\nbookcut organise \"full/path/to/folder\"\n```\n***\n* Search **LibGen**, output the results and download e-book:\n\n```bash\nbookcut search -t 'Homer Odyssey'\n```\n\n* Search more book repositories with the **--repos** option:\n``` bash\nbookcut search -t 'Homer Odyssey' --repos 'libgen,arxiv'\n```\n  **Available book repositories: Libgen, ArXiv**\n***\n\n* Get the **details** of a book by **title and author**, or simply **ISBN**.\n\n```bash\nbookcut details -b 'Homer Iliad'\n```\n\n* Get a list with *all the books* from an **author**,with an option to save to .txt:\n\n```bash\nbookcut all-books -author 'Stephen King'\n```\n***\n### Searching and downloading articles:\nNow you can use bookcut to search and download **scientific articles**.\n\n - Search with the Digital Object Identifier:\n```\n bookcut article --doi \"10.1126/science.196.4287.293\"\n```\n- Search with the exact title:\n```  \n bookcut article --title \"Ribulose Bisphosphate Carboxylase  A Two-Layered, Square-Shaped Molecule of Symmetry\"\n```\n****\n### Configuration\n* Also you can change some basic settings of BookCut. For more check:\n\n```bash\nbookcut config --help\n```\n\n## TO-DO\n* Add Tests\n* Add documentation\n* Add more sources with free e-books\n* Fix organiser so it can use all types of files\n* Add a logger.\n\n## Copyrights\nPlease use the bookcut app to download **only free e-books** that are legally distributing through *BookCut repositories.*\nBookcut contributors do not have any responsibility for the use of the tool.\n## Contributing\nPull requests are welcome, this is my first project so be kind.\nFor major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcostis94%2Fbookcut","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcostis94%2Fbookcut","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcostis94%2Fbookcut/lists"}