如何10分钟上手scripts:Linux脚本合集安装、依赖配置与目录结构入门教程

原创2026-10-26 19:26:541,754 阅读

如何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 还能一键把图片送进 GIMP
  • pywal: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 个最值得先跑起来的脚本

  1. stats 系统体检 —— shell/stats 一条命令输出 CPU 占用、GPU 温度、内存、风扇转速、磁盘剩余空间,适合终端常驻轮询。

  2. record 录屏录音开关 —— audio-video/record 用 /tmp/recpid 存进程号实现"再按一次即停止"的 toggle 逻辑(见 record),是很好的脚本模板。

  3. notes dmenu 笔记管理器 —— shortcuts-menus/notes 按修改时间排序列出 ~/notes/ 下的 Markdown,选 New 即可新建,适合绑一个快捷键。

  4. define 划词查词 —— shortcuts-menus/define 读取选中文本,调用词典 API 并以通知形式展示前 3 条释义,配合剪贴板历史使用体验极佳。

  5. 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 个脚本软链 → 装依赖 → 绑快捷键,剩下的用到哪个看哪个。

登录后查看全文
scripts