Here to help
Support
Available on the App Store for Apple TV, iPhone and iPad.
Watchy brings your Jellyfin, Plex, Emby and SMB libraries together on Apple TV, iPhone and iPad. Your films and series come from the sources you connect to.
Requires Apple TV HD or Apple TV 4K with tvOS 17 or later, or iPhone or iPad with iOS or iPadOS 17 or later.
Trial and permanent access
Connect and verify a source before choosing Start 7-day Trial. Starting the trial is a free App Store purchase. There’s no subscription and you won’t be charged automatically. Watchy — Full Unlock is an explicit one-time purchase ($4.99). You can unlock directly.
Price shown for your region; the App Store shows your final price.
After expiry, playback and full library features require the unlock. An already-playing title can finish; the next episode requires access. Your saved preferences, collections and viewing progress are preserved. Signing out, changing servers or reinstalling does not restart a trial for the same Apple Account.
Choose Restore Purchases on the purchase screen or in Settings → Help & About → Purchases & Restore. Use the Apple Account that acquired access. If the App Store can’t be reached for a while, your unlock keeps working. Your media sources still need a network connection.
Connect your sources
Choose Jellyfin, Plex, Emby or SMB and follow the guided setup. Server sources let you include all libraries or choose a selection; SMB lets you choose a share or folder. Add more sources in Settings → Sources, including multiple servers or shares of the same kind.
Use All Sources to browse your enabled sources together, or choose one source from the selector. Settings → Sources lets you enable, disable, reconnect or remove a source. Disabling a source keeps its saved connection for later.
Jellyfin
Watchy looks for Jellyfin servers on your local network. Choose a discovered server, or select Enter Address. Allow local network access if prompted. Discovery only works on the local subnet; for remote servers or networks that block discovery, enter the address manually.
Enter your Jellyfin hostname or IP address, including the port and base path if your server needs them. For example: 192.168.1.20:8096. Watchy tries HTTPS first when you leave out the scheme. You can enter a complete https:// or http:// URL to choose explicitly.
Quick Connect
After choosing your server, select Quick Connect. Watchy displays a six-character code. On a phone, browser or other Jellyfin client where you are already signed in, open Settings → Quick Connect, enter the code and approve it. Watchy signs in automatically.
If the code expires, choose Get a New Code. If your server has disabled Quick Connect or does not support it, choose Sign in with Password. Both methods save your session securely in Keychain; you do not need to sign in on every launch.
Plex
On Apple TV, scan the on-screen QR code or open the link on another device. On iPhone or iPad, open the sign-in link. Approve Watchy with your Plex account, then choose a server and the libraries to include. Your device must be able to reach that server. Switching between managed Plex Home users is not currently supported.
Emby
Enter your Emby server address, then the username and password for that server. Choose all libraries or a selection. Use your local Emby server account; Emby Connect sign-in is not currently supported.
SMB network shares
For setting up a NAS or shared folder, see our NAS and shared folders guide.
Enter the server and share name, then choose a guest connection or enter the share’s username and password. If your server requires a domain, enter it in the account step. Choose the whole share, browse for a folder or enter a folder path. Then choose Movies, TV or mixed content and review the connection.
SMB supports direct playback of compatible MP4, M4V and MOV files. It cannot transcode files for your device. Library details come from filenames and local NFO files and artwork; Watchy does not fetch SMB metadata from an external matching service. Episode filenames such as S01E02 or 1x02 help Watchy recognise series. SMB viewing progress and watched state are saved in Watchy and sync across your devices when iCloud sync is on.
Cannot reach a source?
- Check that your device and server can reach each other on the network.
- Confirm the hostname, port and any reverse-proxy base path.
- Open the server from another device to check that it is running.
- For HTTPS, use a certificate trusted by your device.
- Check that your account can access the selected libraries or share.
Playback help
Direct playback depends on the video, audio, subtitles and your device model. Jellyfin, Plex and Emby can provide a transcoded stream when a compatible direct source is unavailable. Check your server’s playback permissions and transcoding configuration. SMB requires a file your device can play directly.
During playback, audio and subtitle choices use the player menus. On iPhone and iPad, tap the video to reveal the controls, then open Playback Options. The controls fade away while you watch. Optional playback information shows the playback method and stream details. If playback fails, try Retry and check your media server’s logs or, for SMB, the file’s compatibility and share permissions.
Your next episode
Series are ordered by the date their newest episode arrived. Opening a series prioritises an unfinished episode, then the next unwatched episode in story order. Browse Episodes lets you choose another episode.
Discover and collections
Discover shelves depend on your library metadata and viewing history. Forgotten films need a known addition date at least one year old, no watched state and no playback progress. Collections support manual titles and genre, runtime and watched-state rules. Collections can contain titles from multiple sources. Collections, exclusions and viewing preferences sync between your devices through your private iCloud database when sync is on. Sync is enabled by default; manage it in Settings → Across Your Devices. These personal collections do not change server collections. Apple TV requires its own source sign-in.
Find something for tonight
Choose Something opens the watch chooser. On iPhone and iPad, tap the shuffle button beside the Discover heading. Choose Movie, TV or Either, select genres and optionally set a time budget. Unknown runtimes cannot satisfy a time budget; choose Any length to include them. TV choices follow the next episode rather than choosing a later episode at random.
Intro, recap and credit controls
Skip actions require Jellyfin 10.10 or newer and a compatible media-segment provider configured on your server. The provider must have analysed the title and returned valid timings. Watchy does not install plugins or guess timings. If a title has no segment data, playback continues normally without skip controls.
Top Shelf · Apple TV
Move Watchy into the top row of your Apple TV Home Screen to show Continue Watching in Top Shelf. Select Watchy there to see its shelf; available titles depend on your connected sources and current access.
Preferences
Settings → Languages sets audio and subtitle defaults. In-player language changes can be remembered for a series. On Apple TV, hold Select on Continue Watching to hide a title locally. On iPhone and iPad, open a title and choose More → Hide from Continue Watching; Settings → Hidden Titles restores it. These preferences do not change other media clients.
Contact
Email helpme@mcthingyface.com with your device model, tvOS, iOS or iPadOS version, Watchy version, source type, server version and a short description of the problem. For playback issues, include codec and playback-method information if available.
Please remove passwords, access tokens, private server URLs and personal media information from any logs or screenshots you send.
For bug reports and technical problems, email oops@mcthingyface.com.
Apple and provider marks
Apple, Apple TV, iPhone, iPad, App Store, tvOS and iPadOS are trademarks of Apple Inc., registered in the U.S. and other countries and regions. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license.
Watchy is an independent app and is not affiliated with, endorsed or sponsored by Jellyfin, Plex or Emby. Their names and marks are used only to identify compatible sources. The Jellyfin icon is by the Jellyfin contributors, used unchanged under CC BY-SA 4.0. Plex, the Plex Play logo and Plex Media Server are trademarks of Plex and used under a license. Emby marks belong to their owner.
Privacy
See our privacy policy for information about saved sign-in, local caches and progress reporting.
