Jellium Desktop命令行参数解释：每个选项的详细说明

Jellium Desktop命令行参数解释：每个选项的详细说明

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

Jellium Desktop是一款非官方的Jellyfin桌面客户端，提供丰富的命令行参数来定制应用的启动行为和功能配置。本文将详细介绍所有可用的命令行选项，帮助用户根据需求优化使用体验。

基础信息选项

--version/-v

• 功能：打印版本信息并退出
• 使用示例：jellium-desktop --version
• 说明：显示Jellium Desktop版本、CEF版本以及MPV和FFmpeg的版本信息，便于确认当前安装的软件版本是否为最新。

日志与调试选项

--log-level

• 功能：设置日志过滤级别
• 环境变量：JELLIUM_DESKTOP_LOG_LEVEL
• 使用示例：jellium-desktop --log-level debug
• 说明：控制日志输出的详细程度，支持的值包括info（默认）、debug、warn、error等，也可针对特定模块设置，如debug,mpv=trace,CEF=off。

--log-file

• 功能：指定日志输出文件
• 环境变量：JELLIUM_DESKTOP_LOG_FILE
• 使用示例：jellium-desktop --log-file /tmp/jellium.log
• 说明：将日志写入指定文件，使用空字符串''可禁用日志文件输出。

--remote-debug-port

• 功能：启用Chrome远程调试端口
• 使用示例：jellium-desktop --remote-debug-port 9222
• 说明：允许通过指定端口（如9222）使用Chrome开发者工具调试应用，方便开发和问题诊断。

路径配置选项

--config-dir

• 功能：覆盖应用配置目录
• 环境变量：JELLIUM_DESKTOP_CONFIG_DIR
• 使用示例：jellium-desktop --config-dir /path/to/custom/config
• 说明：指定自定义的配置文件存储路径，默认使用系统标准位置。

--cache-dir

• 功能：覆盖CEF缓存目录
• 环境变量：JELLIUM_DESKTOP_CACHE_DIR
• 使用示例：jellium-desktop --cache-dir /path/to/custom/cache
• 说明：指定CEF（Chromium Embedded Framework）的缓存文件存储路径。

媒体播放选项

--hwdec

• 功能：设置硬件解码模式
• 使用示例：jellium-desktop --hwdec vaapi
• 说明：指定硬件加速解码方式，默认值为no（禁用硬件解码），支持的值包括vaapi、vdpau、dxva2等，具体取决于系统支持。

--audio-passthrough

• 功能：设置音频直通编码格式
• 使用示例：jellium-desktop --audio-passthrough ac3,dts-hd,eac3
• 说明：指定需要直通输出的音频编码格式，多个格式用逗号分隔，如ac3,dts-hd,eac3,truehd。

--audio-exclusive

• 功能：启用独占音频输出
• 使用示例：jellium-desktop --audio-exclusive
• 说明：启用后将独占音频设备，减少音频延迟并提高音质，适用于家庭影院等场景。

--audio-channels

• 功能：设置音频声道布局
• 使用示例：jellium-desktop --audio-channels 5.1
• 说明：指定音频输出的声道布局，如stereo（立体声）、5.1（5.1声道）、7.1（7.1声道）等。

高级选项

--disable-gpu-compositing

• 功能：禁用CEF GPU合成
• 使用示例：jellium-desktop --disable-gpu-compositing
• 说明：强制禁用GPU加速合成，适用于在某些图形驱动存在兼容性问题时使用。

Linux特定选项

在Linux系统上，Jellium Desktop还提供以下额外选项：

• --platform：指定显示平台（如x11或wayland）
• --platform-paint：设置绘制后端（如shm或gpu）
• --wid：指定窗口ID，用于嵌入到其他窗口中

这些选项可通过源码src/linux_util/src/cli.rs查看详细定义和使用方法。

参数优先级说明

命令行参数的优先级高于环境变量，当同时设置环境变量和命令行参数时，将以命令行参数为准。例如：

JELLIUM_DESKTOP_LOG_LEVEL=debug jellium-desktop --log-level info

此时日志级别将被设置为info而非环境变量中的debug。

总结

Jellium Desktop提供了丰富的命令行参数，允许用户根据自身需求定制应用的行为，从基础的版本查询到高级的硬件加速配置。合理使用这些参数可以优化媒体播放体验，解决特定场景下的问题。如果需要查看所有可用选项，可使用jellium-desktop --help命令获取完整帮助信息。

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