Skip to content

Recommended Plugins ​

SakuraMedia's media storage, download and some automation capabilities are provided by plugins. You can browse, install and update plugins directly in "System Settings → Plugins → Plugin Market" (on mobile, enter from the bottom of the "Plugins" page), or upload a zip package manually. See the plugin development guide for the compatibility rules between plugins and the host.

About plugin sources

This release requires every plugin to declare Host API 18; older plugins cannot load. A fresh official image bundles 5 official plugins that are installed and enabled on first start. Upgrading the image also upgrades bundled plugins while preserving their settings, data/, and enabled state. Install other official plugins from the plugin market when needed; plugins bundled by older images are not uninstalled automatically during an upgrade, so remove them from the Plugins page if you no longer need them.

Only plugins whose source repository is public and that provide a Release package are listed here. Licensing terms follow each repository's own statement.

Installing from the plugin market ​

  1. Open "System Settings → Plugins" and switch to the "Plugin Market" tab.
  2. Find the plugin you need and click "Install"; when an installed plugin has a newer version, the button changes to "Update".
  3. After installing, restart the SakuraMedia container so that the API and APS reload the plugins and their dependencies.

The market index comes from the officially maintained sakuramedia-plugin-market repository, which lists both official and community plugins. Community plugins carry a "Community" badge; make sure the source is trustworthy before installing.

Installing a zip manually ​

If you do not use the plugin market, you can also download the package manually:

  1. Download the zip package from the plugin's "Download latest" page.
  2. Go to "System Settings → Plugins", click "Install Plugin" on the "Installed" tab, upload the zip and confirm that the plugin is enabled.
  3. After installing all the plugins you need, restart the SakuraMedia container so that the API and APS reload the plugins and their dependencies.
  4. After installing a provider plugin, first create a media library in "System Settings → Media Library"; when you need downloads, create a download client bound to that media library.
  5. Background tasks from ranking, collection detection, subtitle and actor metadata plugins can be viewed or triggered manually in the Task Center.

Security notice

Plugins run inside the SakuraMedia backend process. Only install plugins from trustworthy sources; community plugins are not audited officially, so read their source before installing.

Plugins listed on this page take effect only after the container is restarted once installed or updated; plugins bundled in the official image are installed and enabled automatically on first start. See the Configuration Reference for plugin directories and settings, and Common Commands for command-line management.

Plugin directory ​

PluginPlugin IDBundledPurposeLinks
Local Storage & qBittorrentsakuramedia_local_providerYesConnects to local media directories and provides manual import, qBittorrent downloads, backend-proxied playback, thumbnails and clips.Source · Download latest
115 Cloud Drive Providersakuramedia_115_providerNoConnects to the 115 cloud drive and provides directory browsing, movie import, 115 offline downloads, 302/backend-proxied playback, thumbnails and clips.Source · Download latest
Guangyapan Cloud Drive Providersakuramedia_guangyapan_providerNoConnects to the Guangyapan cloud drive and provides directory browsing, movie import, 302 direct-link or backend-proxied playback, thumbnails, clips, and adding magnet/torrent downloads to the cloud.Source · Download latest
DMM / FANZA Metadatasakuramedia_dmm_metadataNoProvides Japanese titles, synopses, release dates, runtimes, labels, series, cast, directors, tags, covers, and sample images from DMM / FANZA by movie number.Source · Download latest
FC2 Metadatasakuramedia_fc2_metadataNoProvides titles, synopses, tags, covers, and sample images from FC2 official product pages by product number; the official pages have no cast field.Source · Download latest
FC2CMADB Metadatasakuramedia_fc2cmadb_metadataNoProvides titles, tags, and covers from the FC2CMADB mirror by product number; it has no synopsis or plot images, and actor data is best-effort.Source · Download latest
JavBus Metadatasakuramedia_javbus_metadataYesProvides titles, release dates, runtimes, labels, directors, series, cast, tags, covers, and stills from JavBus by movie number; it has no synopsis. It also supports syncing subscribed-actor movie lists.Source · Download latest
AVMOO Metadatasakuramedia_avmoo_metadataYesProvides titles, release dates, runtimes, labels, directors, series, cast, tags, covers, and stills from AVMOO by movie number; it has no synopsis. It also supports syncing subscribed-actor movie lists.Source · Download latest
JavLibrary Metadatasakuramedia_javlibrary_metadataNoProvides titles, release dates, runtimes, labels, directors, cast, tags, covers, stills, interaction stats, and reviews from JavLibrary by movie number; its pages have no synopsis or series. Install it from the plugin market when needed.Source · Download latest
Actor Metadata Completionsakuramedia_actor_metadataNoCompletes local actor birthday, height, measurements, cup size, and birthplace from JavBus. It does not fill blood type or gender, only writes empty fields, and never overwrites manually maintained values. Install it from the plugin market when needed.Source · Download latest
JavDB Rankingssakuramedia_javdb_rankingYesProvides JavDB trending, top-rated, censored, uncensored and FC2 charts plus bundled TOP250 lists, and registers scheduled sync tasks.Source · Download latest
More Movie Rankingssakuramedia_more_rank_moviesYesConnects to Minnano AV and JavLibrary, providing the Minnano AV daily/weekly/monthly boards and the JavLibrary top-rated and most-wanted boards (last month/all time), and registers scheduled sync tasks.Source · Download latest
JavDB Reviewssakuramedia_javdb_commentNoProvides JavDB movie reviews by movie number with pagination and latest/hottest sorting; requires a JavDB account. Install it from the plugin market when needed.Source · Download latest
Detect collection movies by duration, number pattern or tagsakuramedia_judge_collecttion_movieNoAutomatically flags collection movies based on movie runtime, movie number patterns, and tags, without overriding manual flags made in the app.Source · Download latest
SubtitleCat Chinese Subtitlessakuramedia_subtitlecatNoFetches zh-CN subtitles for existing movies, supporting manual fetching for a single movie and scheduled processing of subscribed movies.Source · Download latest
Movie Text Scraping & Translationsakuramedia_movie_scrape_translateNoScrapes the Japanese title and synopsis of a movie from DMM, and can optionally translate them into Chinese and write them back to the movie title and synopsis. Install it from the plugin market when needed.Source · Download latest

Testing plugins ​

  • In "System Settings → Plugins", click the test-tube icon in the plugin row on desktop, or choose "Capability test" from the plugin action menu on mobile.
  • The capability test uses the test movie number declared by the plugin and only reads the currently loaded configuration; it does not import movies, write stats, or store reviews.
  • After changing plugin settings, save and restart the backend before testing; otherwise the test still uses the previous configuration.
  • "Overview → Component Diagnostics" runs the same test for every enabled metadata source and shows the title, actor count, tag count and image count. "No data" means the plugin responded but did not find the test movie number.

How to choose ​

  • The official image already bundles local storage with qBittorrent, JavBus, AVMOO, JavDB rankings, and more movie rankings. No manual upload is needed on a first deployment. Install 115, Guangyapan, other metadata sources, collection detection, and subtitles from the plugin market when needed. Create a media library to import files, and configure qBittorrent for automatic downloads.
  • The two bundled metadata sources (JavBus and AVMOO) are enabled by default, with JavBus before AVMOO. Adjust their order under "Settings → Metadata Sources"; restart the backend after saving. Different sources cover different movie numbers, and the order only affects which source wins when several match.
  • JavLibrary Metadata is not bundled; install it from the plugin market when needed. It provides metadata, interaction stats, and reviews, and its pages have no synopsis or series.
  • JavDB Rankings is bundled and JavDB Reviews is not; both require container access to JavDB, and reviews also require a JavDB account. After installing the review plugin, restart and bind the review source as instructed. Using a third-party plugin to access JavDB carries a risk of account restriction or ban; a dedicated secondary account is recommended.
  • Movie text scraping & translation is not bundled; install it from the plugin market when needed. Install DMM / FANZA Metadata first if you need Japanese titles and synopses; the translation plugin is only needed when you want Chinese translations written back to the movie.
  • Actor metadata completion is not bundled; install it from the plugin market when needed.
  • Movie text scraping & translation requires the container to reach DMM; configure a container proxy if your current network cannot reach it. When translation is enabled, you also need an LLM API compatible with chat_completions.
  • See the FAQ for the external domains metadata plugins use and how to configure a container proxy.
  • SubtitleCat currently only fetches Chinese subtitles, and the movie must already exist in SakuraMedia.

Companion services are not plugins ​

The SigLIP2 embedding service and the SakuraMedia Torznab Server are companion services deployed separately. They cannot be installed from "System Settings → Plugins", so they are not listed on this page.

Released under the GNU GPL v3 License.