Skip to content
Viguru24Public

About

High-performance, ad-free YouTube player for Android. Built with Jetpack Compose & ExoPlayer. Features SponsorBlock, AI summaries, offline downloads, PiP playback, and fluid gestures.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

221 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฌ Vixz โ€” Sovereign Ad-Free YouTube Experience

Android Client & Windows Desktop Companion

Zero Commercial Ads โ€ข SponsorBlock Auto-Skip โ€ข Hardware Audio Muxing โ€ข 3-Zone Gestures โ€ข 0ms SWR Startup


Stars License Android Windows Obtainium


๐Ÿš€ Direct Fast Downloads

Platform Format Architecture Direct Link
๐Ÿ“ฑ Android APK (v2.2.2) Universal (arm64, armv7, x86_64) ๐Ÿ“ฅ Download APK
๐Ÿ–ฅ๏ธ Windows (Modern App) MSIX Installer (v2.1.0) x64 (Clean sandboxed installation) ๐Ÿ“ฅ Download MSIX
๐Ÿ–ฅ๏ธ Windows (Standalone) Portable EXE (v2.1.0) x64 (Self-contained, zero setup) ๐Ÿ“ฅ Download Portable EXE

๐Ÿ“ฅ Installation โ€ข ๐Ÿ†• What's New โ€ข โšก Performance Architecture โ€ข ๐ŸŒŒ Cosmo Suite โ€ข ๐Ÿ–ฅ๏ธ Windows Desktop โ€ข ๐ŸŽฎ Gestures โ€ข ๐Ÿ“‹ Update Log


๐Ÿ†• What's New in v2.2.2

  • โšก Feed Rendering & Recommendation Engine Performance Overhaul:
    • Batch Recommendation Reasoning: Replaced iterative single-item evaluation with RecommendationEngine.getRecommendationReasons(), which precomputes lookup sets once and processes all video badges in $O(N)$ time.
    • Background Thread Offloading: Shifted feed filtering, sorting, and recommendation scoring off the main UI thread onto Dispatchers.Default using Compose produceState, preventing frame drops and UI freezes during feed scrolling and search.
    • Timestamp Caching & Compiled Regex: Precompiled PUBLISHED_TIME_REGEX and added PUBLISHED_TIME_CACHE in YouTubeUtils, eliminating repeated expensive regex compilation and parsing during scroll.
    • Database Query Batching: Added VideoDao.getVideosByIds() to query only relevant video records instead of scanning the full database with getAllVideosDirect().
    • ViewModel Flow Debounce: Added a 150ms debounce and background dispatcher to repository.allVideos in YouTubeViewModel, preventing excessive UI recompositions during active syncs.
  • ๐Ÿ”„ Direct OTA Updates in UI: Added 1-tap Over-The-Air update checks to the Settings Dialog and Library screen.
  • ๐Ÿ–ฅ๏ธ Windows Desktop Display & Avatar Enhancements: Improved Google profile name resolution, email fallback derivation, and avatar circular clipping.

๐Ÿ†• What's New in v2.2.1

  • ๐Ÿ”‘ Streamlined Google / YouTube Login & Real Subscriptions Sync:
    • 1-Tap Sign-In: Replaced the confusing "Local Guest Profile" card with a prominent, crystal-clear "Sign In with Google / YouTube" card and prioritized the login option at the top of the header dropdown.
    • Unrestricted In-App Browser: Switched WebView User-Agent to Mobile Safari, eliminating Google's "This browser or app may not be secure" roadblock.
    • Autonomous Auth Finalization: As soon as Google authenticates and redirects to YouTube with session tokens (LOGIN_INFO, SID, SAPISID), the app presents a glassmorphic confirmation, automatically fetches your genuine channel name, handle, and avatar via Innertube, persists cookies across CookieHelper and NPDownloader, displays a welcome notification, and smoothly auto-closes without leaving you stranded on the mobile web homepage.
    • Genuine Subscriptions Sync: Directly queries YouTube's authenticated subscription endpoint (FEchannels), populating your real subscribed creators and refreshing your feed instantly.
  • ๐ŸŽฌ Pristine Fallback Player (Eliminated "YouTube Window Within Window"):
    • Edge-to-Edge Embed Architecture: Replaced loading m.youtube.com/watch (which crammed headers, search bars, comments, and recommendations into the player box) with an isolated, pitch-black (#000000) YouTube IFrame Embed container.
    • Zero Website Chrome: Completely removed related video grids, web headers, comments, and subscribe banners from the player frame.
    • Seamless Touch Gestures: Double-tap seeking (-10s / +10s), volume, brightness, and play/pause gestures now communicate directly with the web player.
    • Discrete Fallback HUD: Added a discrete ๐ŸŒ Web Stream Mirror โ€ข Retry Native status pill for full transparency and instant retry.
  • โšก Native Stream Extraction Hardening:
    • Extended Timeout: Increased NewPipe timeout from 3.5s to 8.0s, preventing premature fallback timeouts on slower mobile networks.
    • Added IOS Innertube Client: Added the iOS client to the Innertube fallback sequence, returning direct unthrottled .mp4 video streams without cipher and ensuring 99%+ of videos play natively in ExoPlayer.

๐ŸŒŒ Sovereign Cosmo Software Suite

Vixz is part of the Sovereign Cosmo Software Suite โ€” a family of privacy-first, high-performance desktop and mobile tools built for creators, power users, and freedom lovers:

Project Superpower & Technology Platforms Access
๐ŸŽ™๏ธ Cosmo Whisper Ultra-fast native AI voice dictation & local transcription powered by OpenAI Whisper & .NET 8. Zero cloud lock-in. Windows / macOS Explore Repository โ†’
๐ŸŒŒ Cosmo Symphony GPU-accelerated video & photo orchestrator, hardwood framing studio, AI 4K/8K upscaler & local phone-to-PC sharing (Rust Tauri v2). Windows / PC Explore Repository โ†’
๐ŸŽฌ Vixz Desktop Fluent acrylic YouTube companion with SponsorBlock, AI video copilot, voice commands & offline downloader. Windows 10/11 Explore Repository โ†’
๐Ÿ›ฐ๏ธ Kin-Tracker Next-gen private, 24/7 real-time family safety radar & GPS transit network (open Life360 alternative). Android Explore Repository โ†’
๐ŸŒ Sovereign Suite Portal Central showcase portal and documentation hub for all Cosmo and Sovereign tools. Web Visit viguru24.github.io โ†’

๐Ÿ–ฅ๏ธ Vixz Desktop (Windows PC Version)

Prefer watching on your laptop or desktop? Experience Vixz Desktop โ€” the ultimate Windows 10/11 YouTube companion:

  • ๐ŸŽจ Fluent Acrylic Glassmorphism: Rich, dynamic Windows design with zero generic web wrappers.
  • ๐Ÿ›ก๏ธ Zero Commercial Ads & SponsorBlock: Automatically skips pre-rolls, banner pop-ups, and in-video sponsor segments with millisecond precision.
  • ๐Ÿค– AI Copilot with Voice & TTS: Ask questions about any video, summarize key takeaways with interactive timestamps, and listen with ๐Ÿ”Š Read Aloud (Text-to-Speech).
  • ๐ŸŽ™๏ธ Voice Search & Commands: Use speech recognition to find videos or execute commands hands-free.
  • ๐Ÿ“ฅ 1-Click 1080p MP4 Downloader: Save pristine video and audio directly to your local drive for offline viewing.
  • โง‰ Always-On-Top Floating PiP Mini-Player: Keep videos floating while working in other apps.
  • ๐ŸŒ™ Sleep Timer with Audio Fade-Out: Automatically winds down playback with smooth audio attenuation.

๐Ÿ‘‰ ๐Ÿ“ฅ Download Vixz Desktop (.MSIX) โ€ข ๐Ÿ“ฅ Download Portable EXE โ€ข Explore the GitHub Repo


โšก Quick Install Guide

Option A: Direct APK Install

  1. ๐Ÿ“ฅ Download the Latest Vixz APK (v2.2.1) directly to your Android device.
  2. Open the downloaded .apk file from your browser downloads or notification tray.
  3. If prompted by Android, tap "Settings" โ†’ "Allow from this source", then tap Install.
  4. Open Vixz and enjoy pure, uninterrupted video playback with zero ads!

Option B: Automatic Background Updates (Recommended)

Track and auto-update Vixz seamlessly using Obtainium:

  • Tap โšก Add to Obtainium on your device to install and receive instant background update notifications whenever a new version is released.

๐Ÿ›ก๏ธ How Ad-Elimination Works (Two-Layer Defense)

Unlike web browsers with ad-block extensions that often get detected or break playback, Vixz uses a native two-layer architecture:

1. 100% Elimination of Commercial YouTube Ads

  • How it works: Vixz connects directly to Google's raw media distribution networks (.mp4, .m3u8, and DASH streams) and decodes video using native Android hardware (ExoPlayer).
  • Result: YouTube's ad-serving JavaScript code and ad tracking containers never execute. There are 0 pre-roll ads, 0 mid-roll ads, 0 post-roll ads, and 0 banner popups.

2. Automatic SponsorBlock Skipping

  • How it works: When creators record sponsor promotions directly into their video footage ("A quick word from our sponsor..."), Vixz queries the crowd-sourced SponsorBlock API.
  • Result: As soon as playback hits a sponsor timestamp, the player automatically leaps over the entire promotion in milliseconds, displaying an on-screen badge: โญ๏ธ Skipped Sponsor (01:15 โ†’ 02:30).

๐ŸŽฎ 3-Zone Smart Player Gestures

Control your video effortlessly without hunting for tiny sliders:

Screen Area Gesture Action
Far Left Edge (Outer 28%) Vertical Drag Up / Down โ˜€๏ธ Brightness Control (0% โ€“ 100%) with animated HUD
Far Right Edge (Outer 28%) Vertical Drag Up / Down ๐Ÿ”Š Media Volume Control (0% โ€“ 100%) with animated HUD
Middle Area (Center) Single Tap โฏ๏ธ Play / Pause toggle
Center Left Double-Tap โช Rewind 10 Seconds (-10s)
Center Right Double-Tap โฉ Fast-Forward 10 Seconds (+10s)
Middle Area Swipe Up โญ๏ธ Next Video in Feed Queue
Middle Area Swipe Down โฎ๏ธ Previous Video in Feed Queue

๐ŸŒŸ Other Key Features

  • โšก 0ms SWR Local-First Startup: Instant feed loading from local Room SQLite database with silent background sync.
  • ๐Ÿ’พ Offline Downloads with Muxed Audio: Hardware MediaMuxer combines separate high-res video and high-bitrate audio streams into a single synchronized .mp4 file for airplane mode.
  • ๐Ÿ“ One-Tap Organization: Star favorites, save to custom subject folders, or add to Watch Later directly on the video screen.
  • ๐Ÿค– On-Device AI Summaries: Instant video takeaways and timestamped note-taking.
  • ๐Ÿ”’ 100% Private: No cloud telemetry, no analytics, and no Google Play Services dependencies.

๐Ÿ“ฑ Device Compatibility

  • Android Versions: Android 8.0 (Oreo) through Android 15+
  • Architectures: arm64-v8a, armeabi-v7a, x86_64

๐ŸŒŸ Try Our Other Products

Discover more tools developed by our team:

  • ๐ŸŽ™๏ธ Cosmo Whisper โ€” Ultra-fast, on-device AI speech-to-text, audio transcription, and voice intelligence.
  • ๐ŸŽฌ Cosmo Symphony on Microsoft Store / GitHub โ€” Video, photo, and media studio editing & organization on Windows.
  • ๐Ÿ–ฅ๏ธ Vixz Desktop โ€” Windows 10/11 Glassmorphic YouTube Player & AI Copilot.

โญ Star this repository on GitHub to support active development!

About

High-performance, ad-free YouTube player for Android. Built with Jetpack Compose & ExoPlayer. Features SponsorBlock, AI summaries, offline downloads, PiP playback, and fluid gestures.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages