Personal Cloud Library Source is a Playnite GameLibrary plugin for importing a user-supplied personal cloud, NAS, external-drive, or local library catalog into Playnite.
It supports:
LocalFileLocalFolderRcloneRemote
Manifest generation update completed 6/2/2026
- Imports manifest entries into Playnite as a normal library source.
- Preserves stable game IDs from the manifest.
- Represents cached local files as installed and playable.
- Represents missing-local or cloud-only entries safely as uninstalled.
- Supports manual
Download to local cacheactions for eligible items. - Supports safe
Remove cached copyuninstall actions for cache-owned paths. - Generates a v3 manifest from a local folder, external drive, mapped drive, or NAS path from inside Playnite settings.
- Generates a public-safe verification report for manifest, cache, and path-resolution troubleshooting.
This does not provide games, ROMs, BIOS files, cracks, keys, copyrighted content, scraping, storefront access, or download sources.
It does not auto-download an entire cloud library on startup.
It does not delete source files or cloud files.
The current release target is 0.2.0.
This repository now includes the packaged v0.2 guided-setup, manifest-generation, verification-reporting, and settings-theme polish release. See:
For a local folder, external drive, mapped drive, or NAS path:
- Open Playnite.
- Open Add-ons -> Extension settings -> Libraries -> Personal Cloud Library Source.
- Choose
LocalFolder. - Browse to your library root.
- Click Generate manifest from folder.
- Review the summary and save settings.
- Run Update Game Library in Playnite.
For a cloud provider through rclone:
- Configure your remote with
rclone config. - Choose
RcloneRemote. - Fill in the rclone executable path, remote name, manifest path, and optional content root.
- Use Verify setup or Test rclone connection.
- Run Update Game Library in Playnite.
The v0.2 setup flow adds local manifest generation directly inside Playnite settings.
The generated manifest is written to the plugin user data path, not the extension install folder.
Verification reports and diagnostics are also written under the plugin user data path.
Use this for:
- local folders
- external drives
- mapped drives
- NAS paths
- synced local cloud folders
See:
- docs/setup-wizard.md
- docs/automatic-manifest-generation.md
- docs/reports-and-diagnostics.md
- docs/setup-local-folder.md
Advanced users can still generate manifests outside Playnite:
tools/generate-manifest.ps1tools/generate-rclone-manifest.ps1
These tools are useful for scripted workflows or advanced rclone scanning.
See:
sourceType = fileitems download withrclone copytoinRcloneRemotemode.sourceType = directoryitems download withrclone copyinRcloneRemotemode.- Local-folder copies use local filesystem copy helpers.
- The plugin only reports a
Playaction when the expected local cached launch path exists. - Cloud-only or missing-local items remain visible as uninstalled when
TreatMissingFilesAsUninstalledis enabled.
Planned v0.3 notes:
Users are responsible for only indexing files they own or have rights to use.
Cloud providers and rclone remotes are configured by the user.
See:
See:
- docs/setup-wizard.md
- docs/automatic-manifest-generation.md
- docs/setup-local-folder.md
- docs/setup-rclone.md
- docs/manifest-format.md
- docs/reports-and-diagnostics.md
- docs/legal-use.md
- docs/troubleshooting.md
See:
The repo includes:
PersonalCloudLibrarySource/extension.yamlplaynite-addon/addon-database.yamlplaynite-addon/installer.yamltools/package-extension.ps1
AddonId remains:
PersonalCloudLibrarySource_61993828-67a8-4468-93a2-293442e36328