Skip to content

v1.0.0 — CloudDrive companion plugin for Emby & Jellyfin

Choose a tag to compare

View all tags
@cloud-fs cloud-fs released this 02 Aug 05:38
· 2 commits to main since this release
v1.0.0
03e9840

⚠️ 此版本在 Emby 4.9.0.x 上无法加载（插件不会出现在插件列表中）。请改用 v1.0.1。
This build fails to load on Emby 4.9.0.x — the plugin will not appear in the list. Use v1.0.1 instead.

CloudDrive2 companion plugin for Emby & Jellyfin — first release.
CloudDrive2 媒体服务器伴侣插件 —— 首个正式版本。

中文

把 Emby / Jellyfin 与同一主机上的 CloudDrive2 连接起来。

功能

  • 媒体库实时更新，且可把"实时监控"全部关掉 —— 没有启动时的递归遍历，不占用 inotify watch，也没有开机时的云端列目录风暴。第三方刮削器（tinyMediaManager / MoviePilot / MDCx 等）在挂载目录里刮削、重命名、生成 nfo 和封面后，影片会自动出现在媒体库中。
  • 按播放行为预热 —— 起播预热文件头尾，接近片尾预热同目录下一个文件，停止播放时释放网盘连接。所有客户端一并受益，不限于 CloudDrive2 App。
  • 免配置路径映射 —— CloudDrive2 App 自动推算直连播放的路径映射。此项需要 CloudDrive2 App 1.0.14 或更高版本（尚未发布，即将推出）。

前两项是纯服务端功能，不需要安装 CloudDrive2 App。只要在跑 Emby/Jellyfin + CloudDrive2，装上插件即刻生效。

⚠️ 文件系统变化通知是 CloudDrive2 会员（Pro）功能。 非会员账号收不到变化推送，媒体库不会自动更新。

安装

  • Emby —— 解压后把 CloudDrive.MediaServer.dll 直接放进插件目录（不要建子文件夹，也不需要 meta.json）：

    <emby-programdata>/plugins/CloudDrive.MediaServer.dll

  • Jellyfin —— 把整个压缩包解压到插件目录下的一个子文件夹，保持 meta.json 和 thumb.png 与 DLL 放在一起：

    <jellyfin-config>/plugins/CloudDrive/CloudDrive.MediaServer.dll
<jellyfin-config>/plugins/CloudDrive/meta.json
<jellyfin-config>/plugins/CloudDrive/thumb.png

重启服务器，然后在 控制台 → 插件 → CloudDrive 中填写 CloudDrive2 地址与 API 令牌。详见 README。

在运行中的容器里替换 DLL，请重启容器，只按服务器自身的"重启"按钮不够 —— 直接覆盖同名 DLL 可能让容器仍按旧文件长度读取，导致插件加载失败。

已验证版本

Emby 4.9.5.0 与 Jellyfin 10.11.11（均为 docker 部署）。构建自 03e9840。

English

Connects Emby / Jellyfin to a CloudDrive2 instance on the same host.

Features

  • Live library updates with real-time monitoring switched off — no recursive walk at startup, no inotify watches, no burst of cloud listings when the server boots. Third-party scrapers (tinyMediaManager / MoviePilot / MDCx) that scrape, rename and write .nfo + artwork on the mounted folder now land in the library by themselves.
  • Playback-aware prefetch — warms the file head and tail at start, the next file in the same cloud folder near the end, and releases cloud readers on stop. Benefits every client the server serves, not just the CloudDrive2 App.
  • Zero-config path mapping — the CloudDrive2 App discovers direct-play path mappings automatically. Needs CloudDrive2 App 1.0.14 or later (not yet released — coming soon).

The first two are server-side only and need no CloudDrive2 App. If you run Emby/Jellyfin + CloudDrive2, installing the plugin is the whole install.

⚠️ File-system change notification is a CloudDrive2 Pro (membership) feature. Without it no change pushes arrive and the library will not update by itself.

Install

  • Emby — unzip CloudDrive.MediaServer.dll directly into the plugin directory (no subfolder, no meta.json):

    <emby-programdata>/plugins/CloudDrive.MediaServer.dll

  • Jellyfin — unzip the whole archive into a subfolder of the plugin directory, keeping meta.json and thumb.png beside the DLL:

    <jellyfin-config>/plugins/CloudDrive/CloudDrive.MediaServer.dll
<jellyfin-config>/plugins/CloudDrive/meta.json
<jellyfin-config>/plugins/CloudDrive/thumb.png

Restart the server, then set the CloudDrive2 address and API token under Dashboard → Plugins → CloudDrive. See the README for details.

Replacing the DLL inside a running container? Restart the container, not just the server — overwriting in place can leave the container reading at the old file length, which fails to load.

Verified on

Emby 4.9.5.0 and Jellyfin 10.11.11 (both docker). Built from 03e9840.

Assets 4
Loading