FaselHD

Description

A powerful CLI tool that searches, browses, and streams movies and series from FaselHD. Features automatic Cloudflare bypass, real-time quality detection from m3u8 master playlists, concurrent episode downloads, and multiple playback options including a built-in mini player.

Features

• Smart Cloudflare Bypass
  Uses a persistent browser session with lazy detection — solves Cloudflare challenges only when needed, then reuses the session for fast subsequent requests. Falls back to curl_cffi with TLS fingerprint impersonation if scrapling is unavailable.

• Real-Time Quality Detection
  Parses m3u8 master playlists to detect actual available resolutions (240p–2160p) instead of guessing from URLs. Shows detected qualities before you choose.

• Download Movies & Series
  Download movies or entire seasons with concurrent episode downloads (up to 3 parallel). Automatic retry on failure with progress tracking via rich.

• Stream to Any Player
  Open streams directly in your preferred media player (VLC, PotPlayer, MPV, etc.) through the system "Open With" dialog.

• Built-in Mini Player
  Stream directly inside FaselHD's embedded VLC-based mini player window — no external player needed.

• Copy to Clipboard
  Copy the direct m3u8 stream URL to clipboard for use in any external player or tool.

• Browse Trending
  Browse trending and recently added movies/series directly from the main page without searching.

• Search with Caching
  Search results are cached for 5 minutes to avoid redundant page fetches when refining your selection.

• Automatic ffmpeg Setup
  Auto-downloads ffmpeg on first run if not found in system PATH or imageio-ffmpeg cache. No manual setup required.

• Interactive CLI
  Rich-powered terminal UI with colored tables, progress bars, and panels. Full Arabic/Unicode support on Windows with automatic console font and codepage configuration.

Screenshots

1	2
3	4

Installation

Requirements

• Python 3.10+ — Download Python
• OS: Windows, Linux, or macOS

git clone https://github.com/De3vil/Faselhd.git
cd Faselhd
pip install -r requirements.txt
playwright install chromium
python nfshd.py

Note: playwright install chromium downloads the Chromium browser needed for video stream extraction. This only needs to be done once. ffmpeg is downloaded automatically on first use.

---

Original Author — Abdulrahman Mohammed (De3vil)

If this tool has been useful for you, feel free to support the original author:

---

Fork Maintainer — Abdo

If you find this fork useful, consider supporting me: