Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hyugogirubato/AsyncFFmpegHelper
Helper for FFmpeg allowing multi-threaded downloading of M3U8 video streams
https://github.com/hyugogirubato/AsyncFFmpegHelper
async asyncio download encryption ffmpeg helper hls m3u8 thread
Last synced: about 2 months ago
JSON representation
Helper for FFmpeg allowing multi-threaded downloading of M3U8 video streams
- Host: GitHub
- URL: https://github.com/hyugogirubato/AsyncFFmpegHelper
- Owner: hyugogirubato
- License: apache-2.0
- Archived: true
- Created: 2022-02-19T16:53:11.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-02-20T18:05:33.000Z (almost 3 years ago)
- Last Synced: 2024-08-05T09:15:32.663Z (5 months ago)
- Topics: async, asyncio, download, encryption, ffmpeg, helper, hls, m3u8, thread
- Language: Python
- Homepage:
- Size: 415 KB
- Stars: 11
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AsyncFFmpegHelper [](https://github.com/hyugogirubato/AsyncFFmpegHelper/releases)
## Description
FFmpeg helper to download HLS streams faster in asynchronous mode.
## Features
- Download an HLS stream 7 times faster
- Resume download possible
- Support for ffmpeg arguments
- Choosing the location of the temporary folder
- Better audio stream selection than ffmpeg
- Best selection of video quality according to resolution
- Simplified video resolution extraction available
## List of arguments
| Argument | Description |
| :------------------ | :------------------------------------------- |
| `-h`, `--help` | Show help menu |
| `-v`, `--version` | Show script version |
| `-p`, `--path` | Location of temporary files |
| `-i`, `--id` | Process ID |
| `-u`, `--url` | Link of master m3u8 file |
| `-e`, `--extract` | Get available video resolution |
| `-d`, `--download` | Download ID |
| `-t`, `--tasks` | Number of simultaneous downloads |
| `-f`, `--ffmpeg` | FFmpeg arguments |
| `-o`, `--output` | Output file path |
| `-l`, `--log` | Show process details |
| `-s`, `--skip` | Do not download if the video already exists |
| `-c`, `--clear` | Clean up all temporary files |
## Installation
````bash
pip install -r "requirements.txt"
````
## Use
Extract
Allows you to display the available video resolutions as well as the associated download ids.
````bash
main.py --id "PROCESS_ID" --url "URL" --extract
````
| Argument | Type | Description |
| :----------------- | :-------- | :-------------------------------------------- |
| `-p`, `--path` | `string` | Location of temporary files |
| `-i`, `--id` | `string` | **Required**. Process ID |
| `-u`, `--url` | `string` | **Required**. Link of master m3u8 file |
| `-e`, `--extract` | `/` | **Required**. Get available video resolution |
| `-t`, `--tasks` | `int` | Number of simultaneous downloads |
| `-l`, `--log` | `/` | Show process details |
Download
Download an HLS stream based on the id associated with the resolution.
````bash
main.py --id "PROCESS_ID" --url "URL" --download "ID" --tasks "TASKS" --ffmpeg="FFMPEG_ARGS" --output "OUTPUT" --skip
````
| Argument | Type | Description |
| :------------------ | :-------- | :-------------------------------------------- |
| `-p`, `--path` | `string` | Location of temporary files |
| `-i`, `--id` | `string` | **Required**. Process ID |
| `-u`, `--url` | `string` | **Required**. Link of master m3u8 file |
| `-e`, `--download` | `int` | **Required**. Get available video resolution |
| `-t`, `--tasks` | `int` | Number of simultaneous downloads |
| `-f`, `--ffmpeg` | `string` | FFmpeg arguments |
| `-o`, `--output` | `string` | **Required**. Output file path |
| `-s`, `--skip` | `/` | Do not download if the video already exists |
| `-l`, `--log` | `/` | Show process details |
NOTE: The ffmpeg arguments must not contain the input video stream and the location of the output file.
Clear
Delete the temporary directory and all the files it contains.
````bash
main.py --clear
````
| Argument | Type | Description |
| :--------------- | :-------- | :------------------------------------------ |
| `-p`, `--path` | `string` | Location of temporary files |
| `-c`, `--clear` | `/` | **Required**. Clean up all temporary files |
Version
Displays the script version.
````bash
main.py --version
````
| Argument | Type | Description |
| :----------------- | :---- | :--------------------------------- |
| `-v`, `--version` | `/` | **Required**. Show script version |
---
*This script was created by the __Nashi Team__.
Find us on [discord](https://discord.com/invite/g6JzYbh) for more information on projects in development.*