Releases: k4ditano/k4
Release list
k4 v1.1.1 — la rueda de la atalaya, en su sitio
Un arreglo de la atalaya, que salió con la rueda del zoom al revés.
La rueda acerca hacia arriba
Como en todo lo que hace zoom. Iba al contrario porque se razonó que un plano se mira como un mapa —apartas la vista para ver más— y resulta que eso no es lo que espera la mano.
Y ahora se puede invertir
En Ajustes → Atalaya → Rueda al revés, porque no hay una respuesta correcta para todo el mundo: en un documento la rueda hacia arriba sube el papel, y quien tenga puesto el desplazamiento natural del sistema recibe el signo cambiado antes de que el plugin llegue a verlo.
Y una cosa para quien depure plugins
quickshell ipc -p shell.qml call k4.atalaya estado devuelve ahora también la escala del plano. Comprobar qué hace la rueda contando píxeles claros de una captura no vale —ese número cambia también con lo que estén enseñando las ventanas, y da lecturas falsas—; con la escala delante se mide en vez de deducirse.
k4 v1.1.0 — la atalaya: todas tus ventanas sobre un plano
Aléjate y mira todas tus ventanas a la vez, vivas y sobre un mismo plano. Te mueves por él con la rueda y el ratón, y al acercarte a una, caes en ella.
La atalaya
El escritorio se aleja y las ventanas se despegan de donde estaban para repartirse por un plano. Siguen vivas ahí dentro: un vídeo se sigue reproduciendo dentro de su miniatura y un compilado sigue escupiendo líneas. Media razón para abrir esto es mirar si algo ha terminado ya.
Y sale también lo que no se estaba viendo. Cada ventana se copia por separado, así que aparecen las de otros escritorios y las que están tapadas del todo. Es un mapa, no un recorte de lo que ya había en pantalla — que es lo que lo separa de un Alt+Tab: no hay que recordar el orden de nada, se mira.
| rueda | acercarse y alejarse, sobre el punto que señalas |
| arrastrar | mover el plano |
| clic en una ventana | ir a ella, cambiando de escritorio si hace falta |
| clic en el vacío | salir |
| escribir | filtrar por título o aplicación |
| flechas · Tab | moverse por la rejilla |
| Inicio | volver a encuadrar todo |
| Esc | salir |
SUPER+Tab cambia de dueño
Pasa a abrir la atalaya. El selector windows que había ahí sigue instalado y se abre desde el centro de aplicaciones; lo que cambia es a qué se ata esa tecla, y lo cambia ./instalar al actualizar.
Una lente de verdad, no tarjetas inclinadas
La curvatura no se finge inclinando cada miniatura por su cuenta: eso se ve como lo que es, rectángulos girados. El plano se dibuja plano a una textura y un shader la dobla entera de una vez, así que la curvatura es continua —una ventana ancha se arquea por el medio en vez de inclinarse entera— y salen gratis las dos cosas que delatan que hay un cristal delante: que los colores se separen en los bordes y que la luz caiga hacia las esquinas.
Debajo hay un suelo con su propia trama, que se mueve y se agranda con la cámara en dos planos a distinta velocidad. Es lo que convierte esto en un canvas y no en un fondo negro con cosas encima: un campo de puntos dice cuánto te has movido y las líneas dicen hacia dónde.
Los dos shaders van compilados en el repositorio porque quien instala la barra no compila nada; el fuente está al lado y docs/ATALAYA.md explica cómo rehacerlos.
Y lo que cuesta
Una miniatura viva es una copia por cuadro de una ventana entera. Las que se salen del encuadre o se quedan diminutas apagan la copia y conservan su último cuadro: quietas, pero ahí.
k4 v1.0.1 — los ajustes salen de la island
Los ajustes salen de la island y pasan a ser una ventana con barra lateral. Y con ellos se muda todo lo que antes estaba repartido: el tema de Hyprland deja de tener pantalla propia, y los ajustes de cada plugin dejan de vivir en un cajón distinto del interruptor que los enciende.
Ajustes, en una ventana
Cabían de sobra cuando eran tres grupos. Al llegar aquí eran dieciséis secciones y cerca de cincuenta opciones en una sola columna, y la única forma de encontrar algo era bajar leyendo. Cada plugin que instalabas lo empeoraba.
Ahora las secciones son una lista a la izquierda y solo se pinta la que estás mirando. Doce entradas: idioma, mazmorra, datos personales, captura, grabación, editor, island, apariencia, color, ventanas, efectos y plugins.
Y hay buscador. Busca en todas las secciones a la vez, porque quien escribe «pill» no sabe en qué cajón está lo que busca — si lo supiera, no escribiría. Las secciones cuyos controles no son filas sueltas —fondos, color, ventanas, efectos— traen palabras clave, así que «blur» o «gaps» también las encuentran y te llevan.
Cada sección, con la vista que pide su contenido
Island enseña un croquis de tu pantalla que se actualiza al tocar cada opción: dónde vive la barra, cómo se alinea y cómo ocupa el sitio. «Reservar sitio» y «Encima» suenan parecido y hacen cosas muy distintas con tus ventanas, y hasta ahora la única forma de saber cuál querías era aplicarlo y deshacerlo. El croquis usa tu fondo de escritorio de verdad, la island de verdad —la misma silueta que dibuja la barra— y respeta los huecos de Hyprland.
Plugins ya no son treinta y seis interruptores seguidos. Cada uno es una fila que se despliega: lo que hace, qué permisos pide, por dónde se le llama (k4:sala, k4.sala) y sus propios ajustes, al lado del interruptor que los enciende. Antes eso estaba en otra sección de la lateral y había que cruzar la ventana.
Apariencia, Color, Ventanas y Efectos son las cuatro pestañas que tenía el tema de Hyprland, ahora como secciones. La rejilla de fondos es la misma de siempre, con más sitio.
Una ventana en un monitor deja de secuestrar el otro
Con Ajustes abierto en la segunda pantalla, la primera se quedaba sin ratón y sin teclado: la island no se abría al pasarle el puntero y lo que escribieras se lo llevaba Ajustes. El foco de teclado en Wayland no es por pantalla, y un agarre exclusivo lo trata todo como modal. K4.Ventana gana tecladoAlPasar: se queda el teclado solo mientras el ratón está encima.
Actualizar la barra no puede costarte los plugins
Dos caminos por los que se perdían, los dos silenciosos. El catálogo lo emite tools/plugins.py --list, y git pull reemplaza ese guión con la barra en marcha: si esa llamada fallaba una vez, arrancabas sin tus plugins. Y el estado de encendidos caía a valores de fábrica si plugins.json aparecía ilegible — y los de usuario vienen de fábrica apagados. Ahora hay caché de la última lista buena, reintentos, escritura atómica y copia; y cuando alguna red se usa, la tienda lo dice.
Y además
- La tienda de plugins tiene buscador, y dice dónde está lo que no encuentra: buscas «snake» en Instalados, no lo tienes, y te dice que hay uno en Descubrir.
- Menos gasto en reposo: las animaciones que nadie ve dejan de correr, el cajón del dock no se construye cerrado, y un fondo de vídeo se escala a tu pantalla antes de reproducirlo — un 4K en un monitor de 1920 costaba el doble de memoria para enseñar lo mismo.
- La mazmorra llega apagada.
- El banco de pruebas puede abrirse en el monitor que le digas:
tools/plugins.py --test <id> --pantalla HDMI-A-1. - Un ajuste puede declararse no disponible por algo del mundo —un programa que no está instalado— y decirlo, en vez de no ofrecerse.
Nada de esto rompe tus atajos
k4 theme y el acceso del centro de control abren Ajustes. Mudar una pantalla de sitio no es motivo para romperle el atajo a nadie.
k4 v1.0.0
A Dynamic Island for Hyprland. It sits collapsed at the edge of your screen
and expands only when it has something to say — and everything it does,
including the parts that look built in, is a plugin.
curl -fsSL https://raw.githubusercontent.com/k4ditano/k4/main/instalar | shFirst tagged release: 353 commits, 29 plugins in the box, and the interface in
Spanish, English and Russian.
New in this one
The bar can stop taking up space. Until now it always reserved a strip the
desktop could not use. Four ways to occupy the edge, chosen separately for the
bar (Settings → Island) and for the dock (Settings → Dual mode) — they are
two different edges, and not wanting to lose room at the top is no reason to
accept losing it at the bottom:
| Reserve space | What it always did, and still the default. |
| Away when fullscreen | Reserves as usual, and gets out of the way while a window fills that screen. Per monitor: the video is on one, the bar is not in the way on the other. |
| On top | Reserves nothing. The pill floats over your windows. |
| Hidden | Retreats past the edge until there is something to show. Brush the edge to call it back; stay half a second and it opens. |
"Something to show" is not a new mechanism — a module takes the island exactly
when it has something to say. Notifications, the volume, a capture
confirmation, and anything you open with its shortcut all bring the bar back on
their own. The player had no way to ask for it, so it now peeks for a few
seconds when the track changes (switchable in Settings → Player).
What is in the box
Launcher — applications, package search, install and update.
Control center — Wi-Fi, Bluetooth, per-device sound, the player.
Notifications with actions and history, a system tray, clipboard history, a
window switcher, and a searchable viewer for every shortcut on the machine.
Capture and a video editor that is not a separate app. Region, window or
screen; record; then land straight in a non-linear editor. Layered video and
image timelines, cuts, crops, audio tracks with ducking and live noise removal,
subtitles, camera overlay, silence detection, Whisper transcription. Out the
other side: MP4, WebM, GIF or 9:16.
Wallpapers that move, and a palette that comes out of them. The bar draws
the wallpaper itself, so it can be a video or a GIF — and it pauses the video
when no window leaves any of it visible, which a wallpaper daemon cannot do.
The colour is pulled from the image and handed to the bar's tint, Hyprland's
borders and the terminal.
Dual mode. SUPER + SHIFT + D and the bar splits in two: the halves run
down the side edges like drops, meet at the bottom and close into a dock — the
same silhouette, mirrored. Or a single drop falls instead, or no animation at
all. It behaves like a dock: what you pin stays, what you open shows up and
leaves on its own, and clicking something already running goes to its window.
Everything is a plugin, including the clock, the launcher and the capture
tool. There is no privileged inner circle: the API a stranger's plugin gets is
the API the launcher uses. Plugins load in isolation, and a broken one is
recorded with its error while the bar starts without it.
And your coding agent already knows how to write one. k4 links a skill into
~/.claude/skills/ and ~/.config/agents/skills/, so Claude Code or Codex
start from a plugin that already runs instead of guessing — including how to
test one without restarting your bar.
Requirements
Arch Linux and Hyprland. The installer reads
dependencias.tsv
and installs what is missing; ./instalar --dry-run shows what it would do
without touching anything.
Updating
~/.config/quickshell/k4/instalar — it pulls with --ff-only, refreshes
packages and shortcuts and offers to restart the bar. With uncommitted changes
in the checkout it leaves your code alone and says so. Settings shows the
commit you are on and tells you when origin has moved.
About the archives below: k4 updates itself with
git, so install it by
cloning (the one-line installer does that for you). The.zipand
.tar.gzGitHub attaches here are snapshots — a copy unpacked from one is
not a git checkout, cannot pull, and Settings will tell you it has no way to
know which version it is.
MIT. Plugin submissions go through
Publish a plugin.