El camino del color

Tu sistema es CachyOS, una distribución basada en Arch Linux y optimizada para tu procesador. Encima tienes estas piezas:

Los números son los de la fila de arriba del teclado. Los atajos de Irokai están marcados con una raya roja. Si se te olvida alguno, Super+H te los enseña todos con un buscador.

Lo esencial

Estética y fondos

Pantallas, sonido y animación

Ventanas

Escritorios

Utilidades de Noctalia

Tus fondos están en ~/Imágenes/Wallpapers, con una carpeta por categoría. Cada carpeta tiene su estética, y al poner un fondo cambia todo el escritorio a la vez:

• los colores (barra, terminal, apps, btop, cava);
• el degradado de los bordes, el redondeo y la separación entre ventanas;
• el tipo de animación;
• el símbolo y los colores del prompt;
• el dibujo de bienvenida de la terminal;
• el tema de Spotify.

Da igual cómo cambies el fondo: con Super+N, con el panel de Noctalia o con el comando fondo. En todos los casos la estética se aplica sola.

Añade cualquier fondo: se configura solo ✨

Pon cualquier imagen (o vídeo) y Irokai hace el resto. Lee sus colores, elige la estética que mejor le va (retro si es neón, sakura si es rosa, manga si es blanco y negro…) y lo viste todo a juego: barra, bordes, terminal, VS Code y Spotify.

fondo añadir ~/Descargas/mi-foto.jpg          # una imagen
fondo añadir ~/Descargas/mis-fondos/          # una carpeta entera
fondo añadir https://ejemplo.com/imagen.png   # desde un enlace
fondo añadir ~/Vídeos/lluvia.mp4              # un vídeo: se pone como fondo animado

También puedes copiar tus imágenes en la carpeta ~/Imágenes/Wallpapers/mios (Super+M → «Añadir mis fondos» la abre) y ponerlas con Super+N.

Fondos con comandos

fondo                      # selector con vista previa de todos los fondos
fondo anime                # uno al azar de la carpeta anime (y su estética)
fondo aleatorio            # uno al azar de cualquier carpeta
fondo siguiente            # el siguiente de la misma carpeta (también: anterior)
fondo categorias           # carpetas, cuántos fondos tiene cada una y su estética
fondo auto 30              # cambia solo cada 30 minutos («fondo auto no» lo desactiva)
fondo ~/Descargas/foto.jpg  # cualquier imagen tuya
fondo abrir                # abre la carpeta de fondos

Fondos animados 動

Los vídeos y GIF de ~/Imágenes/Wallpapers/animados se reproducen como fondo. Se pausan solos cuando juegas o ves algo a pantalla completa y se recuerdan al reiniciar.

También salen en el selector (mantén Super+N), en la categoría ANIMADOS. Se decodifican en la gráfica que dibuja el escritorio, así que no despiertan la NVIDIA.

animado                    # elegir uno (con vista previa)
animado siguiente          # o Super+Alt+W
animado parar              # o Super+Ctrl+W: vuelve a tu fondo fijo
animado ~/Vídeos/mio.mp4   # cualquier vídeo tuyo

Para conseguir más fondos animados, busca en motionbgs.com (sin marca de agua) y guarda los .mp4 en la carpeta animados. Son de sus autores: úsalos solo en tu escritorio, no los publiques ni los vendas.

Conseguir más fondos

Irokai trae sus fondos originales. Si quieres más, descárgalos tú con estos comandos: se guardan en su carpeta y toman su estética solos.

irokai fondos packs             # colecciones públicas de la comunidad que puedes descargar
irokai fondos descargar anime   # descarga un pack (sin nombre: todos)
irokai fondos buscar samurai    # busca fondos aptos para todos los públicos en Wallhaven
fondo añadir https://…/foto.jpg # cualquier imagen, carpeta o enlace

Derechos de autor: las imágenes descargadas son de sus autores y solo puedes usarlas como fondo personal. No las vendas ni las compartas como si fueran tuyas. Irokai no incluye ni distribuye esas imágenes: solo te ayuda a descargarlas.

Apps a juego (opcional)

Escribe irokai apps para ver qué tienes activado.

irokai vscode               # VS Code cómodo, con extensiones y colores de tu estética (añade «es» para español)
irokai spotify-tema activar # Spotify con los colores de cada fondo (Spicetify)
irokai discord activar      # Discord con los colores de cada fondo, en vivo (Vesktop)

Importante: los temas de Spotify y Discord los hace la comunidad y modifican esas aplicaciones, algo que sus condiciones de uso no permiten. Por eso no vienen activados: antes de activarlos se te avisa y tienes que escribir ACEPTO. La decisión es tuya, y se quitan con … desactivar. VS Code no modifica nada, solo cambia sus ajustes.

Estéticas con comandos

estilo                     # elegir (o Super+Y)
estilo retro               # pone un fondo de su carpeta y aplica la estética
estilo aplicar samurai     # aplica la estética sin cambiar el fondo
estilo auto no             # que los fondos NO cambien la estética
estilo nuevo vaporwave     # crea tu propia estética y su carpeta

Más fondos

irokai fondos packs           # packs disponibles (japon, sakura, anime, retro, animados…)
irokai fondos descargar japon # baja uno (sin nombre: todos)

Vienen de colecciones públicas de la comunidad (dharmx/walls, D3Ext/aesthetic-wallpapers). También vale wallhaven.cc con el filtro SFW. Las imágenes son de sus autores: úsalas solo para tu escritorio.

Todo lo de Irokai se maneja con un solo comando. Escribe irokai y pulsa Tab para ver las opciones.

También lo encuentras en el lanzador: pulsa Super+Espacio, escribe «Irokai» y verás el Menú, la Estética, Elegir fondo, Fondo aleatorio, Fondo animado, Pantallas, Atajos y la Guía.

Ajustes

Están en ~/.config/irokai/irokai.conf: la carpeta de fondos, si la estética cambia con cada fondo, los sonidos (nivel y volumen) y las animaciones. Los comandos los cambian por ti, pero también puedes editar el archivo a mano.

Pantallas

pantallas menu        # menú (o Super+Shift+F8)
pantallas externa     # solo el monitor externo (también: portatil, ambas, espejo)
pantallas izquierda   # el monitor externo a la izquierda del portátil (también: derecha, arriba, abajo)
pantallas estado

Los monitores siempre van a su frecuencia máxima. Si desconectas el monitor externo, el portátil se enciende solo y nunca te quedas sin pantalla. Super+F8 o la tecla de proyector van pasando por los modos.

Portátiles con dos gráficas

Si tu portátil tiene gráfica integrada y dedicada (NVIDIA, AMD o Intel Arc), Irokai decide al iniciar sesión cuál dibuja el escritorio. Regla: nunca se dibuja en una gráfica para mostrarse por la otra, porque eso obliga a la CPU a copiar cada fotograma.

irokai escritorio-gpu             # ver qué gráfica se usa y a cuál va cada pantalla
irokai escritorio-gpu auto        # por defecto: la dedicada si el monitor está conectado a ella
irokai escritorio-gpu integrada   # siempre la integrada (la dedicada solo para juegos)

Con el monitor conectado al puerto de la dedicada (muchas veces el USB-C o el DisplayPort), al iniciar sesión el escritorio pasa a ella y se apagan las pantallas de la integrada. Si no, todo va en la integrada y la dedicada duerme hasta que juegas. Si con la dedicada la sesión fallara dos veces, vuelve sola a la integrada. Cierra sesión antes de desconectar ese monitor.

Modos: juego, ahorro y luz nocturna

Widgets del escritorio que se mueven

Pulsa Super+Shift+E: aparece una rejilla. Arrastra con el ratón el reproductor de música, el visualizador o cualquier widget a donde quieras. Con el botón + añades más (reloj, tiempo, calendario…). Pulsa Hecho para guardar.

Ajustes · Super+I

Un menú con todo lo configurable: estética automática, colores por fondo, colores de Spotify, sonidos, animaciones, cambio automático de fondo, modos, luz nocturna y widgets. También puedes editar a mano ~/.config/irokai/irokai.conf.

Sonidos del escritorio

Animaciones

irokai animaciones rebote     # fija una (o Super+F10 para ir pasando)
irokai animaciones auto       # vuelve a la de cada estética

Con unos 15 comandos haces el 90 % de las cosas. El prompt te dice dónde estás: 家 es tu carpeta personal, 文書 Documentos y 画像 Imágenes.

Moverte y ver archivos

ls  /  lt             # lista lo que hay / en forma de árbol
cd Documentos       # entrar en una carpeta (cd .. sube, cd solo vuelve a casa)
z guia              # salta a una carpeta que ya visitaste, por parte del nombre
yazi               # explorador de archivos en la terminal (q para salir)
cat archivo.txt     # ver un archivo (con colores)
micro archivo.txt   # editarlo: Ctrl+S guarda, Ctrl+Q sale

Crear, copiar, mover y borrar

mkdir proyectos      # crear carpeta
cp a.txt b.txt       # copiar (cp -r para carpetas)
mv a.txt proyectos/  # mover o renombrar
rm a.txt             # borrar: ¡no va a la papelera!

Trucos de Fish

Comandos divertidos

Kitty

Spotify, de dos maneras

irokai spotify-tema activar      # lee el aviso y escribe ACEPTO
irokai spotify-tema desactivar   # Spotify vuelve a ser el original
spicetify backup apply           # si tras una actualización de Spotify desaparece el tema

En Super+I → «Colores de Spotify» eliges entre los colores de cada fondo o el tema fijo de cada estética.

Grabar la pantalla

Para vídeos rápidos usa irokai demo --grabar video.mp4 (abajo). Si quieres un programa completo de grabación y directos, instala OBS con sudo pacman -S obs-studio y añade la fuente Captura de pantalla (PipeWire).

Vídeos para TikTok en 1 comando

irokai demo --grabar ~/Vídeos/TikTok/demo.mp4   # 2 min: estéticas, fondos animados, menú, animaciones…

La demo se graba en un escritorio vacío, así que no sale nada personal. No toques el teclado mientras graba. Para pasarla a vertical (1080×1920) con fondo difuminado y título:

ffmpeg -i demo.mp4 -filter_complex "[0:v]fps=30,split[a][b];[a]scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,gblur=sigma=40[f];[b]scale=1080:-2[v];[f][v]overlay=(W-w)/2:(H-h)/2,format=yuv420p" -c:a aac tiktok.mp4

Instalar y quitar programas

pacman -Ss obs              # buscar
sudo pacman -S obs-studio   # instalar
sudo pacman -Rns obs-studio # desinstalar con sus dependencias
paru nombre                 # buscar también en AUR (paquetes de la comunidad) y elegir con un número

Un programa no es un comando suelto: «obs studio» no funciona, pero obs sí. Lo más fácil es abrir los programas desde el lanzador (Super+Espacio).

Tus apps

Segundo escritorio: KDE Plasma (opcional)

Si lo instalaste (./install.sh --con-plasma): Cierra sesión (Super+Alt+C) y en la pantalla de inicio elige Plasma o Hyprland. Plasma se parece más a Windows: barra abajo, menú de inicio y todo con el ratón. Tus archivos y programas son los mismos en los dos.

Plugins de la barra (Noctalia)

Tienes activados la chuleta de atajos, las letras de canciones, y el actualizador. Hay más de 150 en Super+Z → Plugins: pomodoro, notas, AniList, tiempo, radio…

Inspiración: rices famosos

end-4/dots-hyprland · HyDE · ML4W · JaKooLit · Noctalia · r/unixporn

El teclado está en español, con el inglés como segundo idioma. Cambias entre los dos con Alt+Shift, y la barra te muestra cuál está activo (ES/US). Para añadir más idiomas, edita ~/.config/hypr/config/inputs.lua:

kb_layout = "es,us,fr",   -- separados por comas

Escribir en japonés 日本語

irokai japones        # y después cierra sesión y vuelve a entrar

Ctrl+Espacio alterna entre español y japonés. Escribe en romaji (samurai), pulsa Espacio para elegir los kanji (侍) y Enter para confirmar.

Idioma de todo el sistema

sudo micro /etc/locale.gen                    # quita el # de la línea del idioma (p. ej. ja_JP.UTF-8)
sudo locale-gen
sudo localectl set-locale LANG=ja_JP.UTF-8     # y reinicia

Costumbres sanas

Volver atrás

Versiones nuevas de Irokai

Cuando irokai actualizar avise de una versión nueva, descárgala con el enlace del email de compra y:

irokai actualizar irokai ~/Descargas/irokai-X.Y.Z.zip   # comprueba la firma, guarda tu versión y la instala
irokai actualizar volver                             # si algo va mal, vuelve a la anterior

Solo se instalan zips oficiales (van firmados) y hace falta la licencia activa. Tu configuración y tus fondos no se tocan.

Pedir ayuda

irokai soporte crea ~/irokai-soporte.txt con el diagnóstico y las versiones (sin tu nombre de usuario ni el del equipo) y lo copia al portapapeles. Pégalo en un email a soporte contando qué pasa.

Tu licencia

Una licencia es para una persona y funciona en un ordenador a la vez. Para cambiar de ordenador, libérala en el anterior y actívala en el nuevo.

irokai licencia                  # ver si está activada
irokai licencia activar IRK1-…   # activar (también vale la clave del correo de compra)
irokai licencia desactivar        # liberarla para usarla en otro ordenador

Primeros auxilios

Ayuda: wiki.cachyos.org · wiki.archlinux.org · wiki.hypr.land · foro de CachyOS: discuss.cachyos.org · soporte de Irokai: irokai.support@proton.me