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.

1. Open the 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:

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
• Bun
• FFmpeg and FFprobe with HEVC support
• A configured .env file

From the webapp directory:

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.

You may share and adapt this project with attribution for non-commercial purposes. Commercial use is not permitted.