Switch from Plex
Bring your Plex cinema to KumoYami without starting from scratch, watched state and My list included, on your server and with a lifetime license.
KumoYami is your home cinema on your own server, like Plex. If you come from Plex you don't start from scratch: what you and your people have watched, where you left off and your watchlist come with you. Import from Plex is in every plan, the Free plan included.
This guide is the whole journey. The details of the tool (Kometa overlays, the log, undo) are in Import from Plex.
What comes over and what doesn't
Imported, for each Plex user:
- Watched state: the watched marks of films and episodes.
- Where you left off: the position of each half-watched video, which shows up in "Continue watching".
- Your Plex watchlist (films and series), which moves to "My list".
And, if you ask for it when importing from the panel, the posters and backdrops you set in your Plex libraries: films, series, seasons (poster only) and collections (poster only, onto a KumoYami collection with the same name). They stay as if you had picked them by hand, without Kometa's overlays.
Not imported:
- Your videos. KumoYami copies nothing from Plex: it reads the same folders. That's why your libraries are made in KumoYami, pointing at the folders Plex already uses (below).
- Plex music and photo libraries: only film and series libraries are read.
- Metadata (titles, summaries): KumoYami uses its own, from TMDB and TheTVDB.
- Ratings, playlists, collections (only their posters) or the settings of your Plex server.
- Accounts. None are created: you map each Plex user to an account that already exists in KumoYami.
Plex isn't touched: it's only read. You can keep using it while you try KumoYami.
1. Install KumoYami and link your server
Install it
Follow the quick install on the same machine as Plex or another one. The image is public: it downloads without logging in.
Link it to your account
The last step of the wizard (and the License page of the panel) shows you an eight-letter code, like BCDF-GHJK.
Open kumoyami.com/activate, sign in with your email (we send you a link; if you have no account yet,
one is made on the Free plan), type the code and confirm the server. The code lasts 15 minutes: if it runs out, ask for
another.
Offline, you can also paste the KY1.… key under License. See Your license.
Make your libraries
Mount the film and series folders Plex uses and make your libraries with them in the Library. Wait until they finish scanning: only what KumoYami finds is imported.
KumoYami looks for each Plex title by its TMDB, IMDb and TheTVDB ids (also those you put in the folder name, like
Dune (2021) {tmdb-438631}) and, failing that, by the file's name and size. What it doesn't find shows up in the dry run
as "Not found" and isn't imported.
2. Import from the panel (the owner)
In the panel, Library → Import from Plex:
Connect to Plex
Press Connect with Plex and sign in with your account in Plex's window. Pick your server from the list. KumoYami tries its addresses on your network first and Plex's relay last: the KumoYami server has to be able to reach it.
You can also connect with an address and a token (X-Plex-Token), but then only the token's user is imported. The
token is forgotten when it's done, unless you tick Remember connection.
Who is who
Each user of your Plex Home is mapped to a KumoYami account, or to a profile if you use them. KumoYami suggests the account by email or name; pick Don't import to skip someone. Managed or PIN-protected users need their four-digit PIN.
To bring the posters too, tick Also read the posters and backdrops.
Do a dry run
Simulate import reads Plex and compares, without changing anything: how many watched, how many half-watched, how many to "My list", how many found and which are missing.
Import
Choose what happens if an account already has something of a title: Keep the most recent (the usual) or Overwrite with Plex. Choose what to import (watched marks, "Continue watching", "My list") and press Import.
Each import stays in the Log, with a button to undo it.
3. Each user, their own
If you want each person to bring their own Plex, without going through you, turn on Each account can import its Plex in the settings of Library → Import from Plex. It also works for the friends you shared your Plex with, who aren't in your Plex Home.
Then each user, in My account → Import from Plex:
- Presses Connect with Plex and signs in with their Plex account.
- Picks their Plex server and presses See what would be imported.
- If they already have something of a title in KumoYami, chooses Keep the most recent or Overwrite with Plex.
- Presses Import.
It brings what they watched, where they left off and their watchlist, into their own account only (posters are the owner's call). They can undo their last import from the same card.
If you had Plex Pass: the lifetime license
If you paid for a lifetime Plex Pass, KumoYami has that way to pay too: a single payment and the license is yours.
- It never drops to Free. It doesn't expire or depend on a subscription, and it includes updates for as long as we keep developing KumoYami. If development ends, the last version keeps working with it.
- If the license server shuts down for good, we will release a final version of KumoYami that needs no activation.
- Try it first. The Free plan already has the Library and Import from Plex. No refunds are given once the license is delivered, so try it with your Plex before paying.
Pass completes the Library (profiles, Watch together, requests, skip intro, GPU) and Total brings the Library and Files together. See the lifetime prices and Plans and features.
All trademarks and logos belong to their respective owners. Their use only indicates compatibility, not sponsorship or affiliation. The Synology logo is a trademark of Synology Inc.; Google Drive, Google Cast and Android are trademarks of Google LLC, and the Android robot is reproduced from work created and shared by Google, used under the Creative Commons Attribution 3.0 license. Microsoft, Windows and OneDrive are trademarks of the Microsoft group of companies; Amazon S3 is a trademark of Amazon.com, Inc. or its affiliates; Apple, AirPlay, macOS and iPhone are trademarks of Apple Inc.; Raspberry Pi is a trademark of Raspberry Pi Ltd; Ubuntu is a trademark of Canonical Ltd.; Debian is a trademark of Software in the Public Interest, Inc.; Linux is a trademark of Linus Torvalds. This product uses the TMDB API but is not endorsed or certified by TMDB.