How to use My Shows V2

Your list is kept in your own GitHub Gist, so it's the same on your iPhone, iPad and Mac.

V2 is a separate app from My Shows V1 (myshows.fyi), and V1 keeps working as before. To bring your V1 list across, download a backup in V1, then in V2 go to Settings › Backup & restore › Choose backup file. It replaces whatever is in your V2 list. Shows with no "Watching on" platform, or saved by a much older version of V1, are left out and listed afterwards so you can add them again.

On this page

Connecting for the first time
Your other devices
Adding a show
Watching, Waiting and Done
Searching your list
Going back or skipping an episode
Suspending a show
Deleting a series
Sync status and fixing sync problems

Connecting for the first time

Create a classic GitHub token with only the gist scope (step-by-step instructions). Keep it in your password manager or Notes.
Open My Shows, paste the token and tap Connect.
My Shows creates a secret gist called My Shows V2 in your GitHub account to hold your list. You don't need to create or name anything yourself.

Don't delete that gist on GitHub: it is your list.

Your other devices

On each other device, open My Shows, paste a token from the same GitHub account and tap Connect. The app finds your My Shows gist and loads your list.

Every change is saved on the device straight away and reaches your gist about two seconds later.
When you switch back to My Shows on another device, it checks your gist and picks up the latest list.
If your account has more than one My Shows list, you'll be asked which one to use. Each is shown with its number of shows and when it was last updated.

Adding a show

Tap Add Show in the bar at the bottom.
Search for the show by name. Results come from TVmaze's free database. Shows already in your list are marked with the group they're in.
Tap the show to select it.
Enter where you're watching it (Hulu, Netflix, whatever you use). This is required.
Choose where you're up to:
- Starting — you'll start from the first episode.
- Season/Episode last watched — enter the season and episode you last watched.
- Caught Up (the default) — every episode that has aired is marked watched. Use this for a show you're waiting on to return: it goes to Waiting, or to Done if the series has ended.
Tap Add show. My Shows puts it in the right group, takes you there, highlights it, and confirms where it went.

If you chose the wrong option, delete the show and add it again.

Watching, Waiting and Done

The three boxes at the top of the main screen show one group at a time, with the number of shows in each. Shows move between groups on their own as episodes air.

Watching

The next episode you haven't watched has already aired. Tap "Mark watched" and it moves straight to the following episode. It has two sections. Currently running shows lists shows still in production, the most recently released episode at the top. Ended shows I'm binging lists series that have ended which you're still working through: one you've just marked watched moves to the bottom, and the others move up in turn.

Waiting

Two sections. Waiting for next episode or season: you're caught up and the show is still in production; shows with a known air date come first, with a countdown. Suspended: shows you've paused (see below). The Waiting count includes both.

Done

The series has ended and you've watched every episode. A show that has ended but still has episodes you haven't watched stays in Watching.

Searching your list

Type in the search box at the top of the main screen. Results come from all three groups, each tagged with the group it's in. Clear the box to go back to the group you were looking at.

Going back or skipping an episode

On a show's detail screen, below Mark watched:

‹ Previous episode moves your place back one episode. Use it if you tapped Mark watched by mistake.
Next episode › moves your place forward one episode without watching it, to skip it.

A message confirms where you're now up to, and the show moves to Watching, Waiting or Done to match. The buttons aren't shown for a suspended show.

Suspending a show

Want to stop tracking a show without losing your place? Open the show and tap Suspend series.

It moves into Waiting › Suspended, tagged "Archived" with today's date.
Your last watched episode and how many episodes/seasons were left are recorded at that moment.
Nothing is deleted.

To pick it back up, tap Reactivate on its row (or "Reactivate series" on its detail screen). It returns to whichever group its progress puts it in.

Deleting a series

On the show's detail screen, Suspend series and Delete series sit next to each other.

Tapping Delete series immediately removes the show and its watch history. There's no confirmation step and no undo, and within a few seconds it's gone from all your devices. If you might want the show back later, use Suspend instead.

Sync status and fixing sync problems

The badge at the top right always shows the sync status. Tap it to open Settings › Sync.

Synced — your gist has your latest changes.
Offline — changes are saved on this device and will be sent when you're back online.
Sync error — token rejected — your token expired or was revoked. Create a new one and use Change token. The app keeps working in the meantime.
Sync error — gist not found — the gist was deleted on GitHub. Recreate gist makes a new one from the list on this device.

Disconnect this device removes your token and list from this device only; your gist keeps the list and connecting again loads it back.