@distube/yt-dlp

中文文档
2.0.1发布于 2024/06/07MITTypeScriptCommonJS构建来源已验证近 30 天下载 3956

一个使用yt-dlp的DisTube可播放取取器插件.

中文使用文档
文档目录5 节
  1. 新 YtDlp Plugin( [YtDlp Plugin 选项])
  2. 环境变量
  3. 解决问题
  4. 安装失败( 状态代码: 403)
  5. 运行插件失败( 状态代码: 403)

npm peer dependency version npm GitHub Repo stars Discord

Buy Me a Coffee at ko-fi.com

@distube/yt-dlp (英语)

使用 DisTube 可播放提取器插件 yt- dlp (日语)

什么是可播放的提取器插件?

特性

所需经费

安装

npm install @distube/yt-dlp@latest

使用量

import { DisTube } from "distube";
import { YtDlpPlugin } from "@distube/yt-dlp";

const distube = new DisTube(client, {
  plugins: [new YtDlpPlugin({ update: true })],
});

文档

新 YtDlp Plugin( [YtDlp Plugin 选项])

创建 DisTube 的 ExtractorPlugin 举个例子.

  • YtDlpPluginOptions.update (单位:千美元)boolean: 默认为 true。当插件初始化时更新 yt-dlp 二进制.

YtDlpPlugin 应该是其中最后一个插件 plugins 阵列.

环境变量

  • YTDLP_DISABLE_DOWNLOAD: 设定为禁用下载yt-dlp 二进制.
  • YTDLP_URL: Yt- dlp 二进制下载的URL.
  • YTDLP_DIR: 下载yt-dlp 二进制的目录.
  • YTDLP_FILENAME: yt-dlp 二进制的文件名.

解决问题

安装失败( 状态代码: 403)

您的 IP 已被 GitHub 限制速率, 插件无法获得 yt- dlp 二进制的最新链接 . 您可以使用环境变量更改下载链接 YTDLP_URL,或通过设置来禁用下载 YTDLP_DISABLE_DOWNLOAD 改为 true。 。 。 .

export YTDLP_URL=https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp
npm install @distube/yt-dlp@latest
export YTDLP_DISABLE_DOWNLOAD=true
npm install @distube/yt-dlp@latest

运行插件失败( 状态代码: 403)

插件无法在启动时下载 yt- dlp 二进制 。 与上案同为相. 您可以在启动时禁用下载 new YtDlpPlugin({ update: false }) 或使用以上溶液.

import { DisTube } from "distube";
const distube = new DisTube(client, {
  plugins: [new YtDlpPlugin({ update: false })],
});

版本与发布记录

@distube/yt-dlp 共发布 12 个版本,首次发布于 2022/01/27;过去 12 个月发布了 0 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.1latest2024/06/072 年前
2.0.02024/06/052 年前
1.1.32022/07/184 年前
1.1.2-12022/07/184 年前
1.1.22022/07/184 年前
1.1.12022/07/164 年前

关于 @distube/yt-dlp 的常见问题

@distube/yt-dlp 是什么?

一个使用yt-dlp的DisTube可播放取取器插件.

如何安装 @distube/yt-dlp?

在项目目录运行 npm install @distube/yt-dlp,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:distube(5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@distube/yt-dlp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@distube/yt-dlp 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@distube/yt-dlp 可以商用吗?

@distube/yt-dlp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@distube/yt-dlp 的下载量有多少?

根据 npm 官方下载统计,@distube/yt-dlp 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,956 次,日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@distube/yt-dlp 还在维护吗?

最新版本 2.0.1 发布于 2024/06/07(2 年前);至今共发布 12 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/01/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。