如何10分钟上手scripts:Linux脚本合集安装、依赖配置与目录结构入门教程
如何10分钟上手scripts:Linux脚本合集安装、依赖配置与目录结构入门教程
scripts 是一个面向 Linux 桌面(尤其 Wayland/X11 极简桌面)的个人脚本合集,打包了状态栏监控、截图、壁纸切换、录屏、音频切换、笔记管理等 30 余个实用小工具。本教程带你快速完成 scripts 脚本合集的 clone、安装、依赖配置与目录结构认知,10 分钟即可把最趁手的几个脚本挂到快捷键上。
scripts 目录结构一览:先搞清楚每个文件夹装什么
整个仓库按用途划分为 5 个功能目录,浏览时按此定位最高效:
| 目录 | 功能定位 | 代表脚本 |
|---|---|---|
| images-photos-wallpapers/ | 图片、壁纸、截图 | screenshot、fzfub |
| statusbar/ | 状态栏/任务栏小组件 | systemstats、musicplaying |
| audio-video/ | 录音、录屏、音频设备 | record、audioswitch |
| shortcuts-menus/ | dmenu 快捷菜单 | notes、sys |
| shell/ | 终端增强工具 | stats、imv |
💡 作者也在 README.md 顶部声明了免责声明:脚本按作者环境编写,可能需要小改才能跑起来。阅读 README.md 是最快的入门方式。
一键安装 scripts 脚本合集:clone 与授权三步走
第 1 步:克隆仓库
git clone https://gitcode.com/gh_mirrors/scripts58/scripts
第 2 步:为脚本添加可执行权限
cd scripts
find . -type f -not -name "*.py" -exec chmod +x {} \;
第 3 步:创建软链接放入 PATH
mkdir -p ~/.local/bin
ln -s $(pwd)/shell/stats ~/.local/bin/stats
ln -s $(pwd)/audio-video/record ~/.local/bin/record
按需创建软链接即可,不必全量链接。确认 ~/.local/bin 在 PATH 中(echo $PATH 检查),之后终端里直接输入 stats 就能运行。
依赖配置指南:按目录安装对应软件包
scripts 合集本身无统一安装脚本,依赖由你挑选的脚本决定。下面按功能列出常见依赖的 Debian/Ubuntu 安装命令(Arch 用户可换成 pacman -S):
📊 状态栏类(statusbar//)
playerctl、mpd:musicplaying 用playerctl metadata轮询播放状态,并支持鼠标滚轮切换播放器、左键切换显示格式lm-sensors(提供sensors命令)、sysstat(提供iostat)、nvidia-smi:systemstats 采集 CPU/GPU 温度、风扇转速,超温还会变色告警jq、dysk:disks 的磁盘统计与展示
📸 图片截图类(images-photos-wallpapers//)
imagemagick(import/magick)、xclip、notify-send:screenshot 开头就做了依赖自检,缺失会明确报Missing: xxx,非常好排查xdotool:窗口截图模式需要fzf、ueberzugpp、nsxiv:fzfub 是带图片预览的 fzf 增强版,ctrl-e还能一键把图片送进 GIMPpywal:wallpapermenu 选图后用wal -i一键生成配色主题
🎬 音视频类(audio-video//)
ffmpeg:record 用x11grab录屏 +h264 -qp 0无损编码,同时用ffmpeg -f alsa录麦克风并做降噪jq:audioswitch 解析pactl -f json list sinks列出所有音频输出设备
🔍 通用依赖(多数脚本都需要)
dmenu(或 Wayland 下的wmenu):几乎全部菜单脚本的交互核心xclip/cliphist:剪贴板历史bat:shell/stats 的输出高亮
⚠️ 提示:部分脚本硬编码了
DISPLAY=:0或dwmblocks信号(如 record 中的pkill -RTMIN+3 dwmblocks),如果你不用 dwmblocks 做状态栏,需要删掉对应行。
5 个最值得先跑起来的脚本
-
stats系统体检 —— shell/stats 一条命令输出 CPU 占用、GPU 温度、内存、风扇转速、磁盘剩余空间,适合终端常驻轮询。 -
record录屏录音开关 —— audio-video/record 用/tmp/recpid存进程号实现"再按一次即停止"的 toggle 逻辑(见 record),是很好的脚本模板。 -
notesdmenu 笔记管理器 —— shortcuts-menus/notes 按修改时间排序列出~/notes/下的 Markdown,选New即可新建,适合绑一个快捷键。 -
define划词查词 —— shortcuts-menus/define 读取选中文本,调用词典 API 并以通知形式展示前 3 条释义,配合剪贴板历史使用体验极佳。 -
imv交互式批量改名 —— shell/imv 接收多个文件参数,输入新名称后自动加序号new1.png、new2.png,保留原扩展名。
常见问题 FAQ
Q:脚本运行报 Missing: xxx 或 command not found?
A:说明缺依赖,按上一节对照安装即可;screenshot 这类脚本会逐一检查并提示缺哪个命令。
Q:为什么状态栏脚本没有输出?
A:statusbar/ 下的脚本是为 dwmblocks 一类"每块输出到 stdout"的框架写的。单独运行时输出会打印到终端,配合定时任务(如 watch -n 5)也能用。
Q:如何只取用我需要的脚本?
A:每个脚本都独立成文件、无交叉导入(个别例外如 photomenu 依赖同目录的 fzfub 和 imgmgk),直接复制单个文件到 ~/.local/bin 即可,不必整体部署。
Q:脚本能改造吗? A:可以,这正是这类合集的价值——每个脚本都在 30~100 行以内,注释详尽。例如 shell/dimmer 仅 18 行就实现了多显示器亮度调节 + 夜间色温,是学习 xrandr 用法的好范本。
总结
scripts 脚本合集的价值在于"麻雀虽小五脏俱全":从 statusbar/systemstats 的温度监控到 audio-video/editrec 的 ffmpeg 剪辑,再到 images-photos-wallpapers/focusdetect.py 这种用拉普拉斯方差检测失焦照片的算法脚本,都是可以直接抄作业的小而美实现。建议路径:clone → 挑 2~3 个脚本软链 → 装依赖 → 绑快捷键,剩下的用到哪个看哪个。