Metadata-Version: 2.4
Name: yt-dlp-getpot-jsi
Version: 0.3.1
Maintainer: grqz
Keywords: yt-dlp,yt-dlp-plugin,yt-dlp-pot-provider
Requires-Python: >=3.9
Description-Content-Type: text/markdown

Official repository: <https://github.com/grqz/yt-dlp-getpot-jsi>

A yt-dlp plugin that attempts to generate POT with the phantomjs Javascript Interpreter.

The javascript part is basically a backport of [LuanRT/BgUtils](https://github.com/LuanRT/BgUtils). The [_Research_](https://github.com/LuanRT/BgUtils?tab=readme-ov-file#research) section of its README helped a lot when developing this plugin.

Current status: works with an HTTP server on the python side.

# Installing

## Requirements
1. yt-dlp **`2025.05.22`** or above
2. PhantomJS **`1.9.0`** or above

## Installing PhantomJS

1. Download and unzip PhantomJS from [*Download PhantomJS*](<https://phantomjs.org/download.html>)
2. Make sure the PhantomJS is available in your `PATH` (see [*How do I set or change the PATH system variable?*](<https://www.java.com/en/download/help/path.html>))

## Installing the plugin

**pip/pipx**

If yt-dlp is installed through `pip` or `pipx`, you can install the plugin with the following:

```
pipx inject yt-dlp yt-dlp-getpot-jsi
```
or

```
python3 -m pip install -U yt-dlp-getpot-jsi
```

**Manual**

1. Go to the [latest release](<https://github.com/grqz/yt-dlp-getpot-jsi/releases/latest>)
2. Find `yt-dlp-getpot-jsi.zip` and download it to one of the [yt-dlp plugin locations](<https://github.com/yt-dlp/yt-dlp#installing-plugins>)

    - User Plugins
        - `${XDG_CONFIG_HOME}/yt-dlp/plugins` (recommended on Linux/macOS)
        - `~/.yt-dlp/plugins/`
        - `${APPDATA}/yt-dlp/plugins/` (recommended on Windows)
    
    - System Plugins
       -  `/etc/yt-dlp/plugins/`
       -  `/etc/yt-dlp-plugins/`
    
    - Executable location
        - Binary: where `<root-dir>/yt-dlp.exe`, `<root-dir>/yt-dlp-plugins/`

For more locations and methods, see [installing yt-dlp plugins](<https://github.com/yt-dlp/yt-dlp#installing-plugins>)

---

If installed correctly, you should see the provider's version in `yt-dlp -v` output:

    [debug] [youtube] [pot] PO Token Providers: phantomjs-web-0.3.1 (external)
