| name | m3u8-media-downloader |
| description | Use @lzwme/m3u8-dl for media download and video info parsing. Use when the user mentions video/music download (m3u8/HLS/mp4/mp3 or 抖音/皮皮虾/微博视频), or 获取视频信息、解析视频链接, and a video/music URL is present. |
| version | 1.9.0 |
| author | renxia (https://lzw.me) |
| license | MIT |
| repository | https://github.com/lzwme/m3u8-dl |
| metadata | {"openclaw":{"emoji":"🎞️","requires":{"bins":["m3u8dl","ffmpeg"]},"install":[{"id":"node","kind":"node","formula":"@lzwme/m3u8-dl@1.9.0","bins":["m3u8dl"],"label":"Install m3u8-downloader CLI (node)"}]}} |
m3u8-downloader
Download m3u8/mp4 video and mp3/music, support 抖音、皮皮虾、微博 sharing links. Multi-thread download, WebUI, batch and Node API.
Example:
使用 m3u8-media-downloader 下载抖音视频/获取该视频详情：https://v.douyin.com/CW1iv0GeSJM/
Main capabilities
- m3u8/HLS & mp4 — download and merge to mp4 (ffmpeg required for ts→mp4)
- Music — mp3/m4a from m3u8/stream sources
- 抖音/皮皮虾/微博 — parse or download sharing links
CLI
m3u8dl <urls...> [options]
m3u8dl info <url>
m3u8dl server
Key options
| Option | Description |
|---|
-f, --filename <name> | Output filename |
-n, --thread-num <n> | Download threads (default: 4) |
-S, --save-dir <dir> | Save directory |
-T, --type <type> | m3u8 (default) | parser | web |
-H, --headers <json> | Custom request headers |
--ffmpeg-path <path> | ffmpeg path (for mp4 conversion) |
Quick examples
m3u8dl https://example.com/video.m3u8 -f "My Video" -S ./downloads
m3u8dl "https://v.douyin.com/xxxxx/" --type parser
m3u8dl info "https://h5.pipix.com/xxxxx"
m3u8dl "Episode 1|https://example.com/ep1.m3u8"
m3u8dl series-list.txt -f "Series Name"
m3u8dl "https://example.com/play/123" --type web
WebUI
m3u8dl server [-P <port>] [-t <token>]
Open http://localhost:6600 to manage tasks in browser.
Security Considerations
⚠️ Important Security Notice
- Version Pinning: This skill uses pinned version
@1.9.0 to prevent execution of different code on each run
- Code Review: Inspect the package via
npm view @lzwme/m3u8-dl@1.9.0 or GitHub before execution
- Sandbox Environment: Run download tasks in an isolated environment with restricted filesystem permissions
- ffmpeg Installation: Ensure ffmpeg is installed from official or trusted sources only
- Sensitive Variables:
DS_SECRET is sensitive - configure carefully to protect WebUI access
- Legal Compliance: Ensure downloads comply with local laws and source site terms of service
Node API
import { m3u8Download, VideoParser, m3u8BatchDownload } from '@lzwme/m3u8-dl';
await m3u8Download(url, { filename: 'video', saveDir: './downloads' });
const parser = new VideoParser();
const info = await parser.parse('https://v.douyin.com/xxxxx/');
await parser.download(info, { saveDir: './downloads' });
await m3u8BatchDownload(['name1$url1', 'name2$url2'], { saveDir: './downloads' });
Scenario guide
| Scenario | CLI | Node API |
|---|
| m3u8/mp4 URL | m3u8dl <url> | m3u8Download(url) |
| 抖音/皮皮虾/微博 | --type parser or info <url> | VideoParser.parse() |
| Web page with m3u8 | --type web | getM3u8Urls() |
| Batch download | "name|url" or file | m3u8BatchDownload() |
| mp4 conversion | Requires ffmpeg | Set ffmpegPath |
LINKS
