快速开始

Tsumiki 是基于 Fabric 组件系统构建的 Hyprland 模块化状态栏。

前提条件

开始之前，请确保您已具备：

• Hyprland — 一个可正常运行的 Hyprland 安装
• JetBrains Nerd Font — sudo pacman -S ttf-jetbrains-mono-nerd
• Python 3.12+ — python --version 应显示 3.12 或更高版本

快速安装

git clone https://github.com/rubiin/tsumiki.git ~/.config/tsumiki
cd ~/.config/tsumiki
./init.sh -setup
./init.sh -start

-setup 标志会安装所有必需的系统包和 Python 依赖。安装过程中可能会提示您输入密码。

如需其他安装方法（引导脚本、手动设置），请参阅完整安装指南。

自动启动

将这一行添加到 ~/.config/hypr/hyprland.conf：

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

最小配置

以下是一个可以快速上手的极简 config.toml：

"$schema" = "./tsumiki.schema.json"

[general]
debug = false
auto_restart = true

[layout]
left_section = ["workspaces", "window_title"]
middle_section = ["date_time"]
right_section = ["volume", "battery", "system_tray"]

[modules.bar]
layer = "top"
location = "top"

[widgets.workspaces]
count = 10
hide_unoccupied = true

[widgets.volume]
tooltip = true

[widgets.battery]
tooltip = true

保存后，重启状态栏：

pkill tsumiki
./init.sh -start

下一步

配置布局、测试组件并打造属于您的风格。
阅读指南 → 了解每个组件、模块和选项。
阅读文档 → 添加 Hyprland 层规则以实现模糊和弹出效果。
查看规则 → 常见问题和故障排除建议。
获取帮助 →