Instalación

Requisitos Previos

Asegúrate de tener esto instalado antes de continuar:

Requisito	Comando de Instalación (Arch Linux)	Notas
Hyprland	sudo pacman -S hyprland	Se requiere una instancia de Hyprland en ejecución
JetBrains Nerd Font	sudo pacman -S ttf-jetbrains-mono-nerd	Necesario para la renderización de iconos
Python 3.12+	sudo pacman -S python	Verificar: python --version
Git	sudo pacman -S git	Requerido para clonar
NetworkManager	sudo pacman -S networkmanager	Requerido por los widgets de red
PipeWire	sudo pacman -S pipewire pipewire-pulse	Requerido por los widgets de audio

Precaución

Necesitas una instalación funcional de Hyprland antes de instalar Tsumiki. Si eres nuevo en Hyprland, sigue primero la Wiki de Hyprland.

Clonar

git clone https://github.com/rubiin/tsumiki.git ~/.config/tsumiki
cd ~/.config/tsumiki

Última Versión

Versión:v4.8.4Fecha:2026-09-28

Para notas de versión completas y activos, consulta la página de versiones en GitHub.

Opciones de Instalación

Elige uno de los siguientes tres métodos.

Opción 1: Script Bootstrap (Más Rápido)

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

Este script clona o actualiza ~/.config/tsumiki, luego ejecuta la configuración completa.

Para instalar e iniciar inmediatamente:

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

Opción 2: Configuración Automatizada en Clon Existente

Si ya clonaste el repositorio manualmente, ejecuta el script de configuración:

./tsumiki.sh -setup
./tsumiki.sh -start

La bandera -setup instala los paquetes de sistema necesarios y configura el entorno virtual de Python.

Opción 3: Configuración Manual de Dependencias

¿Prefieres control total sobre los paquetes? Instala las dependencias tú mismo y luego inicia:

# Instalar paquetes del sistema
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 uv \
  libnotify cliphist libqalculate satty nvtop

# Instalar paquetes AUR (usando yay como ejemplo)
yay -S --needed \
  fabric-cli-git gnome-bluetooth-3.0 \
  slurp imagemagick tesseract tesseract-data-eng \
  ttf-jetbrains-mono-nerd grimblast-git matugen-bin cinnamon-desktop

# Instalar dependencias Python
uv sync

# Iniciar
./tsumiki.sh -start

Si no usas yay, instala los paquetes AUR con tu asistente AUR preferido.

Configuración de Inicio Automático

Añade esta línea a tu ~/.config/hypr/hyprland.conf para lanzar Tsumiki automáticamente cuando Hyprland se inicie:

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

El sleep 5 asegura que Hyprland esté completamente inicializado antes de que Tsumiki se lance. Ajusta la ruta si clonaste en una ubicación diferente.

Consejo

Puedes crear un alias de shell por conveniencia:

alias tsumiki='~/.config/tsumiki/tsumiki.sh -start'

Verificar la Instalación

1. Ejecuta ./tsumiki.sh -start desde el directorio del proyecto.
2. La barra de Tsumiki debería aparecer en la parte superior de tu pantalla.
3. Si ves mensajes de error, verifica que:
   • Todos los paquetes del sistema estén instalados (./tsumiki.sh -setup vuelve a ejecutar esta verificación)
   • Las dependencias de Python estén instaladas (uv sync)
   • Estés ejecutando Hyprland (no otro compositor o X11)

Si la barra no aparece, consulta Solución de Problemas.

Después de la Instalación

Continúa con Post Instalación para las reglas de capa de Hyprland y Primeros Pasos para configurar tu panel.

Consejo

Las contribuciones a la documentación y scripts de instalación son bienvenidas: Tsumiki en GitHub