Skip to content

tzii/ThystTV

 
 

Repository files navigation

ThystTV

A fork of Xtra with additional features focused on viewer experience, data management, and accessibility.

Note: This fork is experimental and mostly vibe coded. Features are tested manually but may have rough edges. Contributions and bug reports welcome!

Known Issues & TODO

Gesture System (In Progress)

The gesture system is functional and customizable:

  • Tap sensitivity after scroll: Fixed (taps ignored immediately after scroll)
  • Gesture zone boundaries: Configurable split between top/bottom zones
  • Minimize gesture conflicts: Fixed (gestures blocked when controls visible)
  • Haptic feedback: Added (optional, disabled by default)
  • Settings integration: Customize sensitivity, zones, and haptics in Settings
  • Edge cases: Refine minimize behavior during active gestures

Stats & Analytics

  • Category breakdown: Charts and legends implemented
  • Data visualization: Bar charts, pie charts, and heatmaps added

General

What's Different from Xtra?

Feature Xtra ThystTV
Floating Chat Overlay No Yes
Screen Time & Watch Stats No Yes
Swipe Gesture Controls No Yes

Key Features

💬 Floating Chat (New!)

  • Overlay Mode: Keep up with the chat while watching in full-screen.
  • Customizable: Resize and move the chat window anywhere on the screen.
  • Opacity Control: Adjust transparency to balance visibility between the stream and the chat.
  • High Contrast Mode: Toggle for better readability over bright video content.

⏱️ Screen Time & Stats

  • Daily Tracking: Monitor your daily viewing time directly within the app.
  • Top Channels: See a leaderboard of your most-watched channels and streamers.
  • Privacy First: All stats are stored locally on your device and are never shared.
  • Easy Access: Access your stats via the new "Stats" tab in the bottom navigation.

👆 Gesture Controls

  • Intuitive Control: Easily adjust settings without blocking the view.
  • Volume: Slide up/down on the right half of the screen.
  • Brightness: Slide up/down on the left half of the screen.
  • Seek (VoD only): Horizontal swipe on the top half of the screen.
  • Playback Speed (VoD only): Horizontal swipe on the bottom half of the screen.
  • Visual Feedback: Real-time slider overlay during adjustment.
  • Edge Protection: Gestures are disabled in system gesture zones to prevent conflicts.
  • Double-Tap: Cycle through chat display modes (overlay, side-by-side, hidden).

Building

# Debug build
./gradlew assembleDebug

# Release build
./gradlew assembleRelease

# Run tests
./gradlew test

License

ThystTV is licensed under the GNU Affero General Public License v3.0, same as the upstream Xtra project.

About

Third-party Twitch client for Android. Based on Xtra, with new features

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Kotlin 94.0%
  • Java 6.0%