mirror of
https://github.com/yattee/yattee.git
synced 2026-02-19 17:29:45 +00:00
3905fd8b18
- Create standalone update-altstore.yml workflow (workflow_dispatch + workflow_call) that gets version from latest GitHub release tag instead of project.pbxproj - Replace inline update_altstore job in release.yml with workflow_call reference - Add altstore-source.json with app metadata and initial version entry - Update README with revised features, TestFlight install link, and new logo assets
114 lines
4.6 KiB
Markdown
114 lines
4.6 KiB
Markdown
<div align="center">
|
|
<img src="Assets/yattee-logo.png" width="150" height="150" alt="Yattee logo">
|
|
<h1>Yattee</h1>
|
|
<p>Privacy-focused video player for iPhone, iPad, Mac, and Apple TV</p>
|
|
|
|
[](https://www.gnu.org/licenses/agpl-3.0.en.html)
|
|
[](https://github.com/yattee/yattee/issues)
|
|
[](https://github.com/yattee/yattee/pulls)
|
|
|
|
[](https://yattee.stream/discord)
|
|
|
|
</div>
|
|
|
|
## Install
|
|
|
|
<a href="https://yattee.stream/beta2">
|
|
<img src="https://developer.apple.com/assets/elements/icons/testflight/testflight-64x64_2x.png" height="40" alt="TestFlight">
|
|
</a>
|
|
|
|
[Join the TestFlight beta](https://yattee.stream/beta2)
|
|
|
|
<!-- App Store link coming soon -->
|
|
|
|
<!-- TODO: new screenshot assets -->
|
|
|
|
## Features
|
|
|
|
**Playback**
|
|
- 4K video with custom MPV-based player (H.264, H.265, VP9, AV1)
|
|
- Picture in Picture, background audio, fullscreen
|
|
- Playback queue, history, resume from last position
|
|
- Chapter navigation, playback speed, subtitles and captions
|
|
- Gesture controls (seek, volume, brightness)
|
|
- Seek preview with storyboards
|
|
|
|
**Content Sources**
|
|
- YouTube via Invidious, Piped, or self-hosted Yattee Server
|
|
- PeerTube instances (federated video)
|
|
- Local files, SMB network shares, WebDAV servers
|
|
|
|
**Integrations**
|
|
- [SponsorBlock](https://sponsor.ajay.app/) (configurable skip categories)
|
|
- [DeArrow](https://dearrow.ajay.app/) (crowdsourced titles and thumbnails)
|
|
- [Return YouTube Dislike](https://returnyoutubedislike.com/)
|
|
|
|
**Privacy**
|
|
- No tracking, no ads, no account required
|
|
- All traffic goes through your chosen instances
|
|
|
|
**Library**
|
|
- Subscriptions with per-channel notifications
|
|
- Bookmarks with tags and notes, playlists, watch history
|
|
- Unified search across all configured sources
|
|
- Import/export subscriptions (JSON, CSV, OPML)
|
|
|
|
**Downloads & Sync**
|
|
- Offline video and audio downloads with quality selection
|
|
- iCloud sync for bookmarks, subscriptions, history, and settings across devices
|
|
- Handoff continuity between iPhone, iPad, Mac, and Apple TV
|
|
|
|
**Apple Ecosystem**
|
|
- iOS 18+ / macOS 15+ / tvOS 18+
|
|
- Native SwiftUI on every platform
|
|
- Customizable home layout, accent colors, player controls, and app icon
|
|
- Clipboard URL detection and deep linking (`yattee://`)
|
|
- Remote control between devices on your network
|
|
|
|
## Yattee Server
|
|
|
|
A self-hosted backend powered by [yt-dlp](https://github.com/yt-dlp/yt-dlp) that gives Yattee superpowers.
|
|
|
|
- **Direct stream URLs** — gets fresh YouTube CDN URLs, bypassing Invidious/Piped blocks and rate limits
|
|
- **Play from 1000+ sites** — Vimeo, TikTok, Twitch, Dailymotion, Twitter/X, and anything else yt-dlp supports
|
|
- **Invidious-compatible API** — drop-in replacement, works alongside existing Invidious/Piped instances
|
|
- **Self-hosted & private** — run on your own hardware, no data leaves your network
|
|
- **Fast parallel streaming** — yt-dlp parallel downloading streams video while it downloads
|
|
- **Admin panel** — web UI for settings, credentials, and monitoring
|
|
- **Docker ready** — single container deployment
|
|
|
|
Check out the [yattee-server](https://github.com/yattee/yattee-server) repository to get started.
|
|
|
|
## Documentation
|
|
|
|
- [Installation](https://github.com/yattee/yattee/wiki/Installation-Instructions)
|
|
- [Building](https://github.com/yattee/yattee/wiki/Building-instructions)
|
|
- [Features](https://github.com/yattee/yattee/wiki/Features)
|
|
- [FAQ](https://github.com/yattee/yattee/wiki/FAQ)
|
|
- [Screenshots Gallery](https://github.com/yattee/yattee/wiki/Screenshots-Gallery)
|
|
- [Tips](https://github.com/yattee/yattee/wiki/Tips)
|
|
- [Integrations](https://github.com/yattee/yattee/wiki/Integrations)
|
|
- [Donations](https://github.com/yattee/yattee/wiki/Donations)
|
|
|
|
## Contributing
|
|
|
|
Browse the [issues](https://github.com/yattee/yattee/issues) list or open a new one to discuss your idea. Every contribution is welcome.
|
|
|
|
See [AGENTS.md](AGENTS.md) for developer setup and project architecture.
|
|
|
|
Join [Discord](https://yattee.stream/discord) or the [Matrix channel](https://matrix.to/#/#yattee:matrix.org) if you need advice or want to discuss the project.
|
|
|
|
## Translations
|
|
|
|
Help make Yattee accessible to everyone by contributing translations.
|
|
|
|
<a href="https://hosted.weblate.org/engage/yattee/">
|
|
<img src="https://hosted.weblate.org/widgets/yattee/-/localizable-strings/multi-auto.svg" alt="Translation status" />
|
|
</a>
|
|
|
|
Localization hosting provided by [Weblate](https://weblate.org/en/).
|
|
|
|
## License
|
|
|
|
Yattee is shared under the [AGPL v3](https://www.gnu.org/licenses/agpl-3.0.en.html) license.
|