6.1 KiB
Table of Contents
About The Project
Tranga can download Chapters and Metadata from "Scanlation" sites such as
- MangaDex.org
- Manganato.com
- Mangasee
- MangaKatana
- ❓ Open an issue
and trigger an scan with Komga and Kavita.
Notifications will can sent to your devices using Gotify and LunaSea.
What this does and doesn't do
Tranga (this git-repo) will open a port (standard 6531) and listen for requests to add Jobs to Monitor and/or download specific Manga.
The configuration is all done through HTTP-Requests.
The frontend in this repo is CLI-based.
For a web-frontend use tranga-website.
This 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).
It 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)
Tranga 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.
The project doesn't manage metadata, doesn't curate, change or enhance any information that isn't available on the selected Scanlation-Site.
It will blindly use whatever is scrapes (yes this is a glorified Web-scraper).
Inspiration:
Because Kaizoku was relying on mangal and mangal hasn't received bugfixes for it's issues with Titles not showing up, or throwing errors because of illegal characters, there were no alternatives for automatic downloads. However Kaizoku certainly had a great Web-UI.
That is why I wanted to create my own project, in a language I understand, and that I am able to maintain myself.
Built With
- .NET-Core
- Newtonsoft.JSON
- PuppeteerSharp for Mangasee
- Html Agility Pack (HAP)
- 💙 Blåhaj 🦈
Getting Started
There is two release types:
- CLI
- Docker
CLI
Head over to releases and download.
The CLI will guide you through setup. Not in the current version.
Right now it is barebones with options to view logs and make HTTP-Requests
Docker
Download docker-compose.yaml and configure to your needs.
Mount /Manga to wherever you want your chapters (.cbz-Archives) downloaded (for exampled where Komga/Kavita can access them).
Prerequisites
To Build
To Run
.NET-Core 7.0 Runtime scroll down a bit, should be on the right the second item.
Roadmap
- Docker ARM support
- ❓
See the open issues for a full list of proposed features (and known issues).
Contributing
The following is copy & pasted:
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If 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". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
Distributed under the GNU GPLv3 License. See LICENSE.txt for more information.