Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ Todos los cambios importantes de FocusWShell. Cada versión tiene sus notas en [

- Manual: a picture of how it works, a step-by-step getting started from the main window, step-by-step guides, and screenshots of every section of the main window. / Manual: un dibujo de cómo funciona, primeros pasos paso a paso desde la ventana principal, guías paso a paso y capturas de cada sección de la ventana principal.
- Fixed: in the dark theme, the list in Windows was white with white text. / Corregido: en el tema oscuro, la lista de Ventanas salía blanca con el texto blanco.
- Apps that close to the tray (Codex, Discord, Teams…) show dimmed with ▴ in their panel, and tapping them opens the app again, which shows its window. Before, FocusWShell showed the hidden window itself, and some apps stayed frozen. When the app shows its window again, it goes back to its panel and to the focus. / Las apps que se cierran a la bandeja (Codex, Discord, Teams…) salen atenuadas con ▴ en su panel, y tocarlas abre la app otra vez, que muestra su ventana. Antes FocusWShell mostraba la ventana oculta por su cuenta, y algunas apps quedaban congeladas. Cuando la app vuelve a mostrar su ventana, regresa a su panel y al foco.
- The deck gives the focus app its own place: on a whole tablet, a big tile at the top, above the buttons; in its panel, a blue border. / El deck le da a la app del foco su lugar propio: en la tablet entera, un tile grande arriba, encima de los botones; en su panel, un borde azul.
- New Minimize… mode in the deck (teal), and the four modes in a 2×2 grid. Free all moves up with Previous and To panel; Mouse to focus moves to System. / Nuevo modo Minimizar… en el deck (verde azulado), y los cuatro modos en una cuadrícula de 2×2. Liberar todas sube junto a Anterior y Al panel; Ratón al foco pasa a Sistema.
- "Park" is now called "Minimize" everywhere. / «Estacionar» ahora se llama «Minimizar» en todos lados.
- The main monitor is called "main" in English, and the Spanish buttons say "foco" instead of "Centro". / El monitor principal se llama «main» en inglés, y los botones en español dicen «foco» en lugar de «Centro».

## 0.2.0-alpha
Expand Down
1 change: 1 addition & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ Esta carpeta es la documentación de ingeniería del proyecto. Parte de las nota
| [0015](adr/0015-tiles-adaptables-y-lista.md) | Presentaciones: tiles adaptables y lista tipo Explorador | Aceptada |
| [0016](adr/0016-escritorios-virtuales.md) | Seguir los escritorios virtuales de Windows: un foco y unas apps por escritorio | Propuesta (fase 1 hecha) |
| [0017](adr/0017-ventana-principal-wpf-ui.md) | La ventana principal con WPF-UI: configurar y ver el estado | Aceptada |
| [0018](adr/0018-apps-en-la-bandeja.md) | Apps que se cierran a la bandeja: no mostrarlas nosotros | Aceptada |

## Fuentes

Expand Down
7 changes: 7 additions & 0 deletions docs/adr/0013-deck-superficie-de-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,3 +67,10 @@ Puede vivir en un monitor táctil, sea una tablet que extiende el escritorio ([A
- **Pendiente:**
- comprobar la desconexión con la tablet de verdad;
- **Pantalla completa junto al deck:** en el monitor donde está fijado el deck, un panel en «Pantalla completa» no se maximiza. Ocupa el área que deja el deck, bajo su tira de pestañas (`AuxInput.NoMaximize`). Es la idea de Spotify en la tablet.

## Enmienda: el lugar del foco y el modo Minimizar (2026-11-13)

- **El foco tiene su lugar propio.** En el deck ancho, la cabecera pasa a ser FocusWShell (logo, el monitor que se ve y cuántas apps tiene), y debajo, la app del foco en un tile grande que ocupa el espacio que sobra, encima de los botones (lo primero que se mira; los botones quedan abajo, más cerca de la mano): icono, nombre, de qué panel viene y el título de su ventana. En el deck angosto sigue arriba, en la cabecera. En los dos, se toca como una app: en un modo, el modo; si no, su menú. En «Mover», con otra app elegida, es destino: la lleva al foco. En su panel, la del foco ya no va pintada de azul: lleva un borde azul y la ↑, para que no haya dos cosas iguales.
- **Botones.** Arriba las de acción inmediata: Anterior, Al panel y Liberar todas (que pide un segundo toque). Debajo los cuatro modos en 2×2: Mover y Anclar, que acomodan, a la izquierda; Minimizar y Cerrar, que quitan de la vista, a la derecha. En el deck angosto, dos filas: tres acciones y cuatro modos. Ratón al foco pasa a *Sistema*, junto a Pantalla encendida, Energía y Reordenar todas.
- **Modo Minimizar…** (verde azulado): como Cerrar, se apaga después de un toque (encendido como Anclar se sentía pegado: cada clic minimizaba otra app). Alterna: minimiza una app en su panel (`Park`) o la trae de vuelta (`Restore`). Sólo para apps en un panel; las libres no tienen dónde quedarse.
- **«Estacionar» se llama «Minimizar»** en la interfaz y en el sitio. En el código y en el dominio sigue siendo `Park` ([ADR 0006](0006-ocultar-con-minimizar.md)).
33 changes: 33 additions & 0 deletions docs/adr/0018-apps-en-la-bandeja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# ADR 0018 — Apps que se cierran a la bandeja: no mostrar nosotros sus ventanas

- **Estado:** Aceptada
- **Fecha:** 2026-11-12

## Contexto

Muchas apps no se cierran con su X ni con «Cerrar» del deck: ocultan su ventana y siguen en la bandeja (Codex, Discord, Teams y otras de Electron). La ventana sigue existiendo, sólo sin `WS_VISIBLE`.

FocusWShell sólo daba por cerrada una ventana que ya no existía. Una gestionada que dejaba de ser elegible seguía en su panel con su última foto, una regla pensada para las que cambian de estilo un momento (pantalla completa propia). Con Codex eso causó dos problemas:

- Seguía en el deck como si estuviera abierta.
- Al tocarla, colocarla en el foco la mostraba con `ShowWindow`. La ventana aparecía, pero **congelada**: Electron detiene el dibujo y la entrada al ocultarse, y sólo los reanuda cuando la app misma se muestra. Al mostrarla desde su icono de la bandeja, volvía a responder.

Cualquier acomodo (Reordenar todas, una escena, cambiar la disposición) la habría mostrado igual, sin que el usuario lo pidiera.

## Decisión

**Una ventana que su app ocultó está "en la bandeja", y FocusWShell nunca la muestra.**

- Al ocultarse (el evento `EVENT_OBJECT_HIDE` o, si se perdió, el siguiente refresco), sale del modelo como si se cerrara (`WindowClosed`): ningún acomodo, ni salir, ni la emergencia la tocan. El controlador la recuerda aparte, con su app y su panel.
- El deck y la presentación de lista la muestran **atenuada con ▴** en su panel, aunque no esté anclada.
- **Tocarla lanza la app otra vez** (como una cerrada, `OpenApp`). Las apps de bandeja son de una sola instancia: la que corre recibe el aviso y muestra su ventana ella misma, viva. `OpenApp` la adopta en el panel y la lleva al foco: se tocó para usarla. Sólo adoptarla no basta: en un panel apagado o en pestañas quedaba minimizada al aparecer, y había que tocarla otra vez.
- Si la app vuelve a mostrar su ventana por su cuenta (su icono de la bandeja), el refresco la adopta en su panel de antes y la lleva al foco.
- Si la ventana deja de existir, se olvida.

## Consecuencias

- Al volver va al foco aunque antes estuviera en su panel; su panel se conserva.
- Si una app oculta su ventana sólo un momento, sale del modelo y regresa a su panel, en el foco, en el siguiente refresco.
- Si la app no se puede lanzar (sin ejecutable ni AUMID), tocarla dice por qué; se puede abrir desde su icono de la bandeja.
- Una ventana oculta no sale en **Ventanas** de la ventana principal.
- «Ocultar» como acción del usuario es minimizar: ya existe como **Estacionar** ([ADR 0006](0006-ocultar-con-minimizar.md)).
Binary file modified site/assets/img/en/deck-layout.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified site/assets/img/en/deck.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified site/assets/img/es/deck-layout.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified site/assets/img/es/deck.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions site/concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ When you bring an app to the focus, the one that was there **goes back to its pa

Apps in a panel can also be:

- **Parked:** open but set aside (minimized). They come back from their panel.
- **Minimized:** open but set aside. They keep their panel and come back from it.
- **Out of layout:** you moved or resized one by hand; FocusWShell leaves it where you put it until you bring it back.

## The main screen layout
Expand Down Expand Up @@ -78,7 +78,7 @@ Each panel shows its apps in one of these ways. Change it in the panel header in

Above each panel there is a thin **strip** with one tab per app:

- **Click:** shows it in the panel (or brings it back if it was parked).
- **Click:** shows it in the panel (or restores it if it was minimized).
- **Double-click:** brings it to the focus.
- **Right-click:** everything else.

Expand All @@ -96,7 +96,7 @@ Before moving any window, FocusWShell writes down where it was. **Exit**, the em

**"I dragged a window and it went back."** Windows in a panel keep their place. Drop it on the focus or on another panel to move it there; to place it yourself, free it first.

**"An app disappeared."** Its column may be off (its apps wait minimized in their panel), it may be parked, or it may be behind another app in a panel with tabs. Look for it in the deck or in **Windows**: tapping it brings it to the focus.
**"An app disappeared."** Its column may be off (its apps wait minimized in their panel), it may be minimized, or it may be behind another app in a panel with tabs. Look for it in the deck or in **Windows**: tapping it brings it to the focus.

**"A window is not in the list."** Apps running as administrator cannot be moved and are listed at the end with the reason. Excluded apps are not listed at all: see **Excluded** in the main window.

Expand Down
23 changes: 15 additions & 8 deletions site/deck.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,18 +18,23 @@ Open or hide it with <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd

## Focus

The app in focus, and what to do with it:
The app in focus has its own place. On a whole tablet it is a big tile at the top, under the FocusWShell name and above the buttons, with its icon, its name, the panel it comes from and its window title. In the narrower deck it is at the top. Tap it to open its menu; in a mode, it works like any other app.

In its panel, the focus app has a blue border and **↑**.

### Actions

- **Previous:** brings back the app that was in focus before. Again, and you are back.
- **To panel:** sends the focus app back to its panel and leaves the focus empty.
- **Mouse:** moves the pointer to the focus app. After using a tablet, the pointer stays there; this brings it back to where you work.
- **Free all:** lets every window go back to where it was. It asks for a second tap. **Rearrange all**, in **System**, undoes it.

### Mode buttons

**Move…**, **Pin…** and **Close…** do not act right away: they wait for you to tap an app, like Shift waits for a key. The «…», the colored bar under them and their position tell them apart.
**Move…**, **Pin…**, **Minimize…** and **Close…** do not act right away: they wait for you to tap an app, like Shift waits for a key. The «…», the colored bar under them and their position tell them apart.

- **Move…** (yellow): tap an app, then the panel where it goes. Another monitor's tab works too.
- **Move…** (yellow): tap an app, then the panel where it goes. Another monitor's tab works too, and so does the focus: it brings the app to the focus.
- **Pin…** (indigo): tap an app to pin it to its panel. A pinned app stays in its panel even when closed, dimmed, and tapping it opens it there.
- **Minimize…** (teal): tap an app to minimize it in its panel. If it was already minimized, it comes back. The mode turns off after one tap, like **Close…**.
- **Close…** (red): tap an app to close it, as with its ✕. If it has unsaved work, the app asks.

Tap the mode button again to cancel.
Expand All @@ -45,19 +50,20 @@ Turn the **Context** and **Work** columns of the main screen on or off (blue: on
The row of tabs at the top chooses which monitor's panels you see. Each panel shows its apps:

- **Tap an app:** to the focus. A free one is only brought to the front, and stays free.
- **Long-press (or right-click):** its menu: to the focus, fullscreen on a monitor, park, move to another panel, free it, pin it.
- **Long-press (or right-click):** its menu: to the focus, fullscreen on a monitor, minimize, move to another panel, free it, pin it.
- **Drag** an app onto another panel to move it, or onto **Free** to let it go.
- The panel header has its [presentation]({{ '/concepts/#panel-presentations' | relative_url }}) (▦ ⧉ ☰ ⛶) and, in tabs, ◀ ▶.

Marks on an app:

| Mark | Meaning |
| --- | --- |
| Blue tile, ↑ | In focus. |
| ⏸ | Parked. |
| Blue border, ↑ | In focus. |
| ⏸ | Minimized. |
| ↗ | Out of layout. |
| Dimmed | Closed (pinned), or its column is off. |
| ⧉ | Open on another virtual desktop; tapping it takes you there. |
| ▴ | In the tray: the app hid its window when you closed it, but it is still running. Tapping it opens the app again, and the app shows its window in the focus. |
| White border | It has the keyboard, but it is not the focus app. |

**🗂 Pages**, at the right of the monitor tabs, shows the tabs of your browsers. See [Browser pages]({{ '/browser-pages/' | relative_url }}).
Expand All @@ -70,7 +76,8 @@ Windows FocusWShell does not organize. Tap one to bring it to the front; use **M

- **Screen on:** keeps the screen from turning off and the PC from sleeping.
- **Power:** lock, sleep, restart, shut down or sign out. Restarting, shutting down and signing out ask for a second tap.
- **Free all:** lets every window go back to where it was. **Rearrange all** undoes it.
- **Mouse to focus:** moves the pointer to the focus app. After using a tablet, the pointer stays there; this brings it back to where you work.
- **Rearrange all:** after **Free all**, puts every window back in its panel.

## Where the deck lives

Expand Down
6 changes: 3 additions & 3 deletions site/es/conceptos.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Cuando llevas una app al foco, la que estaba **vuelve a su panel**. Una ventana

Las apps de un panel también pueden estar:

- **Estacionadas:** abiertas pero apartadas (minimizadas). Vuelven desde su panel.
- **Minimizadas:** abiertas pero apartadas. Siguen en su panel y vuelven desde él.
- **Fuera de layout:** moviste o redimensionaste una a mano; FocusWShell la deja donde la pusiste hasta que la devuelvas.

## La disposición del principal
Expand Down Expand Up @@ -78,7 +78,7 @@ Cada panel muestra sus apps de una de estas formas. Se cambia en la cabecera del

Encima de cada panel hay una **tira** fina con una pestaña por app:

- **Clic:** la muestra en el panel (o la recupera si estaba estacionada).
- **Clic:** la muestra en el panel (o la restaura si estaba minimizada).
- **Doble clic:** la lleva al foco.
- **Clic derecho:** todo lo demás.

Expand All @@ -96,7 +96,7 @@ Antes de mover cualquier ventana, FocusWShell apunta dónde estaba. **Salir**, e

**«Arrastré una ventana y volvió.»** Las ventanas de un panel conservan su sitio. Suéltala sobre el foco o sobre otro panel para llevarla ahí; para acomodarla tú, libérala primero.

**«Desapareció una app.»** Puede que su columna esté apagada (sus apps esperan minimizadas en su panel), que esté estacionada o que esté detrás de otra en un panel con pestañas. Búscala en el deck o en **Ventanas**: tocarla la trae al foco.
**«Desapareció una app.»** Puede que su columna esté apagada (sus apps esperan minimizadas en su panel), que esté minimizada o que esté detrás de otra en un panel con pestañas. Búscala en el deck o en **Ventanas**: tocarla la trae al foco.

**«Una ventana no sale en la lista.»** Las apps que se ejecutan como administrador no se pueden mover y salen al final con el motivo. Las apps excluidas no salen: ve a **Excluidas** en la ventana principal.

Expand Down
23 changes: 15 additions & 8 deletions site/es/deck.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,18 +18,23 @@ El deck es la superficie de control de FocusWShell: todo lo que puedes hacer, co

## Foco

La app del foco, y qué hacer con ella:
La app del foco tiene su lugar propio. En la tablet entera es un tile grande arriba, bajo el nombre de FocusWShell y encima de los botones, con su icono, su nombre, el panel del que viene y el título de su ventana. En el deck angosto está arriba. Tócala para abrir su menú; en un modo, funciona como cualquier otra app.

En su panel, la app del foco lleva un borde azul y **↑**.

### Acciones

- **Anterior:** trae de vuelta la app que estaba antes en el foco. Otra vez, y vuelves.
- **Al panel:** devuelve la app del foco a su panel y deja el foco vacío.
- **Ratón:** lleva el puntero a la app del foco. Después de usar una tablet, el puntero se queda en ella; esto lo devuelve a donde trabajas.
- **Liberar todas:** deja que todas las ventanas vuelvan a donde estaban. Pide un segundo toque. **Reordenar todas**, en **Sistema**, lo deshace.

### Botones de modo

**Mover…**, **Anclar…** y **Cerrar…** no actúan al momento: esperan a que toques una app, como Mayús espera una tecla. Los «…», la barra de color debajo y su sitio los distinguen.
**Mover…**, **Anclar…**, **Minimizar…** y **Cerrar…** no actúan al momento: esperan a que toques una app, como Mayús espera una tecla. Los «…», la barra de color debajo y su sitio los distinguen.

- **Mover…** (amarillo): toca una app y luego el panel donde va. La pestaña de otro monitor también sirve.
- **Mover…** (amarillo): toca una app y luego el panel donde va. La pestaña de otro monitor también sirve, y el foco también: lleva la app al foco.
- **Anclar…** (índigo): toca una app para anclarla a su panel. Una app anclada sigue en su panel aunque esté cerrada, atenuada, y tocarla la abre ahí.
- **Minimizar…** (verde azulado): toca una app para minimizarla en su panel. Si ya estaba minimizada, vuelve. El modo se apaga después de un toque, como **Cerrar…**.
- **Cerrar…** (rojo): toca una app para cerrarla, como con su ✕. Si tiene algo sin guardar, la app pregunta.

Toca otra vez el botón del modo para cancelar.
Expand All @@ -45,19 +50,20 @@ Prende o apaga las columnas de **Contexto** y **Trabajo** del monitor principal
La fila de pestañas de arriba elige de qué monitor ves los paneles. Cada panel muestra sus apps:

- **Toca una app:** al foco. Una libre sólo se trae al frente, y sigue libre.
- **Déjala apretada (o clic derecho):** su menú: al foco, pantalla completa en un monitor, estacionar, mover a otro panel, liberarla, anclarla.
- **Déjala apretada (o clic derecho):** su menú: al foco, pantalla completa en un monitor, minimizar, mover a otro panel, liberarla, anclarla.
- **Arrastra** una app a otro panel para moverla, o a **Libres** para soltarla.
- La cabecera del panel tiene su [presentación]({{ '/es/conceptos/#presentaciones-de-un-panel' | relative_url }}) (▦ ⧉ ☰ ⛶) y, en pestañas, ◀ ▶.

Marcas en una app:

| Marca | Significa |
| --- | --- |
| Tile azul, ↑ | En el foco. |
| ⏸ | Estacionada. |
| Borde azul, ↑ | En el foco. |
| ⏸ | Minimizada. |
| ↗ | Fuera de layout. |
| Atenuada | Cerrada (anclada), o su columna está apagada. |
| ⧉ | Abierta en otro escritorio virtual; tocarla te lleva allí. |
| ▴ | En la bandeja: la app ocultó su ventana al cerrarla, pero sigue abierta. Tocarla abre la app otra vez, y la app muestra su ventana en el foco. |
| Borde blanco | Tiene el teclado, pero no es la del foco. |

**🗂 Páginas**, a la derecha de las pestañas de monitores, muestra las pestañas de tus navegadores. Ver [Páginas de los navegadores]({{ '/es/paginas/' | relative_url }}).
Expand All @@ -70,7 +76,8 @@ Ventanas que FocusWShell no organiza. Toca una para traerla al frente; usa **Mov

- **Pantalla encendida:** evita que la pantalla se apague y que el PC se suspenda.
- **Energía:** bloquear, suspender, reiniciar, apagar o cerrar sesión. Reiniciar, apagar y cerrar sesión piden un segundo toque.
- **Liberar todas:** deja que todas las ventanas vuelvan a donde estaban. **Reordenar todas** lo deshace.
- **Ratón al foco:** lleva el puntero a la app del foco. Después de usar una tablet, el puntero se queda en ella; esto lo devuelve a donde trabajas.
- **Reordenar todas:** después de **Liberar todas**, vuelve a poner cada ventana en su panel.

## Dónde vive el deck

Expand Down
Loading
Loading