Skip to content
op200 edited this page Nov 7, 2025 · 11 revisions

入门

可以使用 pip 安装或直接下载编译好的exe,双击执行exe,或者用命令行传参执行

建议使用 pip 安装:

  1. 安装新版 Python
  2. 用 pip 安装 easyrip pip install -U easyrip
# 用 pip 安装好了的话,命令行运行 easyrip 即可启动
# 使用 exe 的话,双击运行 exe,键入 'help'
Easy Rip command>help
# 这样可以输出帮助文档

# 直接用命令行传参
>easyrip help
# 这样可以输出帮助文档并在输出后进入 'Easy Rip command>' 状态

# 如果想修改源码并调试,用 python 执行 py 文件
>python easyrip.py help

也可以用 python import easyrip,直接调用里面的函数,这里就不演示 py 代码了

查看文档

# 查看全部文档
Easy Rip command>help

# 查看指定命令或选项的文档
Easy Rip command>help -i  # 查看 -i 的文档
Easy Rip command>help -p x265slow  # 查看 -p 的 x265slow 的参数

压制语法

每次执行一次参数设定,都会往队列里塞入,最后统一按次序执行

看一段演示命令:

# 设定参数
Easy Rip command>-i "C:\你的视频.mp4" -o 这是输出的文件名前缀 -preset x264slow -sub "E:\字幕文件夹\你的字幕.ass" -crf 11.4 -deblock -5,1.4
Easy Rip command>run exit

# 相当于
>easyrip -i "C:\你的视频.mp4" -o 这是输出的文件名前缀 -preset x264slow -sub "E:\字幕文件夹\你的字幕.ass" -crf 11.4 -deblock -5,1.4 -run exit

这个代码的意思是:

  • -i 输入视频
  • -o 设置输出的文件名前缀
  • -preset 预设为 x264slow,它是一个用 x264 编码器编码视频的预设,具体有哪些预设可以在 help 中看到
  • -sub 使用 libass 滤镜内嵌字幕
  • -crf 覆写预设中 x264 的 crf 参数为 11.4
  • -deblock 覆写预设中 x264 的 deblock 参数为 -5,1.4
  • -run exit 依次执行队列中所有的压制,exit 意为在压完后退出程序

再来看一段:

# 使用 x265-快速 预设,启用内嵌模式,重混为 mp4 封装,封装帧率改为 24000/1001 fps
Easy Rip command>-i "C:\你的视频1.mkv" -o "video 1" -preset x265fast -sub "E:\字幕文件夹\你的字幕.ass" -muxer mp4 -r 24000/1001

# 使用 x265-较慢 预设,启用自动内嵌模式,复制音频轨,重混为 mkv 封装,封装帧率改为 666 fps
# 注意这里的 -sub auto 会将同目录下的所有同前缀字幕依次作为输入
Easy Rip command>-i "C:\你的视频2.avi" -o "video 2" -preset x265slow -sub auto -c:a copy -muxer mkv -r 666

# 使用文件对话框选择输入的文件,使用 x265-满参 预设,覆写预设中的 x265 的 limit-tu 参数为 2,使用 libopus 将音频轨压为 opus 格式,音频码率为 160kbps
Easy Rip command>-i fd -preset x265full -limit-tu 2 -c:a libopus -b:a 160k

# 查看即将压制的队列
Easy Rip command>list

# 删除队列中的第四个压制
Easy Rip command>list del 4

# 运行队列中所有的压制
Easy Rip command>run

# 可以使用 -pipe 传入滤镜脚本,vpy 中使用 globals().get('input') 获取传入的路径名
Easy Rip command>-i fd -preset x265full -pipe "Z:\你的滤镜脚本.vpy"

# 可以直接把 vpy 作为输入
Easy Rip command>-i "V:\这是个vpy脚本.vpy" -preset x265full -o vpy输出视频文件名

# 支持相对路径和设置输出路径
Easy Rip command>-i "相对路径下的视频.mkv" -preset x265full -o 输出文件名 -o:dir "C:\输出目录"

# 支持调用 FFmpeg 的硬解 和 FFmpeg 内置的去隔行滤镜
Easy Rip command>-i video.mp4 -preset x265full -o 输出文件名 -hwaccel vulkan -deinterlacing 1

# 清空队列
Easy Rip command>list clear

# 退出程序
Easy Rip command>exit

内封字幕

子集化 ASS 和 字体文件 和自动混流功能

仅子集化

# -i 输入的是 ASS 文件,用 ? 分隔,-o 是输出目录
# -subset-font-dir 指定,同样可以用 ? 分隔以输入多个
Easy Rip command>-i 01.ass?02.ass -preset subset -o subset-folder -subset-font-dir my-font-dir?second-font-dir

# 可以启用在 Windows 注册表中搜索已安装字体
Easy Rip command>-i 01.ass -preset subset -o subset-folder -subset-font-dir my-font-dir -subset-use-win-font 1

# 还有一些其他功能,具体见 help
Easy Rip command>-i 01.ass -preset subset -o subset-folder -subset-font-dir my-font-dir -subset-use-libass-spec 1 -subset-drop-non-render 0 -subset-drop-unkow-data 0 -subset-strict 1

仅内封

# -only-mux-sub-path 指定字幕和字体所在文件夹
Easy Rip command>-i my-video.mp4 -preset copy -only-mux-sub-path subset-folder

自动子集化并内封

# 使用 -soft-sub 指定输入的字幕
Easy Rip command>-i 01.mp4 -preset copy -subset-font-dir my-font-dir -soft-sub 01.zh-Hans.ass?01.zh-Hant.ass

# 用 auto 关键字即可自动搜索前缀相同的 ASS (假设现在视频同目录下有 01.zh-Hans.ass 和 01.zh-Hant.ass)
# 文件名中缀使用的语言标签会自动翻译并写入轨道标题
Easy Rip command>-i 01.mp4 -preset x265fast2 -subset-font-dir my-font-dir -soft-sub auto

# auto:... 可以指定中缀
Easy Rip command>-i 01.mp4 -preset x265slow -subset-font-dir my-font-dir -soft-sub auto:zh-CN:en:ja

自定义语句

当然,支持自定义语句,可以用命令行调任何东西:

# 例如像这样把视频用 FFmpeg 解码推给 VVenC
Easy Rip command>-i testVideo.mkv -o testVideoOutput -preset custom -custom:format 'ffmpeg -i "{input}" -map {ffmap} -f yuv4mpegpipe - | vvenc -i - --y4m --preset {vvenc-preset} -o "{output}"' -custom:suffix 266 -ffmap 0:v:0 -vvenc-preset slower

Web serve

Easy Rip command>server 8000 123

这样可以在端口 8000 启动 Web 服务,密码设为 123(具体语法见 help)

启动服务后,在 Web Panel 中可以远程控制

Clone this wiki locally