ThiraiJellyfin client Download

Thirai

Jellyfin client

A very simple way for the whole family to watch your Jellyfin server on Windows. Big pictures, no logins, nothing to break, and a PIN-protected settings page for the person who looks after it.

Version 1.0.2Windows 10 & 11 (64-bit)Free & open source

Thirai's start screen in Simple mode: Good evening, Meena! with big Keep watching and Favourites pictures

Why Thirai

Made for the people normal apps forget

Thirai was built for a family member with Down syndrome, who found the usual Jellyfin apps confusing: sign-in screens, tiny buttons, menus everywhere. In Thirai they tap a big picture and it plays.

Thirai (திரை) is Tamil for the cinema screen. It's what you see when the curtains open.
People with an intellectual disabilityOne tap plays. Nothing to get lost in.
Parents and grandparentsLarge, calm and clear, with plain words.
Young childrenBright colours, screen-time limits, a lock.
You, tooFull mode is a fast, tidy player for confident users.

Three modes

One app, the right amount of choice for each person

Every PC picks the mode that suits the person using it. Your parents' laptop can be in Easy, your sister's in Simple and yours in Full, all watching the same Jellyfin server.

Simple mode start screen
Simple

For someone who needs things very simple

  • Huge pictures. One tap plays.
  • Six bright colour themes (Bright, Candy, Ocean, Jungle, Sunset, Space)
  • Help button with faces and phone numbers
  • Settings hidden behind a secret corner and PIN
Easy mode start screen
Easy

For people who aren't comfortable with technology

  • Large and calm, without cartoon colours
  • Film details with Continue or Play from the start
  • Search, favourites, subtitles and language
  • Choice of background, highlight colour and size
Full mode start screen
Full

For confident users

  • Compact and professional (dark chocolate and lime by default)
  • Sort by A–Z, newest or year, and mark as watched
  • Playback speed, subtitles and audio language
  • Everything Easy has
SimpleEasyFull
SizeHuge (adjustable)Large (adjustable)Compact (adjustable)
Tap a filmPlays straight awayDetails page firstDetails page first
SearchNoYesYes
FavouritesShownAdd / removeAdd / remove
SortingNoNoA–Z, Newest, Year
Player extrasSubtitles (if allowed)Subtitles, languageSubtitles, language, speed
Mark as watchedNoNoYes
SettingsHidden corner + PINSettings button + PINSettings button + PIN
ClosingExit → 👍 / 👎Exit → Yes / NoExit → Yes / No
Can be locked openYesYesNo

What you get

Simple on the outside, careful on the inside

No logins, ever

The viewer never types a user name or password. You link their Jellyfin profile once.

Big pictures, plain words

Every button has an icon and a word. A yellow ring shows what's being pointed at.

A Help button

Shows the faces and phone numbers of the people to call when something's not right.

Screen time

Daily limits (30 minutes to any number of hours), allowed hours like 7:00–21:00, and a gentle "That's all for today!".

Subtitles your way

On, off or as the video decides, with a preferred language. You decide whether Simple mode gets a Subtitles button.

Full screen, with a safe exit

An Exit button with "Are you sure?", or lock it so only you can close it with your PIN.

Any screen

Looks the same on a 1080p laptop and a 4K monitor, and you can make everything bigger or smaller.

Plays almost anything

Built on the VLC video engine, so your server never has to convert video. Resumes where they stopped.

A proper opening

The curtains part and the screen lights up with a "ta-DUM". A tap skips it, and you can turn it off.

Private and local

No accounts, no cloud, no tracking. Thirai talks only to your own Jellyfin server.

Nothing to break

Thirai never deletes or changes your films. If the server is off, they see a friendly "The TV box is sleeping".

Keep watching

Remembers where they stopped and can play the next episode after a 10-second countdown.

New versions, your choice

Thirai tells you when a new version is out and installs it when you say so, keeping all settings. The viewer in Simple mode is never asked.

Download

Install Thirai

Free, with nothing else to install: everything Thirai needs is included. Version 1.0.2.

Portable

Nothing is installed. Good for trying Thirai, for a USB stick, or for PCs where you can't install apps. (It doesn't update itself.)

  1. Download Thirai-Portable, open it and choose where to put the Thirai folder (Documents, a USB stick…).
  2. Open that folder and double-click Thirai.exe.
  3. Keep the whole folder together. Settings are saved in its Data folder.

Moving the folder to another PC or Windows account? Open the settings and link the profile again (the saved key only works for the account that made it).

Download portable (99 MB)

"Windows protected your PC"? Thirai is new and isn't signed with a paid certificate yet, so Windows SmartScreen may show a blue warning the first time. Click More info, check the app is Thirai-Setup, then click Run anyway.

To be sure your download is complete and unchanged, compare its SHA-256 checksum (shown under each button, also in checksums.sha256). In PowerShell: Get-FileHash .\Thirai-Setup-*.exe

WindowsWindows 10 (1809 or newer) or Windows 11, 64-bit
JellyfinJellyfin server 10.9 or newer, with Quick Connect on (it is by default)
NetworkThe PC and the server on the same home network
SpaceAbout 225 MB once installed

For the admin

Set it up once, in about five minutes

The person who looks after the Jellyfin server (the admin) does this once on each PC, signed in to the viewer's Windows account. The viewer never sees any of it.

In Jellyfin: give them their own user

  1. Dashboard → Users → +: create a user for them. A password is optional.
  2. Profile tab: leave Allow this user to manage the server off, and turn Allow media deletion off.
  3. Access tab: tick only the libraries they should see.
  4. Parental control (optional): set a maximum rating.
  5. Check Dashboard → General → Quick Connect is enabled (it is by default).

Open Thirai and choose an admin PIN

The first time Thirai opens, it asks you to choose a PIN (and type it twice). The PIN protects the settings. Five wrong tries lock the PIN pad for a minute.

1. Connection: find your server and link their profile

  • Click Find it on my network, or type the server's address, such as 192.168.1.20:8096, and click Check connection. If Jellyfin runs in Docker or on a NAS the search may find nothing; just type the address.
  • Sign in with your Jellyfin admin account, pick their profile and click Give Thirai access to this profile.
  • Thirai gets its own key for that profile through Jellyfin Quick Connect. Your password is used once and never saved, and your admin session is signed out straight away.
  • No Quick Connect? Use Other way and type their own user name and password once.

2. Viewer & look: who is this PC for?

Pick Simple, Easy or Full. Recommended options are filled in for you. Then choose the colours and screen size, the name for "Good evening, ___!", and their photo.

Anything else, then Save

Everything else is optional and can be changed later: libraries and the start screen, watching options, screen time, help contacts, full screen and closing. Click Save and go to the start screen. Done!

Settings, section 1: Connection
Settings: the side menu jumps between the 8 sections.
The Thirai setup wizard welcome page
The installer.

Getting back into settings later. Press and hold the top-right corner of Thirai for 3 seconds (just below the title bar when it's in a window; on a trackpad, press the pad down and keep it pressed), or press Ctrl+Shift+A. In Easy and Full there's also a Settings button on the start screen. You'll always need the PIN.

Everyday use

How Thirai works for the viewer

The start screen
  • A greeting with their name and photo: "Good evening, Meena!"
  • Keep watching: things they started, with a bar showing how far they got.
  • Favourites, then their libraries (Films, TV, Family videos…).
  • With a single library, Thirai can open straight into it.
  • Easy and Full also have Search and Settings buttons.
Watching a film or a show
  • Simple: tap a picture and it plays. If they'd started it, it carries on where they stopped.
  • Easy and Full: tapping a film opens its page first, with Continue, Play from the start and Add to favourites (Full also has Mark as watched).
  • TV shows: tap the show, then a season, then an episode. The next episode can start by itself after a 10-second countdown.
  • Videos always play full screen, even when Thirai is in a window, and the window comes back as it was afterwards.
Getting around: Back and Home

Every page has the same Back and Home buttons in the same place. Esc or Backspace also goes back.

When something isn't right
  • The Help button shows the people to call, with their photos and phone numbers (set in settings, section 6).
  • If the server is off they see "The TV box is sleeping" and who to call. Thirai keeps trying and carries on by itself when the server is back.
  • There are never error boxes or technical messages on the viewer's screens.
Closing Thirai
  • In a window: the usual × at the top right.
  • Full screen: an Exit button on the start screen asks "Are you sure?". Simple mode uses big 👍 / 👎 buttons, and if nobody answers it goes back by itself.
  • Locked (Simple and Easy, if you choose): only the admin can close Thirai, with the PIN. Even × and Alt+F4 are ignored.
When screen time is up

A calm moon and "That's all for today!" (or "It's resting time" outside the allowed hours). Five minutes before, a gentle "5 minutes left today" appears on the video. By default the current film or episode may finish, but no new one starts. The admin can give 30 more minutes with the PIN.

The player
The player controls

Big buttons with words: Start again, Back 10, Play / Pause, Skip 30, Quieter, Louder. Easy and Full add Subtitles and Language, and Full adds Speed.

Click the video to hide the buttons straight away (like VLC). Click or move the mouse to bring them back. They also hide by themselves after a few seconds.

KeyWhat it does
Space or the play/pause keyPlay / pause
←Back 10 seconds
→Skip 30 seconds
↑ / ↓ or volume keysLouder / quieter
Esc or BackspaceStop and go back
Keyboard and remote
  • Tab moves the yellow ring; Enter or Space chooses.
  • Media keys on keyboards and remotes (play/pause, stop, volume, back, home) work too.
  • Ctrl+Shift+A opens the settings (PIN needed).

Settings guide

Every setting, explained

Settings are in eight sections, in the order you'd set things up. Changes take effect when you click Save and go to the start screen.

1Connection
  • Jellyfin server: find it on your network, or type its address (e.g. 192.168.1.20:8096; :8096 is added if you leave it out) and click Check connection.
  • Their Jellyfin profile: sign in with your admin account and pick the profile (recommended), or use Other way with their own user name and password.
  • Disconnect from this server switches to a different Jellyfin server. The PIN, photos, help contacts and other options are kept.
  • Unlink this profile from this PC removes Thirai's key from the server.
2Viewer & look
Viewer and look settings
  • Who is this PC for? Simple, Easy or Full (see the modes). Picking one fills in recommended options, which you can change.
  • Look for this mode: Simple has six colour themes. Easy and Full have a background (Graphite, Chocolate, Midnight, Black, Forest, Plum, Slate) and a highlight colour (Gold, Lime, Amber, Orange, Red, Coral, Pink, Violet, Ice, Teal, Mint, Silver). Colours change straight away so you can see them.
  • Screen size: Smaller, Standard, Larger or Largest. Thirai already fits itself to the screen; this adjusts on top.
  • Greeting name and their photo for the start screen.
3What they can watch
  • Jellyfin libraries: tick the libraries to show in Thirai.
  • See ALL libraries on the server (with your admin sign-in) changes which libraries the profile can open on the server itself.
  • When Thirai opens: with exactly one library ticked, Thirai can go straight into that library.
  • Show or hide the Keep watching and Favourites rows.
4Watching
  • Remember where they stopped (saves progress to Jellyfin).
  • Play the next episode automatically after a 10-second countdown.
  • Go full screen while watching when Thirai is in a window.
  • Subtitles when a video starts: as the video decides, off, or on, with an optional preferred language (e.g. English).
  • Subtitles button in Simple mode: off by default, so subtitles can't be switched on by accident.
5Screen time
Screen time settings
  • Daily limit: 30 minutes to 8 hours, or any number of hours. Only time spent watching counts, not browsing.
  • Allowed hours, e.g. 7:00 to 21:00 (overnight ranges work too).
  • Let the current video finish when time runs out (on by default), but no next one starts.
  • Reset today's time starts today's count again. On the "That's all for today!" screen, More time (admin PIN) gives 30 minutes.
6Help contacts

Up to three people, with a name, phone number and photo, shown by the Help button and on the "TV box is sleeping" screen.

7Window & closing
  • Full screen (no window borders).
  • Start Thirai automatically when this Windows account signs in.
  • Play the Thirai opening when it starts, and with its sound.
  • Closing Thirai: an Exit button with "Are you sure?" (shown in full screen), no exit button, or Locked: only the admin can close it, with the PIN (Simple and Easy).
8Admin
  • Change admin PIN.
  • Open Jellyfin dashboard in browser.
  • Open settings folder: where Thirai keeps its settings, photos and log.
  • Updates: tell me when a new version is available (on by default), Check for updates now, and Install when there is one.

Privacy & safety

Your family's films stay at home

No passwords stored

Thirai uses its own key for the viewer's profile, encrypted for that Windows account. The admin PIN is stored only as a salted hash.

Read-only by design

It never deletes or changes your media. It only saves watch progress, favourites and "watched" marks for the viewer's profile.

No cloud, no tracking

No accounts, no ads, no analytics. Thirai talks only to the Jellyfin server you choose.

You stay in control

Revoke access any time in Jellyfin: Dashboard → Devices, delete the PC's "Thirai" device.

Help

Questions and fixes

Thirai can't find my server

The network search only finds servers that answer Jellyfin's discovery (servers in Docker or on a NAS often don't). Type the address instead: the server's IP address and port, like 192.168.1.20:8096. You'll find it in Jellyfin under Dashboard → Networking, or on your router's list of devices. Make sure the PC is on the same network as the server.

It says "The TV box is sleeping"

Thirai can't reach the Jellyfin server. Check the server is switched on and connected, and that the PC is on the home Wi-Fi. Thirai keeps trying and carries on by itself. If the server's address has changed, update it in settings, section 1 (giving the server a fixed IP address on your router prevents this).

I forgot the admin PIN
  1. Close Thirai. If it's locked open, use Task Manager (Ctrl+Shift+Esc), select Thirai and click End task.
  2. Press Win+R, type %LocalAppData%\Thirai and press Enter (portable version: the Data folder next to Thirai.exe).
  3. Delete settings.json and open Thirai again. You'll set it up from the start (photos and contacts need adding again).
Windows says "Windows protected your PC"

That's Windows SmartScreen being careful with a new app that isn't signed with a paid certificate. Click More info, then Run anyway. You can check the download hasn't been changed with its SHA-256 checksum (see Install).

How do I update Thirai?

An installed Thirai checks this page every few hours and tells you when a new version is out. Nothing installs by itself: in Easy and Full a banner on the start screen offers Install now or Not now; in Simple mode it only shows in Settings → 8. Admin, so the viewer is never asked. Installing keeps all settings, and Thirai opens again by itself.

The portable version doesn't update itself: download the newest one and put it in the same folder (its Data folder is kept).

How do I uninstall it?

Windows Settings → Apps → Installed apps → Thirai → Uninstall. You'll be asked whether to also remove Thirai's settings (PIN, server link, photos, contacts); choose No if you'll install it again. For the portable version, just delete the folder.

Videos don't play or stutter

Thirai plays files directly from the server without converting them, so it depends on your home network. Try a wired connection or move closer to the Wi-Fi router. Very large 4K files need a fast network. If one particular file never plays, check it plays in Jellyfin's own web app.

A library or film doesn't show up

Thirai shows what the viewer's Jellyfin profile is allowed to see, and only libraries ticked in settings, section 3. Check the profile's Access tab in Jellyfin (or use See ALL libraries on the server in section 3). Music, books and photo libraries aren't shown: Thirai is for films, shows and home videos.

Can I use it on several PCs?

Yes. Install it on each PC and link a profile on each. Every PC has its own mode, look, PIN and screen-time settings. Several PCs can use the same Jellyfin profile.

Does it work away from home?

Thirai is designed for your home network. If your Jellyfin server is reachable from elsewhere (for example through a VPN such as Tailscale), you can enter that address instead.

Mac, Linux, phones or TVs?

Thirai is a Windows app (Windows 10 and 11, 64-bit). On other devices, use Jellyfin's own apps.

Where does Thirai keep its files?

In %LocalAppData%\Thirai (portable version: the Data folder beside Thirai.exe): settings.json (options, with the key encrypted), photos, screentime.json and thirai.log (errors, useful when asking for help). Settings → 8. Admin → Open settings folder takes you there.

Ready when the curtains are

Free for every family. Version 1.0.2 for Windows 10 and 11.