yattee/README.md
2021-11-16 21:12:47 +01:00

6.8 KiB

Yattee Banner

Video player with support for Invidious and Piped instances built for iOS 15, tvOS 15 and macOS Monterey.

AGPL v3 GitHub issues GitHub pull requests Matrix

Screenshot

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
  • URL Scheme for integrations

Availability

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

Installation

Requirements

Only iOS/tvOS 15 and macOS Monterey are supported.

How to install?

AltStore

You can sideload IPA files that you can download from Releases page. Alternatively, if you have to access to the beta AltStore version (v1.5), you can add the following repository in Browse > Sources screen:

https://alt.yattee.stream

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 then the applications will require reinstalling 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"
}

Experimental: Safari

macOS and iOS apps include Safari extension which will redirect opened YouTube tabs to the app.

Expermiental: Firefox

You can use Privacy Redirect extension to make the videos open in the app. In extension settings put the following URL as Invidious instance:

https://r.yatte.stream

Screenshots

iOS

Player Search Playlists
Yattee Player iOS Yattee Search iOS Yattee Subscriptions iOS

iPadOS

Settings Player Subscriptions
Yattee Player iPadOS Yattee Player iPadOS Yattee Subscriptions iPad S

tvOS

Player Popular Search Now Playing Settings
Yattee Player tvOS Yattee Popular tvOS Yattee Search tvOS Yattee Now Playing tvOS Yattee Settings tvOS

macOS

Player Channel Search Settings
Yattee Player macOS Yattee Channel macOS Yattee Search macOS Yattee Settings macOS

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

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.