HLS Video Downloader Client

HLS Video Downloader Native Messaging Client for Windows, Linux and macOS.

• Windows: install-win.exe
• Linux: install-linux.deb
• macOS: install-macos.pkg

Note

On macOS you need to Ctrl+Click or Right-Click the .pkg and then choose Open to install.

Web Extension: https://github.com/cssnr/hls-video-downloader

Browsers

Tested and working in the following browsers:

• Firefox
• Waterfox
• Edge
• Chrome
• Chromium
• Brave
• Opera
• Vivaldi
• Ghost

Installing

Download and run the installer for your operating system from the latest release.

Building

Windows

Note

The Windows installer uses Inno Setup which must be manually installed.

Note: FFmpeg must be placed in dist/ffmpeg.exe

Build the App:

python -m pip install -r requirements.txt
pyinstaller --noconfirm client.spec
python manifest.py

Create the Installer:

iscc.exe client.iss

Linux

Note: FFmpeg must be placed in dist/ffmpeg

#python -m pip install -r requirements.txt
python manifest.py
bash build-linux.sh

MacOS

Note

The macOS installer uses Packages which must be manually installed.

Note: FFmpeg must be placed in dist/ffmpeg

Build the App:

python -m pip install -r requirements.txt
pyinstaller --noconfirm client.spec
python manifest.py

Create the Package:

bash build-mac.sh

More Info

Windows requires corresponding registry entries for the manifest files (see location links below).

Windows and macOS requires packaging the app with pyinstaller to bundle python.

Manifest files must be renamed to org.cssnr.hls.downloader.json on Linux and macOS.

Manifest key path must be set to the absolute path to the client location.

Manifest files must be placed in specific directories:

• Firefox: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#manifest_location
• Chrome: https://developer.chrome.com/docs/extensions/develop/concepts/native-messaging#native-messaging-host-location

If the client location is not writable by the user and a writable log.txt must be created at that location due to the current logging configuration in the client.py.

The client.py must be executable by the user with Python installed and working.