☰
Jellium Desktop 视频方向不对?用 mpv.conf 一行配置搞定旋转(附配置路径)
2026/10/23 8:37:53 网站建设 项目流程

Jellium Desktop 视频方向不对?用 mpv.conf 一行配置搞定旋转(附配置路径)

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

手机竖拍的视频在 Jellium Desktop 里横躺着播,按 R 键想转 90° 却没反应——因为 Jellium Desktop 目前没有内置视频旋转快捷键。别急着换播放器,往它的 mpv.conf 里加一行就能解决,本文给出配置路径和写法。

先搞清楚:Jellium 里为什么播放器快捷键失灵

Jellium Desktop 的播放内核是 mpv,UI 层则是一整套嵌在窗口里的网页界面(基于 CEF,即 Chromium Embedded Framework,把浏览器嵌进应用的技术)。启动时它把 mpv 的默认按键绑定整个关掉了,源码里这一行是关键:

set("input-default-bindings", "no")

所以 mpv 原生的r旋转、/缩放等按键全部失效,所有按键事件被转发给网页界面处理,再由它决定要不要交给 mpv。相关逻辑集中在 src/playback/src/hotkey.rs,目前只认得这几个键:

按键效果生效条件
F或F11切换全屏视频播放器处于激活状态;音乐播放时忽略
Alt+F4退出应用无条件

暂停状态的视频仍算"激活",F键照样可用。除此之外没有任何旋转相关的绑定,快捷键分类逻辑里HotkeyAction枚举一共只有None、Shutdown、ToggleFullscreen三个值。

配置目录在哪:设置界面一键直达

好消息是 Jellium 启动 mpv 时显式打开了配置加载:

set("config", "yes")

也就是说MPV_HOME下的mpv.conf一定会被读取(libmpv 默认不读配置,这一步是项目主动补的)。这个 home 目录就是应用配置目录下的mpv子目录,路径定义在mpv_home()里。

Linux 上的完整路径通常是:

~/.config/jellium-desktop/mpv/mpv.conf

不想翻路径的话,打开应用设置页,找到"Open mpv config directory"按钮点一下即可,入口实现在 src/jfn_rust/src/shell/settings.rs。

怎么写:固定旋转角度与自定义按键

在mpv.conf末尾追加对应行即可。常见需求两条命令都列出来,按需要取用:

  1. 固定旋转 90°(适合手机横拍竖存的视频)

    video-rotate=90

    video-rotate接受 0/90/180/270 四个值,改完重启应用或重开视频生效。

  2. 顺手绑一个旋转键,补齐"旋转快捷键"

    keybind r cycle video-rotate

    之后按r就在 0→90→180→270 之间循环切换,等于自己造了一个快捷键。

注意:这类配置在本地解码播放路径下才起作用。如果你把video-rotate写进全局mpv.conf,转码播放时它不会生效——因为转码流是服务器重新编码输出的,方向已在源头定死,本地旋转救不回来,这类情况只能重新上传媒体或在服务端修复元数据。

两个容易踩的坑

坑 1:只配了mpv.conf却没生效。先确认走的是直接播放而不是转码;再确认写的是MPV_HOME(即应用配置目录下的mpv),而不是系统里别的 mpv 配置位置。Jellium 通过环境变量MPV_HOME指定它,位置见 src/jfn_rust/src/app.rs 的setup_mpv_environment。

坑 2:想要"每次 90° 递增"却写成video-rotate=90。video-rotate是固定值属性,递增效果要用上面的keybind r cycle video-rotate,两者写法不同,别混用。

另外提醒一点:video-rotate只改画面呈现角度,不会改窗口或视频窗口的宽高,旋转后画面按 4:3 区域摆放属正常现象,可配合pan-scan等选项微调,但那是 mpv 通用话题,本文不展开。

小结

Jellium Desktop 没有旋转快捷键,但它的 mpv 配置通道是敞开的:找到配置目录(设置页有按钮)、加一行video-rotate或keybind、重启应用,方向问题三步解决。如果后续版本在 hotkey.rs 里新增了旋转动作,届时原生按键就能直接用了。

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询