ScreenDiary Shortcuts
Recipe Book

Ready-to-build shortcut recipes, from single-action logs to multi-step discovery chains. Each recipe includes step-by-step instructions, a worked example, and a link to download the shortcut.

17 Recipes
34 Actions

Contents

Chapter One

Logging & Library

Simple, high-frequency shortcuts for recording what you watch. Start here. These are the fastest to build and immediately useful.

Add a Movie to Your Wishlist

You hear about a film in a podcast or conversation. Search for it and save it to your wishlist in a few taps.

Get shortcut

Steps

Search Media

Set Search Text to Ask Each Time. The shortcut will prompt you to type the title when it runs. Set type to Movie if you want to filter out TV Series.

Choose from List

Pass the Search Media results so you can confirm the correct title.

Add to Wishlist

Pass the chosen Media Result. The title is saved to your wishlist immediately.

Worked example

You run Add to Wishlist, type "Hundreds of Beavers", and pick the first result.

Expected result

Hundreds of Beavers added to your wishlist
Library Update confirms: Added to Wishlist

Tip

Add to Wishlist will let you know if a title is already there.

Mark a Movie as Watched

You just finished watching a film. Log it with a date, liked status, and star rating - all in one prompted shortcut run.

Get shortcut

Steps

Search Media

Ask Each Time - type the film you just watched.

Choose from List

Confirm the correct title from search results.

Mark Movie as Watched

Set Watch Date to Today. Set Liked and Rating both to Ask Each Time - you'll be prompted for each on every run.

Worked example

You search "Alien Romulus", pick the 2024 film from the results, choose Liked, and enter a rating of 4.

Expected result

Alien: Romulus marked as watched, dated today
Liked: Yes, Rating: 4/5 saved to diary
Library Update: Marked as Watched

Tip

To log silently without prompts - from an automation, for instance - pre-fill Liked and Rating with fixed values. All parameters support Ask Each Time or a fixed value.

Mark First Episode Watched

You've watched the first episode of a new show. Log it with the First Episode scope so your diary reflects what you've actually seen, not the whole series.

Get shortcut

Steps

Search Media

Media Type: Series. Ask Each Time.

Choose from List

Pick the series from results.

Mark Series as Watched

TV Watch Scope: First Episode. Watch Date: Today. Liked: Ask Each Time.

Get Next Episode

Pass the same series. Shows when Episode 2 airs - display as a Show Result notification.

Worked example

You search "Severance", pick the show, mark S1E1 as watched, and say you liked it.

Expected result

Severance added to diary - First Episode, dated today
Liked: Yes saved to the record
Get Next Episode returns: S1E2 "Half Loop" - air date shown

Tip

If the series is already in your diary, Mark Series as Watched pauses and asks before overwriting - so it's safe to run even if you're not sure whether you've logged it before.

Recent Watches Digest

Pull your recent viewing history and share it - as a plain-text message, a note, or anything your other shortcuts can consume.

Get shortcut

Steps

Get Recently Watched Titles

Count: 10. Media Type: All - or restrict to Movie if you only want films.

Combine Text

Use the Title field of each item, joined with new lines. This formats the list as readable text.

Share / Show Result

Send to Messages, copy to clipboard, append to a note - whatever fits your workflow.

Worked example

You run the shortcut on a Sunday to send your week's watches to a friend.

Expected result

Up to 10 recent titles returned as Media Results
Combined as text: "The Substance, Dune: Part Two..."
Ready to paste into a message or note

Tip

Attach this to a Sunday evening automation trigger so it runs automatically each week without you needing to remember.

Chapter Two

Discovery

Find something to watch - from browsing your wishlist to checking streaming availability and pulling recommendations.

Find Something in Your Wishlist

Two ways to pick from your wishlist. Browse and choose yourself, or let the shortcut pick one at random. Both options show where you can watch and open the film in ScreenDiary.

Option A: Browse and Choose

Pick Something from Wishlist

Pick Something to Watch

Source: Wishlist. Random Pick: Off. This returns the full list so you can choose.

Choose from List

Pick the title you want to watch.

Get Watch Providers for Media

Region: Ask Each Time - or change this to your region so you never have to pick. Tip: if you have ScreenDiary Pro, you can use the enhanced Where to Watch feature from inside the app after Open Media takes you to the title.

Open Media

Opens the selected title in ScreenDiary.

Get shortcut: Browse and Choose

Option B: Feeling Adventurous?

Surprise Me

Pick Something to Watch

Source: Wishlist. Random Pick: On. The shortcut picks one film for you - no list shown, no deliberating.

Open Media

Opens the randomly selected title straight in ScreenDiary.

Worked example

You run Option A with 40 titles on your wishlist. You pick "The Lighthouse" and want to know where to watch it.

Expected result

Your wishlist presented as a choosable list
Watch Providers returned for your region: streaming, rental, purchase options
ScreenDiary opens to The Lighthouse's detail page

Tip

Change the Region parameter from Ask Each Time to your own region so you are not prompted every time. ScreenDiary Pro users can then use the enhanced Where to Watch feature from inside the app after the title opens in ScreenDiary to open straight to a streaming service.

What Can I Watch Right Now?

Cross-reference your wishlist against live streaming availability. Only surfaces titles you can actually watch tonight.

Get shortcut

Steps

What Can I Watch Right Now?

Returns wishlist titles currently available to stream in your region.

Choose from List

Pick one of the streamable titles.

Get Watch Providers for Media

Region: Ask Each Time. Change this to your own region to skip the prompt every run.

Open Media

Opens the selected title in ScreenDiary.

Worked example

You run this on a Friday night with 35 titles on your wishlist.

Expected result

Wishlist checked against streaming services in your region
8 titles currently streamable returned as a choosable list
You pick one; providers shown; ScreenDiary opens to the detail page

Tip

Set Region to your own country once and you will not be asked again. ScreenDiary Pro users can then use the enhanced Where to Watch feature from inside the app after opening the title in ScreenDiary.

Watch a Trailer

Search a film, pick a trailer, and open it before deciding whether to add it to your wishlist.

Get shortcut

Steps

Search Media

Ask Each Time.

Choose from List

Pick the title from search results.

Get Videos for Media

Pass the selected title. Category can be Ask Each Time, or set it to Trailer if you only want trailers.

Choose from List

Pick the video you want to watch.

Open URLs

Pass the selected Video directly. It already behaves like a playable link in Shortcuts.

Worked example

You search "Nosferatu", choose the 2024 film from the results, and watch the trailer before deciding.

Expected result

Get Videos returns a list of trailers and teasers
You pick "Official Trailer" and pass that selected Video straight into Open URLs
YouTube opens directly to the Nosferatu trailer

Tip

After Open URLs, add an Add to Wishlist step so you can save the film immediately if the trailer sells you on it, all in one run.

More Like This

Just finished something you loved? Get recommendations based on it and bulk-save them to your wishlist or a custom list.

Get shortcut

Steps

Search Media

Ask Each Time - type the film you just loved.

Choose from List

Confirm the correct title.

Get Recommendations for Media

Mode: Ask Each Time (choose from Recommended or Similar), or fix it to Recommended. Returns a list of suggested titles.

Bulk Save to List

Destination: Ask Each Time - choose Wishlist, an existing custom list, or create a new one. Titles already present are skipped.

Worked example

You just watched and loved Parasite. You run the shortcut with Parasite as the seed and choose Recommended.

Expected result

A list of recommendations returned
You choose Wishlist; Bulk Save summary: "42 added, 3 already present"
Wishlist now includes Burning, Shoplifters, A Tale of Two Sisters

Tip

Choose "New Custom List" and name it "Like Parasite" to keep these recommendations separate from your main wishlist. Run it after a few films and you'll have a rich, themed list to work through.

Save a Collection

Search for a TMDB collection and add every film in it to your wishlist or a custom list in a single step.

Get shortcut

Steps

Search Collections

Ask Each Time - type the franchise or collection name, e.g. "Mission: Impossible".

Choose from List

Select the correct collection from results.

Get Media in Collection

Returns all films in the collection as a list of Media Results.

Bulk Save to List

Destination: New Custom List (name it e.g. "Bond Films") or Wishlist. All titles saved in one step.

Worked example

You search "Alien Collection" and pick the Alien franchise.

Expected result

Get Media in Collection returns 6 films
Bulk Save summary: "4 added, 2 already present"
New list "Alien Collection" created with all entries

Advanced option

Instead of Bulk Save to List, add Repeat with Each Item, then Is Watched, then Add to Wishlist inside the false branch. That version checks each film against your history and only adds unseen entries.

Chapter Three

People & Filmography

Explore cast and crew - pull a director's filmography, dive into an actor's credits, or find the cinematographer behind a film you loved.

Who Directed This?

Search any film and get its director's name and biography - then optionally chain into their full filmography and save it to your library.

Part 1: Who Directed This?

Search Media

Ask Each Time.

Choose from List

Pick the film.

Get Crew for Media

Department: Directing. Job: Director. Returns the director(s) as People.

Get Person Info

Field: Biography. Show Result to display as a quick look.

Get shortcut: Who Directed This?

Part 2: What Else Did They Direct?

Get Credits for Person

Chain directly from Part 1. Credits: Crew. Department: Directing. Job: Director.

Show Result or Bulk Save to List

Display their filmography directly, or save the whole lot to a new custom list or your wishlist.

Get shortcut: What Else Did They Direct?

Worked example

You search "Mulholland Drive" and run Part 1. You then chain into Part 2.

Expected result

Get Crew returns: David Lynch (Directing / Director)
Get Person Info returns his full biography as a quick-look result
Get Credits returns all his directing credits - Eraserhead, Blue Velvet, Lost Highway, and more
Bulk Save adds those directing credits to your wishlist or custom list.

Tip

Change the roles in Part 2 to find other films from the same writer or cinematographer. Swap Department: Directing / Job: Director to Department: Writing / Job: Screenplay - same shortcut, different lens.

Director Deep Dive

Search for a director by name, pull their full filmography, and save it to a named custom list - a complete director survey in seconds.

Get shortcut

Steps

Search People

Ask Each Time. Birth year shown in subtitle helps distinguish people who share a name.

Choose from List

Pick the correct person from results.

Get Credits for Person

Credits: Crew. Job: Director. Returns all directing credits.

Bulk Save to List

Destination: New Custom List. Name it e.g. "Kubrick Films". List created and filled in one step.

Worked example

You search "Paul Thomas Anderson" and run the shortcut.

Expected result

Get Credits returns Paul Thomas Anderson's directing credits
New custom list "Paul Thomas Anderson Films" created
Bulk Save summary shows the full filmography now in your library

Tip

Change Job to "Screenplay" for a writer's filmography, or Department to "Camera" for a cinematographer's full credit history. Department and Job filters use substring matching and are case-insensitive.

Cast Rabbit Hole

Pick a film, see its cast, choose an actor, and pull up their filmography for a late-night discovery spiral.

Steps

Search Media

Ask Each Time.

Choose from List

Pick the starting film.

Get Cast for Media

Returns the full cast list - up to 100 people.

Choose from List

Pick one actor from the cast.

Get Credits for Person

Credits: Cast. Then Bulk Save to List (Wishlist) or Open Person to explore in-app.

Worked example

You start with "Eyes Wide Shut", browse the cast, and pick Nicole Kidman.

Expected result

Get Cast returns the full Eyes Wide Shut cast list
Get Credits for Nicole Kidman returns around 60 acting credits
Bulk Save adds the returned credits to your wishlist. If you only want unseen titles, add Is Watched If Repeat before the save step.

Tip

Run Open Person at the end instead of Bulk Save if you'd rather browse the actor's page in ScreenDiary and decide which films to save manually.

Find the Cinematographer

Discover who shot a film you loved, then explore every other film they've shot - a great way to find visually consistent work.

Steps

Search Media

Ask Each Time - type the film whose cinematography you loved.

Choose from List

Pick the film.

Get Crew for Media

Department: Camera. Job: Director of Photography.

Choose from List

Pick the DP - some films have more than one.

Get Credits for Person

Department: Camera. Bulk Save to List (Wishlist or a new named list).

Worked example

You loved the look of Blade Runner 2049 and want to find more work by its DP.

Expected result

Get Crew returns: Roger Deakins (Camera / Director of Photography)
Get Credits returns around 80 camera credits
Films like No Country for Old Men, Skyfall, 1917 added to wishlist

Tip

You can combine Department and Job independently. Omit Job to get all camera department credits including camera operators and gaffers - useful for a broader view of someone's career.

Chapter Four

TV & Series

Track upcoming episodes, build a TV schedule, and stay on top of every show you follow.

This Week's Episodes

A digest of every upcoming episode across all series you follow - covering the next seven days.

Get shortcut

Steps

Upcoming Episodes

Within Days: 7. Filter: Watching - gives you only series you're currently following that have episodes airing this week.

Show Result

Display the episode list directly, or use Combine Text to format it as a readable digest before sharing.

Worked example

You run this on a Monday morning. You follow 12 active series.

Expected result

3 series have upcoming episodes this week
The Bear S4E2 - Tue, Severance S3E5 - Wed, The Penguin S2E1 - Fri
9 followed series excluded - nothing airing this week

Tip

Attach a Monday 8am automation trigger to this shortcut so you get the week's TV schedule delivered automatically.

Add Episode to Calendar

Find the next episode of a specific show and add it as a calendar event - including the episode code and title - so you never miss a premiere.

Get shortcut

Steps

Search Media

Media Type: Series. Ask Each Time.

Choose from List

Pick the series. Save it to a variable - you'll reference it in the calendar title.

Get Next Episode

Returns the next unaired episode. If nothing is returned (show ended or on hiatus), the If block below handles it gracefully.

If Get Next Episode has any value

Only proceed if an episode was found.

Get Episode Details

Pass the episode from Get Next Episode. Returns the episode code (e.g. S2E4), episode title, and air date as separate fields you can use in the next step.

Add New Event

Title: [Series Name] + [Episode Code] + [Episode Title] - all from your variables. Date: Air Date from Get Episode Details. Add to your TV or Entertainment calendar.

Otherwise: Show Alert

No upcoming episode found. Display a friendly message so the shortcut doesn't just silently end.

Worked example

You search "The Bear" and run the shortcut.

Expected result

Get Next Episode returns: next unaired episode found
Get Episode Details: Episode Code S4E3, Title "Forks", Air Date 14 August
Calendar event created: "The Bear S4E3 Forks" on 14 August in your TV calendar

Tip

Always include the If block after Get Next Episode. The action returns nothing gracefully if the show has ended or been cancelled - without the check, the Calendar step has nothing to work with and may error.

Am I Caught Up?

Check whether a series is in your diary, and find out what the next episode is if you're not up to date.

Get shortcut

Steps

Search Media

Media Type: Series. Ask Each Time.

Choose from List

Pick the series. Save it to a variable.

Is Caught Up?

Returns true or false based on whether the series is in your diary.

If Is Caught Up: Show Result

You're up to date - display a confirmation.

Otherwise: Get Next Episode

Pass the series variable. Returns the next episode to watch so you know where to pick up.

Worked example

You search "Slow Horses" to check where you're up to.

Expected result

Is Caught Up returns false - you're behind
Get Next Episode returns: "Endgame" S5E6 - the episode to watch next

Tip

Chain Get Episode Details after Get Next Episode to pull out the episode code, title, and air date - useful for adding a calendar reminder or sharing with a friend.

Reference

Using Actions Together

A few simple ways to combine ScreenDiary actions in Shortcuts.

Save and Discover

Search Media Choose from List Add to Wishlist

Universal starting point. Search returns both Media Results and People Results - pick the branch your shortcut needs.

Wishlist to Watch

Pick Something to Watch Get Watch Providers Open Media

Wishlist items, filtered and picked, with streaming availability shown before opening in ScreenDiary.

Person Deep Dive

Search People Get Credits for Person Bulk Save to List

Full filmography saved to a named list in three actions. Job filter narrows to a specific role like Director or Screenplay.

Franchise Sweep

Search Collections Get Media in Collection Bulk Save to List

Every film in a franchise, saved at once. Add an Is Watched loop to filter to unseen titles only.

Weekly TV

Upcoming Episodes Get Episode Details Show Result / Calendar

Filter to Watching for active shows only. Get Episode Details pulls the code, title, and air date. Pair with a Monday automation for a hands-off weekly digest.

Wishlist to Trailer

Pick Something to Watch Choose from List Get Videos for Media Choose from List Open URLs

Start with something from your wishlist, pick a trailer or teaser, then open it straight away.

Reference

All Actions

Open full documentation

Add to Wishlist

Returns Library Update

Mark Movie as Watched

Returns Library Update

Mark Series as Watched

Returns Library Update

Get Recently Watched Titles

Returns List of Media Results

Get Recently Added Titles

Returns List of Media Results

Is Watched

Returns Boolean

Get Media in Custom List

Returns List of Media Results

Pick Something to Watch

Returns List of Media Results

What Can I Watch Right Now?

Returns List of Media Results

Bulk Save to List

Returns Dialog (summary only)

Search Anything

Returns Search Results (Media + People)

Search Media

Returns List of Media Results

Open Media

Returns Nothing - opens app

Get Media Info

Returns Text (single field value)

Get Cast for Media

Returns List of People

Get Crew for Media

Returns List of People

Get Videos for Media

Returns List of Videos

Get Recommendations for Media

Returns List of Media Results

Get Watch Providers for Media

Returns List of Watch Providers

Get Images for Media

Returns List of Images (JPEG)

Get Collection for Media

Returns List of Collections

Get Media in Collection

Returns List of Media Results

Search Collections

Returns List of Collections

Search People

Returns List of People

Get Person Info

Returns Text (single field value)

Get Credits for Person

Returns List of Media Results

Open Person

Returns Nothing - opens app

Get Seasons for Series

Returns List of Seasons

Get Episodes for Season

Returns List of Episodes

Get Next Episode

Returns Episode (or nothing if show ended)

Get Latest Episode

Returns Episode

Get Episode Details

Returns Episode Code, Title, Air Date

Upcoming Episodes

Returns List of Episodes

Is Caught Up?

Returns Boolean