EgyBestCLI

This Project Has Been Discontinued

This Project Has Been Moved to GitLab

This is a simple Command-Line tool that allows you to download media from EgyBest. You can also use this tool to stream media directly without downloading it using the power of the --stdout flag.

This project depends on the PyEgyBest Library that provides a selenium-less solution to interact with EgyBest

Tested on Python versions >= 3.6

Installation

Downloading and Installing The Python Script

git clone "https://gitlab.com/SafwanLjd/EgyBestCLI.git"
cd EgyBestCLI
pip install -r requirements.txt
python ./egybest-cli.py --help

Downloading The Windows Binary

Not Recommended

git clone "https://gitlab.com/SafwanLjd/EgyBestCLI.git"
cd EgyBestCLI/bin
./egybest-cli.exe --help

Usage

What Can This Script Do

• Download A Movie
• Download An Episode of A TV Show
• Download A Whole Season of A TV Show
• Watch An Episode/Movie Directly Through An Embeded Video Player
• Print The Direct Media URL of An Episode/Movie (or All The Episode URLs of A Season, One URL Per Line) to Standard Output So You Can Do Stuff Like Pipe It Into Your Favorite Video Player

Default Behavior

The Script by default:

• Picks the closest result to your search query automatically. You can pick a search result manually using the --manual-search flag
• Picks the video quality according to your config file. You can pick it manually using the --manual-quality flag

Examples

Download The Movie "Back to The Future"

egybest-cli --title "Back to The Future"

Download The First Episode of The First Season of The Show "Game of Thrones"

egybest-cli --title "Game of Thrones" -S 1 -E 1

Download All the Episodes of The Third Season of The Show "Peaky Blinders"

egybest-cli --title "Peaky Blinders" -S 3

Play The Third Episode of The Fifth Season of The Show "Black Mirror" in An Embeded Video Player (Doesn't Work on macOS and Wayland)

egybest-cli -t "Black Mirror" --season 5 --episode 3 --watch

Play The Fifth Episode of the Fourth Season of The Show "Mr. Robot" Directly in The MPV Video Player

mpv $(egybest-cli --title "Mr. Robot" -S 4 -E 5 --stdout)

Configuration

There is a single config file which is ~/.config/egybest/egybest-conf.json

Default egybest-conf.json

{
    "mirror": "https://egy.best",

    "quality": {
        "2160": 1,
        "1080": 2,
        "720":  3,
        "480":  4,
        "360":  5,
        "240":  6
    }
}

Quality

Lower Number = Higher Priority

It's set to pick the highest quality available by default.

Mirror

You can set it to a specific EgyBest instance, but these go up and down all the time, the default "mirror" is https://egy.best, which is not actually a mirror, it's just a load balancer that redirects you to a working instance.