Server Setup Guide

Configure Movies/TV/Kids destinations, optional 4K splits, and TV multi-drive priority.

Basic Setup

Server Drives configuration example — Example drives/folders mapped for Klypp Server

Recommended flow: MobileSaveLocation → Incomplete → Finished

MobileSaveLocation — where the mobile app uploads land (e.g., /Users/you/Downloads)
Incomplete — where your Torrent client/DVD ripper app writes while it's in progress (e.g., /Users/Qbit/Incomplete)
Finished — completed files; Klypp watches here and classifies each item (e.g., /Users/Qbit/Finished)

Destination folders: one folder per media type.

Movies (4K OFF) → //Nas1/Movies
Television (4K OFF) → //Nas1/TV
Music → //Nas1/Music

After you map these folders, Klypp Server will monitor Finished and move files into your library automatically.

On Linux or macOS, you may need to adjust permissions. The service runs under the klypp user to keep access isolated from your personal account.

Server log output while scanning — Live logs confirm path access is correct

If you already have TV shows, you can scan existing folders to populate the mobile app — or start fresh with a new folder just for Klypp.

Example TV folder mapping — Example TV folder structure for scanning

After a scan or a new upload, the mobile app will show your media.

Missing TV Episodes screen — Missing TV Episodes

Recently Added Media screen — Recently Added

How it Works (Simple, UI-Based)

The app routes each title based on two things:

Type you can configure: Movies, KidsMovies, Television, KidsTelevision
Whether that destination’s 4K checkbox is ON (4K path) or OFF (non-4K path)

There are no special names like “Kids4kMovies.” You simply enable a destination and choose if it’s for 4K or not. You can enable both a non-4K and a 4K path for the same type.

Common Movie Setups

1) One folder (catch-all)

Configure: Movies (4K OFF) → C:\Movies\
Result: non-4K, 4K, and kids movies all land under C:\Movies\.

2) 4K / non-4K split

Configure: Movies (4K OFF) → C:\Movies\
Configure: Movies (4K ON) → C:\4kMovies\
Result: 4K → C:\4kMovies\; everything else (incl. kids) → C:\Movies\.

3) Separate kids (optional)

Add KidsMovies (4K OFF) → kids go there; non-kids follow the Movie flow above.
(Optional) Add KidsMovies (4K ON) if you also want kids-4K split.

TV Setups (Practical Examples)

1) One folder (catch-all)

Configure: Television (4K OFF) → C:\TV\
Result: kids + non-kids + 4K all land under C:\TV\.

2) 4K / non-4K split

Configure: Television (4K OFF) → C:\TV\
Configure: Television (4K ON) → C:\UHDTV\
Result: 4K → C:\UHDTV\; everything else (incl. kids) → C:\TV\.

3) Separate kids (non-4K)

Configure: KidsTelevision (4K OFF) → C:\KidsTV\
Configure: Television (4K OFF) → C:\TV\
(Optional) Television (4K ON) → C:\UHDTV\
Result: kids (non-4K) → C:\KidsTV\; non-kids follow the TV/UHD flow.

4) Separate kids + 4K split

Configure: KidsTelevision (4K OFF) → C:\KidsTV\
Configure: KidsTelevision (4K ON) → C:\KidsUHDTV\
Configure: Television (4K OFF) → C:\TV\
Configure: Television (4K ON) → C:\UHDTV\
Result:
- Kids 4K → C:\KidsUHDTV\
- Kids non-4K → C:\KidsTV\
- Non-kids 4K → C:\UHDTV\
- Non-kids non-4K → C:\TV\

5) Kids-only (no catch-all)

Configure: KidsTelevision (4K OFF) → C:\KidsTV\
Result: kids route; non-kids are skipped with a message.

6) 4K-only (no non-4K)

Configure: Television (4K ON) → C:\UHDTV\
Result: 4K routes; non-4K are skipped with a message.

TV: Multiple Drives & Priority (Exact Behavior)

Each TV destination can have several paths, each with a Priority number. The app checks them in order: 1 → 2 → 3 → … → N.

Colocate if found: As it scans from 1 upward, if it finds the show folder on any drive, it uses that same drive for the new season/episode (keeps the show intact).
New shows land on the last drive: If the scan reaches the end (N) without finding the show, the app creates the show on drive N (the last/lowest-priority drive).
Why this matters: You can add new drives (higher numbers) while older lower-number drives fill up. Existing shows keep writing where they already live, and new shows naturally start on the newest “last” drive.
If you remove a drive from the copy list: The app will write to whatever remains in the 1→N sequence. Doing this mid-series can split a show across drives, so prefer leaving older drives mounted and adding new ones with higher numbers. If you plan to retire a drive, wait until all shows on it have finished airing (or relocate them intentionally) before removing it.

In short: Scan priorities 1..N → if show exists at k, write to k; if not found anywhere, create on N.