{"id":18621204,"url":"https://github.com/c9glax/tranga","last_synced_at":"2025-04-04T22:03:35.144Z","repository":{"id":171662372,"uuid":"648235359","full_name":"C9Glax/tranga","owner":"C9Glax","description":"Docker-Container to monitor (Manga) Scanlation-Sites for download new chapters.","archived":false,"fork":false,"pushed_at":"2024-10-29T18:15:35.000Z","size":17427,"stargazers_count":143,"open_issues_count":22,"forks_count":13,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-29T20:22:59.339Z","etag":null,"topics":["api","docker","docker-compose","docker-container","download-manager","gotify","kavita","komga","lunasea","manga","manga-api","manga-downloader","mangadex","mangadex-api","manhua","ntfy"],"latest_commit_sha":null,"homepage":"","language":"C#","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/C9Glax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2023-06-01T13:59:01.000Z","updated_at":"2024-10-29T12:21:19.000Z","dependencies_parsed_at":"2024-02-11T00:26:57.484Z","dependency_job_id":"971e4713-a199-496a-8fc8-f7407fc3a729","html_url":"https://github.com/C9Glax/tranga","commit_stats":null,"previous_names":["c9glax/tranga"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/C9Glax%2Ftranga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/C9Glax%2Ftranga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/C9Glax%2Ftranga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/C9Glax%2Ftranga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/C9Glax","download_url":"https://codeload.github.com/C9Glax/tranga/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247256104,"owners_count":20909240,"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":["api","docker","docker-compose","docker-container","download-manager","gotify","kavita","komga","lunasea","manga","manga-api","manga-downloader","mangadex","mangadex-api","manhua","ntfy"],"created_at":"2024-11-07T04:09:41.656Z","updated_at":"2025-04-04T22:03:35.137Z","avatar_url":"https://github.com/C9Glax.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Testers for V2 wanted!\n\n[Details](https://github.com/C9Glax/tranga/pull/355#issuecomment-2764217944)\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\n\u003ch3 align=\"center\"\u003eTranga\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Automatic Manga and Metadata downloader \n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    This is the API for \u003ca href=\"https://github.com/C9Glax/tranga-website\"\u003eTranga-Website\u003c/a\u003e  \n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nTranga can download Chapters and Metadata from \"Scanlation\" sites such as \n\n- [MangaDex.org](https://mangadex.org/) (Multilingual)\n- [Manganato.com](https://manganato.com/) (en)\n- [MangaKatana.com](https://mangakatana.com) (en)\n- [Mangaworld.bz](https://www.mangaworld.bz/) (it)\n- [Bato.to](https://bato.to/v3x) (en)\n- [ManhuaPlus](https://manhuaplus.org/) (en)\n- [MangaHere](https://www.mangahere.cc/) (en) (Their covers aren't scrapeable.)\n- [Weebcentral](https://weebcentral.com) (en)\n- [Webtoons](https://www.webtoons.com/en/)\n- ❓ Open an [issue](https://github.com/C9Glax/tranga/issues/new?assignees=\u0026labels=New+Connector\u0026projects=\u0026template=new_connector.yml\u0026title=%5BNew+Connector%5D%3A+)\n\nand trigger a library-scan with [Komga](https://komga.org/) and [Kavita](https://www.kavitareader.com/).  \nNotifications can be sent to your devices using [Gotify](https://gotify.net/), [LunaSea](https://www.lunasea.app/) or [Ntfy](https://ntfy.sh/\n).\n\n### What this does and doesn't do\n\nTranga (this git-repo) will open a port (standard 6531) and listen for requests to add Jobs to Monitor and/or download specific Manga.\nThe configuration is all done through HTTP-Requests.\n_**For a web-frontend use [tranga-website](https://github.com/C9Glax/tranga-website).**_\n\nThis project downloads the images for a Manga from the specified Scanlation-Website and packages them with some metadata - from that same website - in a .cbz-archive (per chapter).  \nIt does this on an interval, and checks for any Chapters (.cbz-Archive) not already existing in your specified Download-Location. (If you rename or move files, it will download those again)  \nTranga can (if configured) trigger a scan in Komga or Kavita, however the directory in which the Manga reside has to be available to both Tranga and Komga/Kavita.\n\nThe project doesn't manage metadata, and doesn't curate, change or enhance any information that isn't available on the selected Scanlation-Site.  \nIt will blindly use whatever is scrapes (yes this is a glorified Web-scraper).\n\n\n### Inspiration:\n\nBecause [Kaizoku](https://github.com/oae/kaizoku) was relying on [mangal](https://github.com/metafates/mangal) and mangal\nhasn't received bugfixes for its issues with Titles not showing up, or throwing errors because of illegal characters,\nthere were no alternatives for automatic downloads. However, [Kaizoku](https://github.com/oae/kaizoku) certainly had a great Web-UI.\n\nThat is why I wanted to create my own project, in a language I understand, and that I am able to maintain myself.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Built With\n\n- .NET-Core\n- Newtonsoft.JSON\n- [PuppeteerSharp](https://www.puppeteersharp.com/)\n- [Html Agility Pack (HAP)](https://html-agility-pack.net/)\n- [Soenneker.Utils.String.NeedlemanWunsch](https://github.com/soenneker/soenneker.utils.string.needlemanwunsch)\n- 💙 Blåhaj 🦈\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#c9glax/tranga\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=c9glax/tranga\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=c9glax/tranga\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=c9glax/tranga\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\n### Docker\n\nDownload [docker-compose.yaml](https://git.bernloehr.eu/glax/Tranga/src/branch/master/docker-compose.yaml) and configure to your needs.  \nMount `/Manga` to wherever you want your chapters (`.cbz`-Archives) downloaded (where Komga/Kavita can access them).  \nThe `docker-compose` also includes [tranga-website](https://github.com/C9Glax/tranga-website) as frontend. For its configuration refer to the repo README.\n\nFor compatibility do not execute the compose as root (which you should not do anyways...) but as user that can\naccess the folder.\n\n### Prerequisites\n\n#### To Build\n[.NET-Core 8.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)\n#### To Run\n[.NET-Core 8.0 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) scroll down a bit, should be on the right the second item.\n\nSee the [open issues](https://github.com/C9Glax/tranga/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nThe following is copy \u0026 pasted:\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the GNU GPLv3  License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n## Acknowledgments\n\n* [Choose an Open Source License](https://choosealicense.com)\n* [Font Awesome](https://fontawesome.com)\n* [Best-README-Template](https://github.com/othneildrew/Best-README-Template/tree/master)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fc9glax%2Ftranga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fc9glax%2Ftranga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fc9glax%2Ftranga/lists"}