- Swift 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Richard Harvey
36dc29806a
Now Playing: what is playing is published to Control Centre and the Siri Remote's TV button, with play, pause and next wired up, so playback can be controlled from outside the app. Cleared on teardown so nothing is left behind. Picture in Picture: a video keeps playing in the corner while the viewer looks for the next one. Siri and Shortcuts: tvOS 18 App Intents for 'Play what's trending on Pip' and 'Open my subscriptions in Pip', which also appear as Shortcuts actions. An intent cannot drive the UI, so it leaves its request for the root view to collect when the app becomes active. Multi-user: the obvious approach - read TVUserManager.currentUserIdentifier and namespace storage by it - is deprecated since tvOS 16, and the deprecation is explicit that reading the current user is no longer supported. The modern model is to declare the Runs as Current User capability and let tvOS give each user a separate data container, which makes everything already written per-user with no code. UserProfiles is therefore thin: it answers shouldStorePreferencesForCurrentUser and nothing else, and Settings says so only when it is genuinely in effect. Also lengthens the keyboard wait in a UI test: first launch is slower now the app embeds an extension, and 10s had become marginal. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> |
||
| docs | ||
| PeerTubeTV | ||
| Tests | ||
| Tools | ||
| TopShelf | ||
| UITests | ||
| .gitignore | ||
| BUILD.md | ||
| LICENSE | ||
| PRIVACY.md | ||
| project.yml | ||
| README.md | ||
Pip
Watch the video network nobody owns — on your telly.
An unofficial PeerTube client for Apple TV. Free, open source, and built with ❤️ by Ric Harvey, supported by SquareCows.
What is this?
PeerTube is video hosting that nobody owns. Instead of one company running one enormous site, thousands of independent servers — instances — host their own videos and talk to each other. No algorithm deciding what you see. No adverts. No company.
This app brings all of it to your Apple TV.
Find things worth watching
Most PeerTube apps can only search the server you signed in to. That means a channel you know exists often simply will not appear.
This one searches the whole network by default, and plays what it finds wherever it happens to live. Look for a channel, get the channel — not a shrug.
There is plenty to browse, too: trending, just added, live right now, top rated, and whatever is local to your own instance.
Sign in — or don't
Sign in to any instance and your subscriptions, playlists, Watch Later, history and continue-watching come with you. Two-factor sign-in works.
Prefer not to? Browse anonymously. The app remembers which you chose and stops asking.
Watch it properly
Videos play full screen at the best quality the instance actually published — not whatever your connection settles for in the first few seconds. Change quality mid-video whenever you like.
Subtitles, audio tracks and playback speed are a swipe away, along with a link to the channel and a subscribe button. Where you got to syncs back to your instance, so you can pick it up on your phone later.
When a video ends you land back where you were, rather than being dragged into the next thing. Unless you'd rather it kept going — that's a setting.
Made the way you want it
Full screen playback, best-available quality, autoplay, resume and progress sync are all yours to change. Sensitive content is hidden until you ask for it, not the other way round.
It knows where it lives
Pip uses the Apple TV properly rather than just running on it.
On the home screen. Put Pip in the top row and the shelf fills with what's actually trending on your instance — and what you were part-way through. Choosing one drops you straight into it.
From anywhere. What's playing shows up in Control Centre and on the Siri Remote's TV button, so you can pause or skip without going back to the app. Picture in Picture keeps a video going in the corner while you look for the next one.
By voice. "Play what's trending on Pip." "Open my subscriptions in Pip." They're Shortcuts actions too, so you can build them into automations.
For everyone in the house. On an Apple TV with more than one user, your instance, account, history and blocked list are yours alone — tvOS keeps each person's separate.
Your feed, your rules
Had enough of someone? Block the account — or the whole server it lives on — and they vanish from everywhere in the app at once. No account needed, and blocks are easy to undo in Settings.
Something worse than annoying? Report it to the moderators of the instance hosting it, straight from the video or the player.
Sensitive content is hidden until you ask for it, never the other way round.
Nothing is watching you
No analytics. No tracking. No adverts. No third-party code of any kind. There is no server belonging to the developer, so there is nowhere for your data to go even in principle.
Your password goes to the instance you chose and nowhere else, and the sign-in token stays in your Apple TV's keychain.
Read the full privacy policy →
Getting it
The app is not on the App Store yet — see the honest assessment of what stands in the way.
In the meantime you can build it yourself. It needs Xcode 27 and the tvOS 27 SDK: Building Pip →
Contributing
Bugs, ideas and patches are all welcome at code.squarecows.com/ric/peertube-tvos.
If you are poking around the code, BUILD.md and the engineering notes explain the parts that are not obvious — and why a few of them are stranger than they look.
Thank you
To Framasoft and everyone who has built PeerTube, and to every person running an instance out of their own pocket. This app is only a window; you made the thing worth looking at.
MIT licensed · Built with ❤️ by Ric Harvey · Supported by SquareCows
PeerTube is a trademark of Framasoft. This app is unofficial and is not affiliated with, endorsed by, or supported by the PeerTube project.