跳转到内容
Tsumiki

安装


前提条件

Section titled “前提条件”

在继续之前，请确保已安装以下内容：

要求 安装命令（Arch Linux） 说明
Hyprland sudo pacman -S hyprland 需要正在运行的 Hyprland 实例
JetBrains Nerd Font sudo pacman -S ttf-jetbrains-mono-nerd 图标渲染所需
Python 3.12+ sudo pacman -S python 验证：python --version
Git sudo pacman -S git 克隆所需
NetworkManager sudo pacman -S networkmanager 网络组件所需
PipeWire sudo pacman -S pipewire pipewire-pulse 音频组件所需

克隆

Section titled “克隆”
Terminal window
git clone https://github.com/rubiin/tsumiki.git ~/.config/tsumiki
cd ~/.config/tsumiki

最新版本

Section titled “最新版本”
版本：v4.0.2日期：2026-08-07

如需完整的发布说明和资源，请参阅 GitHub 上的发布页面。

安装选项

Section titled “安装选项”

选择以下三种方法之一。

选项 1：引导脚本（最快）

Section titled “选项 1：引导脚本（最快）”
Terminal window
curl -fsSL https://raw.githubusercontent.com/rubiin/tsumiki/master/install.sh | bash

此脚本会克隆或更新 ~/.config/tsumiki，然后运行完整设置。

要立即安装并启动：

Terminal window
curl -fsSL https://raw.githubusercontent.com/rubiin/tsumiki/master/install.sh | bash -s -- --start

选项 2：在现有克隆中自动设置

Section titled “选项 2：在现有克隆中自动设置”

如果您已手动克隆了仓库，请运行设置脚本：

Terminal window
./init.sh -setup
./init.sh -start

-setup 标志会安装所需的系统包并配置 Python 虚拟环境。

选项 3：手动依赖项设置

Section titled “选项 3：手动依赖项设置”

更喜欢完全控制软件包？自行安装依赖项，然后启动：

Terminal window
# 安装系统包
sudo pacman -S --noconfirm --needed \
  pipewire playerctl dart-sass power-profiles-daemon networkmanager \
  brightnessctl pkgconf wf-recorder kitty python pacman-contrib \
  gtk3 cairo gtk-layer-shell libgirepository noto-fonts-emoji \
  gobject-introspection gobject-introspection-runtime python-pip \
  python-gobject python-psutil python-cairo python-loguru libnotify \
  cliphist libqalculate python-httpx satty nvtop


# 安装 AUR 包（以 yay 为例）
yay -S --needed \
  python-fabric-git gnome-bluetooth-3.0 python-rlottie-python \
  python-pytomlpp slurp imagemagick tesseract tesseract-data-eng \
  ttf-jetbrains-mono-nerd grimblast-git python-ijson


# 安装 Python 依赖
pip install -r requirements.txt


# 启动
./init.sh -start

如果您不使用 yay，请使用您首选的 AUR 助手安装 AUR 包。

自动启动配置

Section titled “自动启动配置”

将此行添加到您的 ~/.config/hypr/hyprland.conf，以便在 Hyprland 启动时自动启动 Tsumiki：

Terminal window
exec-once = sleep 5; ~/.config/tsumiki/init.sh -start

sleep 5 确保 Hyprland 在 Tsumiki 启动前完全初始化。如果您克隆到其他位置，请调整路径。

验证安装

Section titled “验证安装”
  1. 从项目目录运行 ./init.sh -start。
  2. Tsumiki 状态栏应出现在屏幕顶部。
  3. 如果您看到错误消息，请检查：
    • 所有系统包都已安装（./init.sh -setup 重新运行此检查）
    • Python 依赖项已安装（pip install -r requirements.txt）
    • 您在 Hyprland 下运行（而不是其他合成器或 X11）

如果状态栏未出现，请参阅故障排除。

安装后

Section titled “安装后”

继续阅读安装后了解 Hyprland 层规则，以及第一步配置您的面板。