yattee/README.md

Video player for Invidious and Piped instances built for iOS, tvOS and macOS.

Features

• Native user interface built with SwiftUI
• Multiple instances and accounts, fast switching
• SponsorBlock, configurable categories to skip
• Player queue and history
• Fullscreen playback, Picture in Picture and AirPlay support
• Stream quality selection
• Favorites: customizable section of channels, playlists, trending, searches and other views
• yattee:// URL Scheme for integrations

Availability

Feature	Invidious	Piped
User Accounts	✅	✅
Subscriptions	✅	✅
Popular	✅	🔴
User Playlists	✅	🔴
Trending	✅	✅
Channels	✅	✅
Channel Playlists	✅	✅
Search	✅	✅
Search Suggestions	✅	✅
Search Filters	✅	🔴
Subtitles	🔴	✅
Comments	🔴	✅

Installation

Requirements

System requirements:

• iOS 14 (or newer)
• tvOS 15 (or newer)
• macOS Big Sur (or newer)

How to install?

macOS

Download and run latest version from the Releases page.

iOS/tvOS: AltStore (free)

You can sideload IPA files downloaded from the Releases page to your iOS or tvOS device - check AltStore FAQ for more information.

If you have to access to the beta AltStore version (v1.5, for Patreons only), you can add the following repository in Browse > Sources screen:

https://alt.yattee.stream

iOS/tvOS: Signing IPA files online (paid)

UDID Registrations provides services to sign IPA files for your devices. Refer to: Break free from the App Store section of the website for more information.

iOS/tvOS: Manual installation

Download sources and compile them on a Mac using Xcode, install to your devices. Please note that if you are not registered in Apple Developer Program you will need to reinstall every 7 days.

Integrations

macOS

With Finicky you can configure your system to open all the video links in the app. Example configuration:

{
  match: [
    finicky.matchDomains(/(.*\.)?youtube.com/),
    finicky.matchDomains(/(.*\.)?youtu.be/)
  ],
  browser: "/Applications/Yattee.app"
}

Screenshots

iOS

Player	Search	Playlists

iPadOS

Settings	Player	Subscriptions

tvOS

Player	Popular	Search	Now Playing	Settings

macOS

Player	Channel	Search	Settings

Tips

Settings

• [tvOS] To open settings, press Play/Pause button while hovering over navigation menu or video

Navigation

• Use videos context menus to add to queue, open or subscribe channel and add to playlist
• [tvOS] Pressing buttons in the app trigger switch to next available option (for example: next account in Settings). If you want to access list of all options, press and hold to open the context menu.
• [iOS] Swipe the player/title bar: up to open fullscreen details view, bottom to close fullscreen details or hide player

Favorites

• Add more sections using ❤️ button in views channels, playlists, searches, subscriptions and popular
• [iOS/macOS] Reorganize with dragging and dropping
• [iOS/macOS] Remove section with right click/press and hold on section name
• [tvOS] Reorganize and remove from Settings > Edit Favorites...

Keyboard shortcuts

• Command+1 - Favorites
• Command+2 - Subscriptions
• Command+3 - Popular
• Command+4 - Trending
• Command+F - Search
• Command+P - Play/Pause
• Command+S - Play Next
• Command+O - Toggle Player

Donations

You can support development of this app with Patreon or cryptocurrencies:

Monero (XMR)

48zfKjLmnXs21PinU2ucMiUPwhiKt5d7WJKiy3ACVS28BKqSn52c1TX8L337oESHJ5TZCyGkozjfWZG11h6C46mN9n4NPrD

Bitcoin (BTC)

bc1qe24zz5a5hm0trc7glwckz93py274eycxzju3mv

Ethereum (ETH)

0xa2f81A58Ec5E550132F03615c8d91954A4E37423

Donations will be used to cover development program access and domain renewal costs.

Contributing

If you're interestred in contributing, you can browse the issues list or create a new one to discuss your feature idea. Every contribution is very welcome.

License and Liability

Yattee and its components is shared on AGPL v3 license.

Contributors take no responsibility for the use of the tool (Point 16. of the license). We strongly recommend you abide by the valid official regulations in your country. Furthermore, we refuse liability for any inappropriate use of the tool, such as downloading materials without proper consent.

This tool is an open source software built for learning and research purposes.