{"id":15127643,"url":"https://github.com/mangatsu/server","last_synced_at":"2025-06-10T08:33:53.602Z","repository":{"id":42383328,"uuid":"452685022","full_name":"Mangatsu/server","owner":"Mangatsu","description":"🌕 Media server for storing, tagging and viewing doujinshi, manga, art collections and other galleries with API and user control. Written in Go.","archived":false,"fork":false,"pushed_at":"2025-05-08T16:06:16.000Z","size":12468,"stargazers_count":56,"open_issues_count":15,"forks_count":6,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-08T17:24:05.687Z","etag":null,"topics":["api","comic","comic-reader","docker","doujinshi","go","manga","manga-api","manga-server","manga-storage","mediaserver","metadata","nas","sadpanda","self-hosted","storage"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Mangatsu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","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},"funding":{"github":["CrescentKohana"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-01-27T13:03:10.000Z","updated_at":"2025-05-08T16:06:17.000Z","dependencies_parsed_at":"2024-01-07T07:21:02.760Z","dependency_job_id":"4aa090cc-00e0-4e8c-afa3-5642ceed734c","html_url":"https://github.com/Mangatsu/server","commit_stats":{"total_commits":242,"total_committers":1,"mean_commits":242.0,"dds":0.0,"last_synced_commit":"ab4ac2735b7241e5c56b2f018acbf2df62b159e2"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mangatsu%2Fserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mangatsu%2Fserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mangatsu%2Fserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mangatsu%2Fserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mangatsu","download_url":"https://codeload.github.com/Mangatsu/server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mangatsu%2Fserver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259038287,"owners_count":22796592,"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","comic","comic-reader","docker","doujinshi","go","manga","manga-api","manga-server","manga-storage","mediaserver","metadata","nas","sadpanda","self-hosted","storage"],"created_at":"2024-09-26T02:05:11.084Z","updated_at":"2025-06-10T08:33:53.576Z","avatar_url":"https://github.com/Mangatsu.png","language":"Go","readme":"\n\u003ch1 align=\"center\"\u003e Mangatsu\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/logo-small.png\" /\u003e\n\u003c/p\u003e\n\n\u003e 🌕 Server application for **storing**, **tagging** and **reading** doujinshi, manga, art collections and other galleries with API access and user control. Written in Go.\n\u003e The name, **Mangatsu**, is a play on Japanese words **mangetsu** (満月, full moon) and **manga** (漫画, comic).\n\n### **[📰 CHANGELOG](docs/CHANGELOG.md)** | **[❤ CONTRIBUTING](docs/CONTRIBUTING.md)**\n\n### At experimental stage until version 1.0.0. Expect breaking changes.\n\n## 📌 Features\n- Organizing and tagging local (and remote, with tools like [rclone](https://rclone.org)) collections of manga, doujinshi and other art\n  - **Mangatsu will never do any writes inside specified locations.**\n  - Supports **ZIP** (or CBZ), **RAR** (or CBR), **7z** and plain image (png, jpg, jpeg, webp, avif, heif, gif, tiff, bmp) files.\n    - PDF and video support is planned.\n- Metadata parsing from filenames and JSON files (inside or beside the archive)\n  - Support for more sources is planned such as TXT files from EH/ExH\n- API-access to the collection and archives\n  - Extensive filtering, sorting and searching capabilities\n  - Additional features for registered users such as tracking reading progress and adding favorite groups. Currently only in API, not in UI.\n- User access control\n  - **Private**: only logged-in users can access the collection and archives (public registration disabled by default).\n  - **Restricted**: users need a global passphrase to access collection and its galleries\n  - **Public**: anyone can access (only read) collection and its galleries\n  - Assignable roles (admin, member, viewer), and login sessions (can be managed through web)\n- Local cache and thumbnail support. _File server can be disabled to allow web servers like NGINX to handle the files._\n\n## 🖼️ Preview\n\n| Main Catalogue                                                                  | Main Catalogue (grouped galleries)                                                                      |\n|---------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| [![catalogue](docs/images/thumbnails/catalogue.png)](docs/images/catalogue.png) | [![grouped catalogue](docs/images/thumbnails/catalogue_grouped.png)](docs/images/catalogue_grouped.png) |\n\n| Gallery Page + Editing                                                                            | Series Listing                                                                                 |\n|---------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| [![editing gallery](docs/images/thumbnails/editing_gallery.png)](docs/images/editing_gallery.png) | [![series listing](docs/images/thumbnails/series_listing.png)](docs/images/series_listing.png) |\n\n\n| User Settings                                                                | Administration                                                               |\n|------------------------------------------------------------------------------|------------------------------------------------------------------------------|\n| [![settings](docs/images/thumbnails/settings.png)](docs/images/settings.png) | [![administration](docs/images/thumbnails/admin.png)](docs/images/admin.png) |\n\n## 📌 Clients\n\n### 🌏 Web client\n- Included in the Docker setup below\n- Source: [Mangatsu Web](http://github.com/Mangatsu/web)\n\n### 📱 [Tachiyomi](https://tachiyomi.org) extension for Android\n- Coming soon\n\n## 📌 Installation and usage\n\n### 📖 Guides\n\n- **[📝 Configuration with environmentals](docs/ENVIRONMENTALS.md)**\n- **[📚 Library directory structure](docs/LIBRARY.md)**\n\n### 🐳 Docker setup (recommended)\n\n#### GitHub Container Registry: [server](https://github.com/Mangatsu/server/pkgs/container/server) \u0026 [web](https://github.com/Mangatsu/server/pkgs/container/server)\n\n#### DockerHub: [server](https://hub.docker.com/r/luukuton/mangatsu-server/) \u0026 [web](https://hub.docker.com/r/luukuton/mangatsu-web) images\n\n- Set up a webserver of your choice. NGINX is recommended.\n  - [Example config](docs/nginx.conf). The same config can be used for both the server and the web client. Just change the domains, SSL cert paths and ports.\n- Install [Docker](https://docs.docker.com/engine/install/) (Linux, Windows or MacOS)\n- Local archives\n  - Download the [docker-compose.example.yml](docs/docker-compose.example.yml) and rename it to docker-compose.yml\n  - Edit the docker-compose.yml file to your needs\n  - Create data and archive directories\n- Network archives with [Rclone](https://rclone.org)\n  - Follow the [guide on Rclone site](https://rclone.org/docker/)\n  - Download the [docker-compose.rclone.yml](docs/docker-compose.rclone.yml) and rename it to docker-compose.yml\n- Run `docker-compose up -d` to start the server and web client\n- Update by running `docker-compose down`, `docker-compose pull` and then `docker-compose up -d`\n\n### 💻 Local setup\n\n- Set up server\n  - Copy example.env as .env and change the values according to your needs\n  - Build `go build ./cmd/mangatsu-server`\n  - Run `./mangatsu-server` (`mangatsu-server.exe` on Windows)\n- Set up web\n  - [Guide on github.com/Mangatsu/web](https://github.com/Mangatsu/web)\n","funding_links":["https://github.com/sponsors/CrescentKohana"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmangatsu%2Fserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmangatsu%2Fserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmangatsu%2Fserver/lists"}