https://github.com/impishlucy/yamibunko
Self-hosted anime library that processes, organizes, enriches, and plays Anime.
https://github.com/impishlucy/yamibunko
anilist-api anime hevc-encoder library self-hosted server streaming transcoding webapp website
Last synced: 18 days ago
JSON representation
Self-hosted anime library that processes, organizes, enriches, and plays Anime.
- Host: GitHub
- URL: https://github.com/impishlucy/yamibunko
- Owner: impishlucy
- Created: 2026-05-31T04:55:43.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2026-05-31T06:37:36.000Z (24 days ago)
- Last Synced: 2026-05-31T08:11:29.576Z (24 days ago)
- Topics: anilist-api, anime, hevc-encoder, library, self-hosted, server, streaming, transcoding, webapp, website
- Language: TypeScript
- Homepage:
- Size: 127 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Yamibunko
Yamibunko is a local anime library server with a desktop launcher and a web UI. It processes your own media files, organizes them into a library, enriches entries with metadata, and plays them through the browser.
## Features
Yamibunko is built around a local anime library workflow:
* Custom player designed for animes, with the usual controls, skip intro/outro buttons and Google casting.
* Responsive layouts for all pages, on desktop, tablets, and phones.
* Direct-File play and transcoding are possible.
* Data Saver mode for when you're have a data cap.
* Import conversion for smaller, more consistent files, using HEVC conversion and audio cleanup when needed.
* Per-series library grouping, no more searching the library, its all grouped together.
* AniList integration for metadata, tracking, watching progress and watching status.
* Desktop launcher that prepares the runtime, starts the webapp, and keeps setup easier for normal installs.
* Bandwidth-aware streaming, uses a server limit and helps avoid overloading the host connection.
* One active stream per user, with confirmation when switching playback to another episode or device.
* VIP priority streaming so selected users can get better access when the server is under load.
## Install
### Normal Install (with Launcher)
The only required things are an 64bit OS and .NET 10.
0. Install [.NET 10 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/10.0).
1. Open the [Yamibunko releases](https://github.com/impishlucy/Yamibunko/releases) page.
2. Download the latest release ZIP for your OS.
3. Extract the ZIP completely.
4. Start the launcher from the extracted folder.
5. Fill in the setup fields:
* Base URL, usually `http://localhost:3000` or the website url of the app.
* Input folder for new files.
* Output folder for processed files.
* AniList API client ID and secret if you want AniList tracking.
6. Save the setup and wait for the launcher to start the web UI.
The launcher prepares the local runtime, downloads whats needed and starts the webapp.
If the web UI does not open automatically, check the launcher log window.
### AniList Setup
AniList features require an AniList API client. Configure the client redirect URL to match the Yamibunko callback URL:
```text
http://localhost:3000/api/anilist/oauth/callback
https://your-domain.example/api/anilist/oauth/callback
```
Use the same base URL in the launcher or `.env` file. If you host Yamibunko behind a path prefix, the callback path is appended behind that base URL.
### Manual Webapp Install
The webapp can run without the launcher, but you must provide the runtime yourself:
* [Node.js 20 or newer](https://nodejs.org/)
* [Bun](https://bun.sh/)
* [FFmpeg and FFprobe with HEVC support](https://github.com/btbn/ffmpeg-builds/)
* A configured `.env` file
From the `webapp` directory:
```bash
bun install
bun run build
bun run start
```
Supported `TRANSCODE_ACCEL` values in env are `nvenc`, `qsv`, and `cpu`.
## Disclaimer
Yamibunko is intended for organizing, processing, and playing local files that you own or are allowed to use.
Yamibunko does not include, download, or provide access to copyrighted media.
## License
This project is licensed under the [Creative Commons Attribution-NonCommercial 4.0 International License](https://creativecommons.org/licenses/by-nc/4.0/deed.en).
You may share and adapt this project with attribution for non-commercial purposes. Commercial use is not permitted.