Yamibunko

Yamibunko is local anime library and file processor, with a launcher and a web UI.
It can optimize your files, organizes them and can play them back through the WebUI.

Important

The latest build's webapp has multiple CVE's, the affected releases have been removed.

If ur using an pre 6.1.x version and have it exposed to the Internet, please follow the steps below to update.

1. Stop the running instance.
2. Download the latest release ZIP of the webapp in the Releases page.
3. Replace the contents of the webapp folder in your instance.
4. Delete the .next folder inside your instance folder.
5. Start the instance.

Features

General

• Custom player, with custom subtitles, skip buttons and casting.
  (Casting is not available via iOS.)
• Responsive layouts for all pages, on desktop, tablets, and phones.
• Direct-File play and transcoding for older devices are possible.
• Per-series grouping, no more specific searching, its grouped together per series.
• AniList for metadata, tracking, watching progress and watching status.
• Desktop launcher that prepares, starts, and keeps it easier to use.
• Bandwidth-aware streaming, uses a limit to avoid overloading the connection.
• One stream per user, with confirmation when switching to another device.
• VIP priority streaming so selected users can get better access.
• Now comes with a Android TV App, to avoid the need for casting.

File Processing

• If enabled it can convert input files for smaller files, using HEVC.
• If disabled it only servers your existing files and does not edit them.
• Support for non Anime, just put them in /NotAnime in the Input Folder.
  (e.g. /Input/NotAnime/Series/files..)

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 ur Devices lan IP (e.g. http://192.168.178.10:3000),
     or your Websites URL (https only) (If ur using a reverse proxy for 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 runtime, downloads whats needed and starts the webapp.
The app runs in the backround and has right clickable tray icon.

Update (with Launcher)

1. Stop any Yamibunko instance running and wait for shutdown.
2. Open the Folder of your Yamibunko Install.
3. Execute the Updater script and wait for it to complete.
4. Start the Launcher and ur done.

---

AniList Setup

AniList user features require an AniList API client.
Configure the client redirect URL to match the Yamibunko callback URL:

Examples:
http://192.168.178.10:3000/api/anilist/oauth/callback
https://your-domain.example/api/anilist/oauth/callback

Use the same base URL in the launcher or in the manual startup arguments.
If you host Yamibunko behind a path prefix (.e.g https://your.url/anime/), the callback path is appended behind that path.

---

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 AV1/HEVC support

Steps

Run following commands from the cloned webapp directory:

1. Setup commands

bun install
bun run build

2. Run the WebApp (Configure the parameters)

bun run start -- \
  --BASE_URL=http://localhost:3000 \
  --ANIME_INPUT_DIR=/path/to/input \
  --ANIME_MEDIA_DIR=/path/to/output \
  --IMPORT_ENABLED=true \
  --FFMPEG_DIR=/path/to/ffmpeg/bin \
  --TRANSCODE_ACCEL=nvenc \
  --ANILIST_CLIENT_ID=optional-client-id \
  --ANILIST_CLIENT_SECRET=optional-client-secret

Minimal argument notes:

• BASE_URL: the URL users open in their browser, also used for the AniList callback.
• ANIME_INPUT_DIR: folder watched for new files.
• ANIME_MEDIA_DIR: output library folder, required when IMPORT_ENABLED=true.
• IMPORT_ENABLED: true processes/moves files, false does not.
• FFMPEG_DIR: folder containing ffmpeg and ffprobe.
• TRANSCODE_ACCEL: nvenc, intel_gpu, intel_cpu, amd_gpu, amd_cpu,cpu.
  Use cpu only when IMPORT_ENABLED=false and your hardware does not support av1 or hevc.
• ANILIST_CLIENT_ID and ANILIST_CLIENT_SECRET: Needed for AniList tracking.

Manual Webapp Update

0. Download the new version zip and unpack it.
1. Stop the currently running Instance.
2. Paste the webapp contents over the one in your instance folder.
3. Delete the .next folder inside your instance folder.
4. Run bun run build before starting it.
5. Start it.

Notice

This project does not distribute, include, or endorse any copyrighted or pirated content. The software is provided for legitimate and lawful use.

Users are solely responsible for ensuring that any copyrighted material they use with this software is obtained legally and in accordance with applicable law. The developers disclaim all responsibility for any misuse of the software or for any legal consequences resulting from the use of illegally obtained content.

Any third-party distribution of this app bundled with copyrighted content is done without permission and is not associated with orendorsed by this project.

License

This project is licensed under the CCA-NC 4.0 License.
You may share and adapt this project with attribution for non-commercial purposes.
Commercial use is not permitted in any way or form.

External Resources

This project uses ffmpeg under the hood, specifically this version.
The Android TV app was made using this project as a base.