The Library
Your series, films, music, books and photos as a streaming service, on your own address.
The Library turns your folders of video, music, books, comics and photos into a streaming service, like Plex:
posters, metadata, Continue watching, a player that fits each screen and casts to the TV with Chromecast or AirPlay. It lives on its own
address (for example app.yourdomain.com) and only the accounts you let in can enter.
It's in every plan. Pass and Total add the best of it: profiles, Watch together, Requests, Skip intro, offline downloads, GPU and more. See Plans and features.
Getting it going
Its address
A domain for it, usually app. in front of the Files one. The installer prepares it; by hand, see
Your own domain. On your network, without a domain, it's also at http://MACHINE-IP:4891.
The accounts
In People → Settings, turn accounts on. Create or invite them in People → Accounts: with email set up, they get their invitation.
Turn it on
In System → Modules, turn it on, type its address (https://app.yourdomain.com) and save.
Your libraries
In Library → Libraries, create one per kind of content (Films, Series, Anime, Music, Books, Comics, Photos, Courses…), with its name, icon and folders. Each one is shared with every account or only with the groups, Patreon tiers or accounts you pick, and you can close folders to whoever you like.
KumoYami looks up each film and series on TMDB and TheTVDB and brings its page: poster, backdrop, logo, synopsis, cast, seasons and episodes. For anime and series, a free TheTVDB key (in Integrations) gives better results.
The Library's panel
| Page | What's there |
|---|---|
| General | Turning it on, its address and its name. |
| Libraries | Each library, its folders and who it's shared with. |
| Home and look | The home page rows (Continue watching, Recently added, collections) and how they look. |
| Playback | Quality away from home, offline downloads, Skip intro, subtitles, GPU and video protection. |
| Requests | What accounts ask for, and Radarr and Sonarr. See Requests. |
| Community | Watch together, new-content alerts and Your year. |
| Import from Plex | Watched items, progress, lists and posters from your Plex. See Import from Plex. |
Correctly linked metadata
Each title is linked to a TMDB or TheTVDB page. If one came out wrong (another film with the same name, a different year), open its menu and choose See linked page: it says which page it's linked to and how it was found. With Fix you search for the right one, or paste its link or ID, and link it by hand. It sticks even if it's searched again, and its poster, page and episodes update themselves.
Refresh, in each poster's ⋯ menu, reads that title again without opening it.
Quality at home and away
KumoYami tells apart who watches from your network (private addresses, Tailscale and the networks you add) from who watches over the internet, and applies your limits from Playback → Away from home and downloads ("Away from home" tab) to the latter: maximum quality, one of its own for some groups and the total upload they share. The player says "Auto · away from home" and what's limiting it. Each account picks its quality at home, away and "Data saver" in My account.
Converting video with the GPU
What the browser can't play, and the lower qualities, are converted by the server while you watch. With a GPU (Intel,
AMD, NVIDIA or Raspberry Pi 4) it uses far less CPU. The installer detects it (--gpu auto); with Docker Compose, see
the "Convertir vídeos con la GPU" block in docker-compose.yml. Then, in Playback → Hardware acceleration, press
Test.
Watch together
Several accounts watch the same video at once, in sync: if one pauses, it pauses for everyone. With a chat alongside. Start it from the Watch together button on any title and invite with a link.
Modules
In System → Modules you switch the whole Library, and each of its parts, on or off. See Modules.
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.