{"id":24307761,"url":"https://github.com/marsdevx/manga2books","last_synced_at":"2025-10-20T08:03:00.153Z","repository":{"id":271361258,"uuid":"912641666","full_name":"marsdevx/manga2books","owner":"marsdevx","description":"📚 Download manga in a format compatible with the Books app on iPhone, iPad, and Mac.","archived":false,"fork":false,"pushed_at":"2025-01-16T13:06:47.000Z","size":23604,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T14:32:39.710Z","etag":null,"topics":["anime","apple-book","apple-books","bash","books","books-app","cli","cli-app","converter","epub","ibooks","ipad","iphone","macbook","manga","manga-downloader","manga-reader","python","python3","zsh"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marsdevx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-01-06T05:05:04.000Z","updated_at":"2025-01-16T13:06:48.000Z","dependencies_parsed_at":"2025-01-12T07:16:49.599Z","dependency_job_id":null,"html_url":"https://github.com/marsdevx/manga2books","commit_stats":null,"previous_names":["marsdevx/manga2books"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmanga2books","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmanga2books/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmanga2books/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fmanga2books/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marsdevx","download_url":"https://codeload.github.com/marsdevx/manga2books/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234310420,"owners_count":18812095,"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":["anime","apple-book","apple-books","bash","books","books-app","cli","cli-app","converter","epub","ibooks","ipad","iphone","macbook","manga","manga-downloader","manga-reader","python","python3","zsh"],"created_at":"2025-01-17T04:19:29.008Z","updated_at":"2025-10-20T08:03:00.146Z","avatar_url":"https://github.com/marsdevx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"imgs/logo.jpg\" width=\"320px\" alt=\"Manga to Books\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n  [![Last Commit](https://custom-icon-badges.demolab.com/github/last-commit/marsdevx/manga2books?logoColor=white\u0026labelColor=2C2C2C\u0026label=Last%20Commit\u0026color=8A2BE2\u0026logo=mark-github)](https://github.com/marsdevx/manga2books/commits/main \"Last Commit\")\n  [![Shell Support](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Shell\u0026message=Zsh%20%7C%20Bash\u0026color=D32F2F\u0026logo=gnu-bash)](https://github.com/marsdevx/manga2books \"Shell Support\")\n  \u003cbr\u003e\n  [![Languages](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Languages\u0026message=Python%203.13\u0026color=748ADB\u0026logo=file-code)](https://github.com/marsdevx/manga2books \"Languages\")\n  [![Supported Platforms](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Platform\u0026message=iPhone%20%7C%20iPad%20%7C%20MacBook\u0026color=F47F42\u0026logo=apple)](https://github.com/marsdevx/manga2books \"Supported Platforms\")\n  [![Output Format](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Output%20Format\u0026message=EPUB\u0026color=009688\u0026logo=book)](https://github.com/marsdevx/manga2books \"Output Format\")\n  [![License](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=License\u0026message=MIT\u0026color=00C853\u0026logo=law)](https://github.com/marsdevx/manga2books/blob/main/LICENSE \"License\")\n\n\u003c/div\u003e\n\n---\n\n# 📚 Manga to Books\n\n**Manga to Books** is an **open-source** tool that **downloads manga** from a [Manga Dex](https://mangadex.org/) and [LH Translation](https://lhtranslation.net/home/) websites and **converts** it into the **EPUB** format, making it compatible with **Apple’s Books app** on **iPhone**, **iPad**, and **MacBook**. Built with **Python**, this program offers **the best way** to enjoy **manga** in a digital format.\n\n* Specifically designed for **Apple’s** **Books** **app** compatibility.\n* Built with Python for simplicity and **cross-platform** support.\n* Downloads **manga** and **automatically converts** it to **EPUB format**.\n* Easy-to-use **command-line** interface for quick and efficient manga conversion.\n\nEnjoy your favorite manga in high-quality EPUB format across all your Apple devices!\n\n---\n\n## 🖼️ Preview\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"imgs/preview1.PNG\" alt=\"Preview\" width=\"200\"\u003e\n  \u003cimg src=\"imgs/preview2.PNG\" alt=\"Preview\" width=\"200\"\u003e\n  \u003cimg src=\"imgs/preview3.PNG\" alt=\"Preview\" width=\"200\"\u003e\n\u003c/p\u003e\n\n---\n\n## 🛠️ Installation\n\nTo install this project, Launch the Terminal app on your system, and run the commands below. \u003cbr\u003e\n  - If a pop-up appears prompting you to download the Xcode Command Line Tools after the first command, click “Download” and then run the first command again.\n\n1. **Clone repo**\n```bash\ngit clone https://github.com/marsdevx/manga2books.git ~/manga2books\n```\n\n2. **Install dependencies**\n```bash\nbrew install python\npip3 install --break-system-packages pillow\npip3 install --break-system-packages ebooklib\npip3 install --break-system-packages natsort\npip3 install --break-system-packages requests\npip3 install --break-system-packages beautifulsoup4\npip3 install --break-system-packages validators\npip3 install --break-system-packages re\n```\n\n3. **Set Up an Alias**\n\n- For Zsh Users\n```bash\necho \"\\nalias manga2books=\\\"python3 /Users/$(whoami)/manga2books/manga2books.py\\\"\" \u003e\u003e ~/.zshrc\nsource ~/.zshrc\n```\n\n- For Bash Users:\n```bash\necho \"\\nalias manga2books=\\\"python3 /Users/$(whoami)/manga2books/manga2books.py\\\"\" \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n---\n\n## 🚀 Usage\n\n1. **Copy the Manga URL**\n\n- Go to website.\n- Find the manga you want to download.\n- Copy the URL of the manga page from your browser's address bar.\n\n\u003cimg src=\"imgs/solo-leveling.jpeg\" width=\"500px\" alt=\"Solo Leveling\"\u003e\n\n\u003cbr\u003e\n\n2. **Download the Manga**\n* Run the following command, replacing the URL with the one you copied:\n\n```bash\nmanga2books https://readmangabat.com/read-iw386363\n```\n\n3. **Download Specific Chapters**\n* To download only specific chapters, add the chapter range after the URL:\n\n```bash\nmanga2books https://readmangabat.com/read-iw386363 30-70\n```\n\n---\n\n## 📋 License\n\nAll the code contained in this repo is licensed under the [MIT License](LICENSE)\n\n```\nMIT License\n\nCopyright (c) 2025 marsdevx\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n---\n\n## ⭐ Support\n\nIf you like this project, don’t forget to ⭐ **star** it and **follow** me!  \nYour **support** helps me create more projects. 🚀  \n\n🔗 **Explore more of my work on [GitHub](https://github.com/marsdevx?tab=repositories) and discover other exciting projects!**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fmanga2books","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarsdevx%2Fmanga2books","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fmanga2books/lists"}