Adds an opt-in native HLS video player (iOS-only, off by default) that uses AVPlayerViewController for true automatic picture-in-picture on swipe-home, replacing the WebView-based player when enabled. Key changes: - GQL API client for fetching playback access tokens and building HLS URLs - NativeVideoStore (MobX) managing player lifecycle, quality selection, PiP - VideoPlayerInterface abstraction so both stores drive the same overlay - Settings toggle gated on iOS with "Native player (experimental)" label - Auth token fallback: tries authenticated GQL for ad-free, falls back to anonymous if rejected (app OAuth token != web Client-ID token) - Scoped UnauthorizedInterceptor to Helix/OAuth URLs only - iOS Info.plist background audio mode for PiP audio continuity Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| .claude | ||
| .github | ||
| .vscode | ||
| android | ||
| assets | ||
| ios | ||
| lib | ||
| scripts | ||
| test | ||
| web | ||
| .env.example | ||
| .gitignore | ||
| .mcp.json | ||
| .metadata | ||
| AGENTS.md | ||
| analysis_options.yaml | ||
| firebase.json | ||
| LICENSE | ||
| pubspec.lock | ||
| pubspec.yaml | ||
| README.md | ||
Download
Why
The official Twitch mobile app doesn't support emotes from 7TV, BetterTTV (BTTV), and FrankerFaceZ (FFZ) — third-party extensions for Twitch used by millions. As a result, only emote text names are rendered rather than their actual image or GIF, making the chat unreadable in many channels.
Features
- Support for 7TV, BetterTTV, and FrankerFaceZ emotes and badges
- Browse followed streams, top streams, and top categories
- Autocomplete for emotes and user mentions
- Light, dark, and black (OLED) themes
- Search for channels and categories
- See and filter chatters in a channel
- Local chat user message history
- Theater and fullscreen mode
- Watch live streams with chat
- Picture-in-picture mode
- Block and report users
- Emote menu
- Sleep timer
- And more...
For a more detailed overview, visit frostyapp.io.
Development setup
-
Clone this repo (e.g.,
git clone https://github.com/tommyxchow/frosty.git). -
Go to the Twitch dev console and register a new application to retrieve a Client ID and Client Secret.
-
Copy
.env.exampleto.envand fill in your credentials:cp .env.example .env -
Run
flutter pub getto fetch all the dependencies. -
Choose an emulator or device and run the app! The included VS Code launch configurations will automatically read your
.envfile. -
(Optional) Run
dart run scripts/get_twitch_token.dartto quickly get a user auth token. Long-press the Anonymous account tile in the app to log in.
Important
Frosty uses MobX for state management. Please refer to the documentation about code generation, otherwise your changes within MobX stores may not be applied.
Donate
If you appreciate my work and would like to donate/tip, you can through:
Otherwise, downloading Frosty, leaving a review, or starring this repository is more than enough to show support. Thank you!
License
Frosty is licensed under AGPL-3.0-or-later.