1
0
mirror of https://github.com/yattee/yattee.git synced 2024-12-12 21:30:32 +05:30
Alternative YouTube frontend for iOS (iPhone, iPad), macOS and tvOS (Apple TV) built with Invidious and Piped
Go to file
2021-11-10 00:25:38 +01:00
Extensions Persistence for queue, history and last played 2021-10-24 22:07:41 +02:00
Fixtures Managing Favorites sections 2021-11-01 22:56:18 +01:00
iOS Share button 2021-10-27 01:10:07 +02:00
macOS Improve validation 2021-11-07 22:39:28 +01:00
Model Adding search queries to favorites 2021-11-10 00:25:33 +01:00
Open in Yattee Update extension icons 2021-11-07 17:52:55 +01:00
Shared Adding search queries to favorites 2021-11-10 00:25:33 +01:00
Tests Apple TV Rename project 2021-11-07 15:37:32 +01:00
Tests iOS Rename project 2021-11-07 15:37:32 +01:00
Tests macOS Improve validation 2021-11-07 22:39:28 +01:00
tvOS Adding search queries to favorites 2021-11-10 00:25:33 +01:00
Yattee.xcodeproj Add README 2021-11-09 00:20:52 +01:00
.gitignore Basic Safari extension 2021-10-24 14:41:26 +02:00
.swift-version Playback state improvements 2021-08-24 23:01:53 +02:00
.swiftformat Fix codestyle 2021-06-19 22:17:48 +02:00
.swiftlint.yml Playback state improvements 2021-08-24 23:01:53 +02:00
LICENSE Update README 2021-11-10 00:25:38 +01:00
README.md Update README 2021-11-10 00:25:38 +01:00

Yattee Banner

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

Screenshot

Features

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

Availability

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

Installation

Requirements

Application is built using latest APIs, that's why for now only recent software versions: iOS/tvOS 15 or 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

Safari

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

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

macOS

With Finicky you can configure your systems so the video links across the entire system will get opened in the app. Example configuration:

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

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

Contributing

Every contribution to make this tool better is very welcome. Start with creating issue to have discussion which can be later transformed into a Pull Request.

Review existing Issues and Pull Requests before creating new ones.

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.