explaingit

javscraper/emby.plugins.javscraper

3,766C#Audience · generalComplexity · 2/5Setup · moderate

TLDR

A plugin for Emby and Jellyfin media servers that automatically fetches titles, cast info, cover art, and other details for Japanese adult films by matching product codes in your file names against several catalog sites.

Mindmap

mindmap
  root((JavScraper))
    What it does
      Metadata scraping
      Cover art download
      Cast info lookup
    Sources
      JavBus JavDB
      FC2 MGStage
      R18 Jav321
    Setup
      DLL install
      CF Worker proxy
    Features
      Manual match
      Source priority
      Actress avatars
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automatically organize a personal Japanese adult film library in Emby or Jellyfin with correct titles, artwork, and cast details

USE CASE 2

Set up a Cloudflare Worker proxy to reach catalog sites that are blocked in your region

USE CASE 3

Manually identify files that were not matched automatically by entering the product code directly in the plugin

Tech stack

C#.NETCloudflare Workers

Getting it running

Difficulty · moderate Time to first run · 30min

Some catalog sites may be blocked in your region, requiring you to deploy the provided Cloudflare Worker proxy before metadata lookups work.

In plain English

This is a plugin for Emby and Jellyfin, which are self-hosted media server applications people use to organize their personal video, music, and photo collections. The plugin automatically looks up and downloads metadata for Japanese adult films stored in your local library. It reads product codes embedded in file or folder names, contacts several external catalog websites, and pulls back titles, descriptions, cast information, cover artwork, and other details. The README is written in Chinese. It explains that a custom proxy layer, deployed as a free CloudFlare Worker, handles the web requests between the plugin and the source sites. This proxy is needed because some of those sites may be blocked depending on the user's region. Users outside restricted regions, or anyone on a global VPN, can disable the proxy option entirely. The plugin also supports standard HTTP, HTTPS, and SOCKS5 proxies as alternatives. Supported metadata sources include JavBus, JavDB, MGStage, FC2, AVSOX, Jav321, and R18. Each is a catalog site that indexes product codes along with studio, cast, and release information. Users can configure the priority order of these sources within the plugin settings. Installation works by downloading a compiled .dll file from the project's releases page, copying it into Emby's or Jellyfin's plugins folder, and restarting the server. After that, the plugin appears in the server configuration where you point it to a proxy if needed. You then edit the target media library to use JavScraper as its metadata and image provider. If automatic matching by file name fails, there is a manual identification option where you type the product code directly. Actress avatar photos are collected as a separate scheduled task, pulling from an open-source actress photo repository. Label translation from Japanese to Chinese and title translation are both listed as completed features. A file organization feature is listed as not yet done.

Copy-paste prompts

Prompt 1
Walk me through installing JavScraper in Jellyfin on Linux: where to copy the .dll file, how to restart the server, and how to assign it to a library.
Prompt 2
How do I deploy the included Cloudflare Worker proxy for JavScraper and enter its URL in the plugin settings?
Prompt 3
JavScraper is not matching some of my files, how do I use the manual identification feature to enter a product code and trigger a metadata lookup?
Prompt 4
How do I set the source priority order in JavScraper so JavBus is checked before JavDB for every lookup?
Open on GitHub → Explain another repo

← javscraper on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.