Skip to content

makhlwf/accessible_youtube_downloader_pro

 
 

Repository files navigation

🎥 HexPlayer

GitHub release Python Version Platform Accessibility License: GPL v3

HexPlayer is a powerful, lightweight, and highly accessible Windows application designed for browsing, watching, and downloading YouTube content. Built with a focus on blind and visually impaired users, it provides a seamless experience without the complexities of a web browser.


🔒 Privacy Policy

HexPlayer respects your privacy. We do not collect or transmit any of your personal information. Read our full Privacy Policy for more details.


✨ Key Features

  • 🔍 Direct Search: Search for videos, playlists, and live streams directly within the app.
  • 🎧 Dedicated Media Player: An accessible built-in player that supports audio and video modes.
  • 📥 Advanced Downloading: Download content in various formats (MP4, MP3, M4A) with yt-dlp integration.
  • 🔗 Smart Clipboard Detection: Automatically detects YouTube links from your clipboard on startup.
  • 📁 Auto-Organization: Automatically creates folders for playlists and channels during downloads.
  • Background Tasks: Watch your favorite videos while downloading others in the background.
  • 🌍 Multilingual: Full support for Arabic and English with automatic system language detection.
  • 🚀 Performance: Optimized for Windows 10/11 (64-bit).

⌨️ Essential Keyboard Shortcuts

HexPlayer is designed to be fully navigable via keyboard.

Shortcut Action
Ctrl + F Search YouTube
Ctrl + D Download from Link / Direct Download
Ctrl + Y Play YouTube Link
Ctrl + Shift + F Open Favorites
Ctrl + P Open Download Folder
Alt + S Open Settings
F1 User Guide
Space Play / Pause (Player)
Arrows Volume and Seeking (Player)
Shift + Up / Down Arrows Playback Speed (Player)

🚀 Getting Started

Installation

from GitHub releases

  1. Download the latest version from the Releases Page.
  2. Run the HexPlayer.exe installer.
  3. Follow the on-screen instructions (it will optionally download yt-dlp for you).

Using WinGet

run your CMD or Powershell and Run

winget install HexPlayer

Silent Installation

For system administrators and automated deployments, the installer supports the following command-line arguments:

  • /VERYSILENT: Perform a fully silent installation (no UI).
  • /SILENT: Perform a silent installation with a progress bar.
  • /DOWNLOADCOMPONENTS=1: Force the download of required components (yt-dlp and Deno) during a silent installation.
  • /DIR="C:\Path\To\Install": Specify a custom installation directory.

Example (Fully silent with components):

HexPlayer.exe /VERYSILENT /NORESTART /DOWNLOADCOMPONENTS=1

Example (Silent with progress):

HexPlayer.exe /SILENT /NORESTART /DOWNLOADCOMPONENTS=1

Running from Source (For Developers)

  1. Clone the repo:
    git clone https://github.com/makhlwf/accessible_youtube_downloader_pro.git
    cd accessible_youtube_downloader_pro
  2. Setup Virtual Environment:
    python -m venv .venv
    .venv\Scripts\activate
  3. Install Dependencies:
    pip install -r requirements.txt
  4. Run the App:
    cd source
    python accessible_youtube_downloader_pro.py

🛠️ Building the Executable

To create your own standalone executable:

  1. Ensure you are in the root directory and your venv is active.
  2. Install PyInstaller: pip install pyinstaller
  3. Run the build script: python build.py
  4. Find your app in the dist/HexPlayer folder.

🤝 Acknowledgements

  • Original Developer: Suleiman Al Qusaimi.
  • Maintainer & Fork Author: Makhlwf.
  • Core Engine: Powered by yt-dlp and wxPython.

📜 License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.


⚠️ Disclaimer

This project is a fork of the original "Accessible YouTube Downloader Pro". It is provided "as is" without warranty of any kind. Please ensure you comply with YouTube's Terms of Service when using this application.


Made with ❤️ for the accessibility community.

About

an accessible youtube browser and downloader desktop application for nvda users

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 88.5%
  • JavaScript 5.9%
  • HTML 2.9%
  • Inno Setup 2.5%
  • Batchfile 0.2%