{"id":19435579,"url":"https://github.com/cssnr/hls-video-downloader","last_synced_at":"2025-04-14T18:32:59.066Z","repository":{"id":242467272,"uuid":"809581089","full_name":"cssnr/hls-video-downloader","owner":"cssnr","description":"HLS Video Download Web Extension","archived":false,"fork":false,"pushed_at":"2024-09-20T22:40:47.000Z","size":408,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-28T07:02:38.654Z","etag":null,"topics":["browser-extension","chrome-extension","firefox-addon","firefox-extension","hls","video-downloader"],"latest_commit_sha":null,"homepage":"https://github.com/cssnr/hls-downloader-client","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cssnr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-03T03:38:50.000Z","updated_at":"2025-03-02T16:05:12.000Z","dependencies_parsed_at":"2025-01-07T21:10:36.813Z","dependency_job_id":"cb2155de-08e5-4ec0-a6f2-39bcf779a854","html_url":"https://github.com/cssnr/hls-video-downloader","commit_stats":null,"previous_names":["cssnr/hls-video-downloader"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssnr%2Fhls-video-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssnr%2Fhls-video-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssnr%2Fhls-video-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssnr%2Fhls-video-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cssnr","download_url":"https://codeload.github.com/cssnr/hls-video-downloader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248937011,"owners_count":21186144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-extension","chrome-extension","firefox-addon","firefox-extension","hls","video-downloader"],"created_at":"2024-11-10T15:07:06.327Z","updated_at":"2025-04-14T18:32:59.044Z","avatar_url":"https://github.com/cssnr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Chrome Web Store Users](https://img.shields.io/chrome-web-store/users/mpmiiaolodhanoalpjncddpmnkbjicbo?logo=google\u0026logoColor=white\u0026label=users)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Mozilla Add-on Users](https://img.shields.io/amo/users/hls-video-downloader?logo=mozilla\u0026label=users)](https://addons.mozilla.org/addon/hls-video-downloader)\n[![Chrome Web Store Version](https://img.shields.io/chrome-web-store/v/mpmiiaolodhanoalpjncddpmnkbjicbo?label=chrome\u0026logo=googlechrome)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Mozilla Add-on Version](https://img.shields.io/amo/v/hls-video-downloader?label=firefox\u0026logo=firefox)](https://addons.mozilla.org/addon/hls-video-downloader)\n[![GitHub Release Version](https://img.shields.io/github/v/release/cssnr/hls-video-downloader?logo=github\u0026logoColor=white)](https://github.com/cssnr/hls-video-downloader/releases/latest)\n[![Build](https://img.shields.io/github/actions/workflow/status/cssnr/hls-video-downloader/build.yaml?logo=github\u0026logoColor=white\u0026label=build)](https://github.com/cssnr/hls-video-downloader/actions/workflows/build.yaml)\n[![Test](https://img.shields.io/github/actions/workflow/status/cssnr/hls-video-downloader/test.yaml?logo=github\u0026logoColor=white\u0026label=test)](https://github.com/cssnr/hls-video-downloader/actions/workflows/test.yaml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=cssnr_hls-video-downloader\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=cssnr_hls-video-downloader)\n[![GitHub Last Commit](https://img.shields.io/github/last-commit/cssnr/hls-video-downloader?logo=github\u0026logoColor=white\u0026label=updated)](https://github.com/cssnr/hls-video-downloader/graphs/commit-activity)\n[![GitHub Top Language](https://img.shields.io/github/languages/top/cssnr/hls-video-downloader?logo=htmx\u0026logoColor=white)](https://github.com/cssnr/hls-video-downloader)\n[![GitHub Org Stars](https://img.shields.io/github/stars/cssnr?style=flat\u0026logo=github\u0026logoColor=white)](https://cssnr.github.io/)\n[![Discord](https://img.shields.io/discord/899171661457293343?logo=discord\u0026logoColor=white\u0026label=discord\u0026color=7289da)](https://discord.gg/wXy6m2X8wY)\n# HLS Video Downloader\n\nModern Chrome Web Extension and Firefox Browser Addon to Download HLS Videos using Native FFmpeg.\n\nThis Web Extension is a Work in Progress, may contain bugs or not work as expected.\n\n*   [Install](#Install)\n*   [Features](#Features)\n    -   [Upcoming Features](#Upcoming-Features)\n    -   [Known Issues](#Known-Issues)\n*   [Configuration](#Configuration)\n*   [Support](#Support)\n*   [Development](#Development)\n    -   [Building](#Building)\n*   [Contributing](#Contributing)\n\n## Install\n\n*   [Google Chrome Web Store](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n*   [Mozilla Firefox Add-ons](https://addons.mozilla.org/addon/hls-video-downloader)\n\n[![Chrome](https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Firefox](https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_48x48.png)](https://addons.mozilla.org/addon/hls-video-downloader)\n[![Edge](https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Chromium](https://raw.githubusercontent.com/alrra/browser-logos/main/src/chromium/chromium_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Brave](https://raw.githubusercontent.com/alrra/browser-logos/main/src/brave/brave_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Vivaldi](https://raw.githubusercontent.com/alrra/browser-logos/main/src/vivaldi/vivaldi_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n[![Opera](https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_48x48.png)](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo)\n\nAll **Chromium** Based Browsers can install the extension from the\n[Chrome Web Store](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo).\n\n\u003e [!WARNING]\n\u003e This web extension requires a client app to use native FFmpeg.  \n\u003e Source: https://github.com/cssnr/hls-downloader-client  \n\u003e \n\u003e - Windows: [install-win.exe](https://github.com/cssnr/hls-downloader-client/releases/latest/download/install-win.exe)\n\u003e - Linux: [install-linux.deb](https://github.com/cssnr/hls-downloader-client/releases/latest/download/install-linux.deb)\n\u003e - macOS: [install-macos.pkg](https://github.com/cssnr/hls-downloader-client/releases/latest/download/install-macos.pkg)\n\n## Features\n\n- Download `*.m3u8` videos using a native [ffmpeg application](https://github.com/cssnr/hls-downloader-client).\n- Shows the total number of streams found on the toolbar icon.\n- Sends a notification when complete you can click on to open the download folder.\n\n### Upcoming Features\n\n- Playlist parsing to display correct qualities and combine audio/video.\n\n\u003e [!TIP]\n\u003e **Don't see your feature here?**\n\u003e Request one on the [Feature Request Discussion](https://github.com/cssnr/hls-video-downloader/discussions/categories/feature-requests).\n\n### Known Issues\n\n- Streams with separate video and audio will show up as 2 downloads.\n- Stream quality display is not yet accurate.\n- Error handling and messages needs improving.\n\n\u003e [!TIP]\n\u003e **Don't see your issue here?**\n\u003e Open one on the [Issues](https://github.com/cssnr/hls-video-downloader/issues).\n\n## Configuration\n\nYou can pin the Addon by clicking the `Puzzle Piece`, find the Web Extension icon, then;  \n**Chrome,** click the `Pin` icon.  \n**Firefox,** click the `Settings Wheel` and `Pin to Toolbar`.\n\nTo open the options, click on the icon (from above) then click `Open Options`.\n\n## Support\n\nFor help using the web extension, utilize any these resources:\n\n- Q\u0026A Discussion: https://github.com/cssnr/hls-video-downloader/discussions/categories/q-a\n- Request a Feature: https://github.com/cssnr/hls-video-downloader/discussions/categories/feature-requests\n\nIf you are experiencing an issue/bug or getting unexpected results, use:\n\n- Report an Issue: https://github.com/cssnr/hls-video-downloader/issues\n- Chat with us on Discord: https://discord.gg/wXy6m2X8wY\n- Provide General Feedback: https://cssnr.github.io/feedback\n\nLogs can be found inspecting the page (Ctrl+Shift+I), clicking on the Console, and;\nFirefox: toggling Debug logs, Chrome: toggling Verbose from levels dropdown.\n\nTo support this project, see the [Contributing](#Contributing) section at the bottom.\n\n# Development\n\n**Quick Start**\n\nFirst, clone (or download) this repository and change into the directory.\n\nSecond, install the dependencies:\n```shell\nnpm install\n```\n\nFinally, to run Chrome or Firefox with web-ext, run one of the following:\n```shell\nnpm run chrome\nnpm run firefox\n```\n\nAdditionally, to Load Unpacked/Temporary Add-on make a `manifest.json` and run from the [src](src) folder, run one of the following:\n```shell\nnpm run manifest:chrome\nnpm run manifest:firefox\n```\n\nChrome: [https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked](https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked)  \nFirefox: [https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/](https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox/)\n\nFor more information on web-ext, [read this documentation](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/).  \nTo pass additional arguments to an `npm run` command, use `--`.  \nExample: `npm run chrome -- --chromium-binary=...`\n\n## Building\n\nInstall the requirements and copy libraries into the `src/dist` directory by running `npm install`.\nSee [gulpfile.js](gulpfile.js) for more information on `postinstall`.\n```shell\nnpm install\n```\n\nTo create a `.zip` archive of the [src](src) directory for the desired browser run one of the following:\n```shell\nnpm run build\nnpm run build:chrome\nnpm run build:firefox\n```\n\nFor more information on building, see the scripts section in the [package.json](package.json) file.\n\n### Chrome Setup\n\n1.  Build or Download a [Release](https://github.com/cssnr/hls-video-downloader/releases).\n1.  Unzip the archive, place the folder where it must remain and note its location for later.\n1.  Open Chrome, click the `3 dots` in the top right, click `Extensions`, click `Manage Extensions`.\n1.  In the top right, click `Developer Mode` then on the top left click `Load unpacked`.\n1.  Navigate to the folder you extracted in step #3 then click `Select Folder`.\n\n### Firefox Setup\n\n1.  Build or Download a [Release](https://github.com/cssnr/hls-video-downloader/releases).\n1.  Unzip the archive, place the folder where it must remain and note its location for later.\n1.  Go to `about:debugging#/runtime/this-firefox` and click `Load Temporary Add-on...`\n1.  Navigate to the folder you extracted earlier, select `manifest.json` then click `Select File`.\n1.  Optional: Open `about:config` search for `extensions.webextensions.keepStorageOnUninstall` and set to `true`.\n\nIf you need to test a restart, you must pack the addon. This only works in ESR, Development, or Nightly.\nYou may also use an Unbranded Build: [https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds](https://wiki.mozilla.org/Add-ons/Extension_Signing#Unbranded_Builds)\n\n1.  Run `npm run build:firefox` then use `web-ext-artifacts/{name}-firefox-{version}.zip`.\n1.  Open `about:config` search for `xpinstall.signatures.required` and set to `false`.\n1.  Open `about:addons` and drag the zip file to the page or choose Install from File from the Settings wheel.\n\n# Contributing\n\nCurrently, the best way to contribute to this project is to give a 5-star rating on\n[Google](https://chromewebstore.google.com/detail/hls-video-downloader/mpmiiaolodhanoalpjncddpmnkbjicbo) or\n[Mozilla](https://addons.mozilla.org/addon/hls-video-downloader) and to star this project on GitHub.\n\nOther Web Extensions I have created and published:\n\n- [Link Extractor](https://github.com/cssnr/link-extractor)\n- [Open Links in New Tab](https://github.com/cssnr/open-links-in-new-tab)\n- [HLS Video Downloader](https://github.com/cssnr/hls-video-downloader)\n- [SMWC Web Extension](https://github.com/cssnr/smwc-web-extension)\n- [PlayDrift Extension](https://github.com/cssnr/playdrift-extension)\n- [ASN Plus](https://github.com/cssnr/asn-plus)\n- [Aviation Tools](https://github.com/cssnr/aviation-tools)\n- [Text Formatter](https://github.com/cssnr/text-formatter)\n\nFor a full list of current projects visit: [https://cssnr.github.io/](https://cssnr.github.io/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcssnr%2Fhls-video-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcssnr%2Fhls-video-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcssnr%2Fhls-video-downloader/lists"}