Guides

How to use Episaw

Short, practical walkthroughs for the things people ask about most.

Connect your server → Sync your history → Push history to Emby → Back up & restore → Set up the calendar → Use custom lists →
Free

Connect your server

Episaw works with your own Emby or Jellyfin server. You'll need its address and your login.

  1. Open Episaw and go to Settings.

  2. Under Server, enter your server address — for example http://192.168.1.10:8096 or your remote URL.

  3. Enter your username and password for that server.

  4. Tap Save. Episaw connects and shows a green Connected status.

Episaw stores your server details only on your device, and uses them only to talk to your server.
Free

Sync your history

Syncing pulls your watched episodes and shows from the server into Episaw.

  1. On the Home screen, tap Sync.

  2. Wait for it to finish — you'll see progress as it fetches your history.

  3. Your recently watched shows and missing-episode counts appear automatically.

With Pro, turn on Auto-sync in Settings so this happens quietly each time you open the app — every launch, once a day, or once a week.
Pro

Push history back to Emby

Rebuilt your server or lost its database? Send your locally-tracked watch history back so Emby knows what you've seen.

  1. Go to Settings → Backup & Restore.

  2. Tap Preview (no changes) first to see exactly what would be marked as watched. Nothing is changed yet.

  3. When you're happy, tap Push to Emby. Episaw marks those episodes watched on the server.

Always run the preview first — it's a safe, read-only look at what will change.
Pro

Back up & restore your data

Keep a copy of your Episaw data, or move it to another device.

  1. Go to Settings → Export / Import.

  2. Tap Export to save a file with your history, lists, and settings. Store it wherever you like — your own cloud, your computer, anywhere.

  3. On another device (or after reinstalling), tap Import and pick that file to restore everything.

Because your data is yours as a file, no company shutdown can ever take it from you.
Pro

Set up the upcoming calendar

The calendar shows episodes airing soon for the shows you follow. It uses a free TMDB key.

  1. Create a free account at themoviedb.org, then go to Settings → API there and copy your key.

  2. In Episaw, go to Settings → TMDB, paste the key, and save.

  3. Open the Calendar tab. Choose 14, 30, or 60 days ahead. Tap any episode for its synopsis.

Add a free TheTVDB key too (Settings → TVDB) for the most accurate show status — Continuing, Ended, or Cancelled — the same data Sonarr uses.
Pro

Use custom lists

Organise shows into colour-coded lists that match how you actually watch.

  1. Open the My Lists tab. You start with Favourites, Rewatch with Kids, Rewatch Solo, Recommend to Others, and To Watch Later.

  2. Tap + New List to make your own, with its own colour.

  3. From any show, tap the + to add it to a list.