Jellium Desktop 视频方向与画面调整指南：全屏快捷键、比例设置与变通方法-育师

Jellium Desktop 视频方向与画面调整指南：全屏快捷键、比例设置与变通方法

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

Jellium Desktop 是一款非官方的 Jellyfin 桌面客户端，用 CEF 内嵌浏览器加载网页端界面、用 mpv 负责实际解码渲染。播放竖屏误拍、横竖颠倒的视频时，很多用户第一反应是找"旋转快捷键"。本文先说清这个功能的真实现状，再给出当前版本里真正可用的几种画面调整手段。

📌 直接说明现状：翻遍快捷键判定逻辑，当前版本没有为视频旋转（顺时针/逆时针 90°）绑定任何按键。

快捷键分类器 hotkey.rs 是一个纯分类器：输入分发器把按键事件交给它，它只返回"执行什么动作"。整个文件里定义的动作只有两个——

也就是说，想在播放中一键旋转画面，目前做不到。这不是设置里藏起来的开关，而是功能本身还不存在。下面几节解决"方向不对时现在怎么办"以及"哪些快捷键确实可用"。

虽然旋转没有着落，但播放中最常用的两个操作是有绑定的，且在代码里有明确的行为边界：

按键	作用	生效条件
`F`或`F11`	切换全屏	视频播放器处于激活状态（正在播放或暂停均可）
`Alt`+`F4`	关闭应用	任意时刻

两个容易踩的坑：

F键只对视频生效。分类器在响应前先检查"视频是否活跃"（媒体类型为视频、播放器已加载、且不在已停止状态）。听音乐时按F没有任何反应，这是刻意设计，不是失灵。
mpv 自带的全套快捷键在这里被禁用了。启动配置 boot.rs 里显式关闭了input-default-bindings、input-vo-keyboard等输入项，所有按键统一经 CEF 路由。所以你在 mpv 独立运行时习惯的那些按键（比如方向键调速之外的其他绑定）在 Jellium Desktop 里不会生效。

如果"方向不对"更多表现为画面比例怪异、上下留黑边过大，可以用播放器设置里的画面比例（Aspect Ratio）选项。mpv-video-player.js 声明客户端支持SetAspectRatio能力，提供三种模式：

进入播放界面，打开播放器菜单里的"播放设置 / 画面比例"。
在自动（auto）/ 充满（cover）/ 填充（fill）中选择：
- auto：保持宽高比，正常留边显示；
- cover：等比放大裁剪到充满画面（对应 mpv 的panscan模式）；
- fill：直接拉伸铺满，不保持宽高比。
选择会写入应用设置并即时生效，下次播放沿用上一次的选择。

这一路径的底层实现在 api.rs 的 aspect-mode 辅助函数：把三种模式翻译成keepaspect与panscan两个 mpv 属性。注意fill会拉伸变形，只适合临时看，不适合当默认值。

局限要说清：比例设置只改变画面的缩放方式，无法纠正 90°/180° 的旋转。

大多数"视频方向不对"的根源是文件里嵌了旋转元数据（手机竖拍时相机写入的 rotation 标记），播放端只是"忠实执行"了这个标记。当前客户端没有提供覆盖这个标记的开关，所以彻底的修法是在文件层面处理：

用 FFmpeg 之类工具重封装，把旋转"烘焙"进像素（例如ffmpeg -i in.mp4 -c copy -metadata:s:v:0 rotate=0 out.mp4，或加transpose滤镜重编码）；
修好后把文件放回 Jellyfin 媒体库，Jellium Desktop 里再播放就是正方向。