10 个版本 (6 个破坏性版本)
0.7.1 | 2024 年 3 月 10 日 |
---|---|
0.7.0 | 2023 年 9 月 18 日 |
0.6.0 | 2023 年 7 月 5 日 |
0.5.0 | 2023 年 3 月 13 日 |
0.1.0 | 2022 年 8 月 1 日 |
#185 in Unix API
每月 1,496 次下载
47KB
940 行
blight
"人 said,'let there b-light' and there was light." - Some Book 1:3
主要是一个无烦恼的 CLI 工具,用于管理 Linux 上的背光;一个与混合 GPU 配置和专有驱动程序兼容的工具。
blight 依赖的部分也可以通过此包的库方面进行访问,可以像其他 Rust 库一样使用,通过在 Rust 项目中使用命令 cargo add blight
。另一方面,CLI 工具可以通过运行 cargo install blight
来安装。
注意 此页包含 CLI 的文档。有关库文档,请访问 docs.rs。
警告 为了在没有 root 权限的情况下运行此程序,用户需要属于视频组,可能需要 udev 规则才能允许写入亮度文件。更多信息请参阅 这里。您可以通过运行 blight 附件中的辅助脚本来获得所需的权限,通过运行
sudo blight setup
一次或手动操作。否则,您必须每次都使用sudo
来运行程序。
屏幕截图
关于
许多Linux背光实用程序往往无法检测到笔记本电脑中正确的背光设备,这些笔记本电脑配备英特尔或AMD集成显卡,以及带有专用驱动程序的Nvidia dGPU。该实用程序通过优先考虑集成显卡,然后是专用Nvidia GPU和ACPI内核模块来解决此问题。这意味着您在切换到iGPU和dGPU时,无需手动指定当前激活的设备。除此之外,blight还实现了sweep
功能,允许您以平滑的扫过方式改变亮度,而不是应用突然的颠簸增减。
原则上,blight应在任何GNU/Linux发行版上运行,甚至在没有混合GPU配置的系统上也能运行。然而,迄今为止它只在Arch和Debian上进行了测试。任何反馈和错误报告都将受到高度重视。
用法
使用您的发行版设置设置自定义快捷方式,或者与sxhkd等热键守护进程配对,然后您就可以使用了。blight如果另一个实例正在运行,则不会执行任何代码,因此无需担心触发它的键被垃圾邮件发送。
命令
- 显示帮助
blight
(快速帮助)或blight help
- 显示状态
blight status
或blight status -d device_name
- 运行首次设置脚本(对于写入权限)
sudo blight setup
- 列出所有背光设备
blight list
- 增加亮度
blight inc 5
(增加5%) - 降低亮度
blight dec 10
(降低10%) - 平滑增加/降低亮度
blight inc 10 -s
或blight dec 10 --sweep
- 设置自定义亮度值
blight set 50
- 为特定设备增加亮度
blight inc 2 -d nvidia_0
- 保存亮度
blight save
或blight save -d amdgpu_bl0
- 恢复亮度
blight restore
安装
使用Cargo
cargo安装blight
- 二进制文件将被编译到
$HOME:.cargo/bin
从源码编译
- 克隆仓库
cdcloned-repo
cargo构建 -r
贡献
对我来说,编码是一种爱好,我对Rust和整体编程都还是新手。所以如果你在代码中注意到任何可以改进的地方,请开一个issue来发表你的意见和提出建议。如果你想直接改进代码,请发起一个pull-request,我很乐意合作并共同努力改进这一点。干杯!
依赖关系
~2–12MB
~109K SLoC