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
2 changes: 2 additions & 0 deletions CHANGELOG.en-US.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ English (US) release notes, mirroring CHANGELOG.md (Brazilian Portuguese). Befor

## [Unreleased]
### Improvements
- **Legibility and handheld density:** context texts that were 14 px — the line above the list (archive, Git, search), "PAINEL ESQUERDO · ATIVO" (left pane · active) in two-pane mode and the inactive pane — are now body size, and on handhelds no informational text is below 16 px. In the folder picker that line becomes the screen title ("Copiar para… · escolha a pasta"). At 720p/800p comfortable rows are ~64 px (was 88: only ~5 fit) and the first launch on a handheld starts in the compact list, never changing a saved choice; the bottom bar no longer wraps (the less essential prompts are left out; Abrir, Voltar, Ações and Menu stay) and the path root ("Meu computador") no longer disappears with large text. Long paths in the details panel lose the middle, not the end ("C:\…\2026\Relatórios trimestrais"), and the main folder cards don't repeat the path on a 4K TV. The on-screen keyboard starts on the first letter, only the focused key has an outline (Done stands out by its text color) and handhelds show only the essential prompts. In the light theme the logo uses a version with a dark name (no dark plate behind it) and keys stand out from the panel (contrast checked by tests).
- **Notices that don't push the list, no dialog after a clean operation, visible progress:** transient notices ("Exibição em grade.", "Lista compacta.", why an option is unavailable) show as a pop-up in the bottom-right corner at body text size and fade after about 3 seconds; the bottom bar no longer changes height (it used to grow up to 124 px and shrink the list). The notice never covers the focused item (it moves to the top corner when needed) and is read by Narrator. A copy, move or delete without any problem no longer opens a dialog you have to close: the notice says "3 itens copiados · Menu → Desfazer" (3 items copied · Menu → Undo); warnings, failures and cancels still open the result, which also stays in Menu → Operações. While anything runs, a thin bar under the title strip shows the overall progress and the strip shows the percentage; Menu → **Operações** splits **Em andamento** (in progress: state icon, percentage and items, updating while the menu is open) from **Histórico** (history). The search summary and the count of items without permission move to the line above the list.
- **Search from home:** **Select/View** on the home screen searches the main folders (Downloads, Documents, Desktop, Pictures, Videos, Music) with the same engine as a folder search (never follows links; East/B cancels; Back returns home). In This PC, search looks in the focused drive.
- **Empty lists with a next step:** "Lixeira vazia" (Recycle Bin empty), "Compactado vazio" (empty archive), "Pasta vazia — Y Ações: Colar / Nova pasta" (empty folder — paste / new folder; paste only when something is copied) and, for a search with no results, the filters and a new search, with the active controller's buttons.
Expand All @@ -14,6 +15,7 @@ English (US) release notes, mirroring CHANGELOG.md (Brazilian Portuguese). Befor
- **Settings in grids** (#227): in each group of Configurações, short settings (view, density, details panel, theme, accent color, sort, hidden items, search in subfolders, recents, restore tabs, suggestions, confirm button, button labels, Fluidez) are now tiles with an icon, a name and the current value; settings with long descriptions or that open another screen stay in a list. The controller moves in 2D between the grids and the lists.

### Fixes
- Details panel: "Este item não está marcado" (this item isn't marked) showed the amber marked symbol; it now shows an empty box.
- Welcome and tutorial texts name the buttons of the controller in use (LB/RB on Xbox, L1/R1 on PlayStation, L/R on Nintendo), like the glyphs.
- Item menus open on the first available tile of the grid instead of a list row below it (archives still open on **Extrair para**). Actions about the open folder (favorites, Colar, Nova pasta aqui, Abrir terminal aqui) sit in a titled **Nesta pasta (name)** group so they don't read as actions on the file.
- Dialogs no longer show the same text on two buttons ("A Cancelar · B Cancelar"): with the focus on the back option, the footer shows the next option.
Expand Down
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ Notas em português do Brasil; a versão em inglês (Estados Unidos) fica em `CH

## [Unreleased]
### Melhorias
- **Legibilidade e densidade nos portáteis:** textos de contexto que estavam em 14 px — a linha acima da lista (compactado, Git, busca), "PAINEL ESQUERDO · ATIVO" com dois painéis e o painel inativo — passam ao tamanho do corpo, e nos portáteis nenhum texto informativo fica abaixo de 16 px. No seletor de pasta, a linha vira o título da tela ("Copiar para… · escolha a pasta"). Em 720p/800p as linhas confortáveis ficam com ~64 px (antes 88: só ~5 cabiam) e a primeira abertura num portátil já começa na lista compacta, sem nunca mudar uma escolha salva; o rodapé não quebra mais linha (as legendas menos essenciais saem; Abrir, Voltar, Ações e Menu ficam) e a raiz do caminho ("Meu computador") não some mais com texto grande. Caminhos longos no painel de detalhes perdem o meio, não o fim ("C:\…\2026\Relatórios trimestrais"), e os cartões das pastas principais não repetem o caminho numa TV 4K. O teclado virtual começa na primeira letra, só a tecla focada tem contorno (Concluir se distingue pela cor do texto) e, nos portáteis, mostra só as legendas essenciais. No tema claro, o logo usa uma versão com o nome escuro (sem a placa escura atrás) e as teclas se destacam do painel (contraste conferido nos testes).
- **Avisos que não empurram a lista, fim de operação sem diálogo e andamento à vista:** os avisos do momento ("Exibição em grade.", "Lista compacta.", o motivo de uma opção indisponível) aparecem num aviso flutuante no canto inferior direito, em letra do tamanho do corpo, e somem sozinhos depois de uns 3 segundos; o rodapé não muda mais de altura (antes crescia até 124 px e encolhia a lista). O aviso nunca fica por cima do item em foco (sobe para o canto de cima quando precisa) e é lido pelo Narrador. Uma cópia, movimentação ou exclusão sem nenhum problema não abre mais um diálogo para fechar: o aviso diz "3 itens copiados · Menu → Desfazer"; avisos, falhas e cancelamentos continuam abrindo o resultado, que fica também em Menu → Operações. Enquanto algo roda, uma barra fina sob a faixa do título mostra o andamento geral e a faixa mostra o percentual; Menu → **Operações** separa **Em andamento** (ícone do estado, percentual e itens, atualizados com o menu aberto) de **Histórico**. O resumo da busca e os itens sem permissão passam para a linha acima da lista.
- **Buscar no início:** **Select/View** na tela inicial busca nas pastas principais (Downloads, Documentos, Área de trabalho, Imagens, Vídeos, Músicas) com o mesmo motor da busca numa pasta (nunca segue links; Leste/B cancela; Voltar retorna ao início). Em Meu computador, a busca procura na unidade em foco.
- **Listas vazias com o próximo passo:** "Lixeira vazia", "Compactado vazio", "Pasta vazia — Y Ações: Colar / Nova pasta" (Colar só com algo copiado) e, na busca sem resultados, os filtros e uma nova busca, com os botões do controle em uso.
Expand All @@ -14,6 +15,7 @@ Notas em português do Brasil; a versão em inglês (Estados Unidos) fica em `CH
- **Configurações em grades** (#227): em cada grupo, os ajustes curtos (exibição, densidade, painel de detalhes, tema, cor de destaque, ordenação, itens ocultos, busca em subpastas, recentes, restaurar abas, sugestões, confirmar com, legendas, Fluidez) viram blocos com ícone, nome e valor atual; os de descrição longa e os que abrem outra tela continuam em lista. O controle anda em 2D entre as grades e as listas.

### Correções
- Painel de detalhes: "Este item não está marcado" mostrava o símbolo âmbar de marcado; agora mostra uma caixa vazia.
- Os textos das boas-vindas e do tutorial citam os botões do controle em uso (LB/RB no Xbox, L1/R1 no PlayStation, L/R no Nintendo), como os ícones.
- Menus de item abrem no primeiro bloco disponível da grade, e não numa linha da lista abaixo dela (compactados continuam abrindo em **Extrair para**). As ações sobre a pasta aberta (favoritos, Colar, Nova pasta aqui, Abrir terminal aqui) ficam no grupo **Nesta pasta (nome)**, com título, para não parecerem ações do arquivo.
- Diálogos não mostram mais o mesmo texto em dois botões ("A Cancelar · B Cancelar"): com o foco na opção de voltar, o rodapé mostra a próxima opção.
Expand Down
Binary file added assets/controlfs-logo-text-light-900.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 docs/GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,9 @@ Buttons follow **physical position** (SDL3 convention), not printed letters.

Only one controller drives the app at a time: the first one to press a button. Pressing a button on another controller (while the active one isn't holding anything) makes it the active one. With the window in the background, input is ignored. The menu has "Confirm with: bottom/right button" and the label style: **automatic** (default: follows the family of the controller in use: Xbox, PlayStation, Nintendo or generic) or fixed to generic, Xbox, PlayStation or Nintendo.

The bottom bar shows the buttons of the controller in use (for example `A Open` on Xbox, with the Xbox face colors: A green, B red, X blue, Y yellow; `✕ Open` on PlayStation) and switches as soon as you use another controller. When you use the keyboard, it shows keyboard keys instead (`Enter Open`, `Esc Back`) until you press a controller button again.
The bottom bar shows the buttons of the controller in use (for example `A Open` on Xbox, with the Xbox face colors: A green, B red, X blue, Y yellow; `✕ Open` on PlayStation) and switches as soon as you use another controller. When you use the keyboard, it shows keyboard keys instead (`Enter Open`, `Esc Back`) until you press a controller button again. The bar always stays one line: when the prompts don't fit (handhelds, large Windows text), the less essential ones are left out from the end — **Abrir**, **Voltar**, **Ações** and **Menu** always stay, and everything else still works and is in the menus.

The on-screen keyboard has the text field on top, four character rows, a function row (`⇧` Shift · `ABC` letters · `@#:` symbols · space · `⌫`) and a bottom row (cursor `◀ ▶` · `…` more · Cancel · **Done**). `…` opens accents, **Select all** (`Sel. tudo`), **Clear** and the PT-BR/EN switch. Selected text is highlighted and underlined: typing replaces it, `⌫` deletes it and `◀ ▶` just drop the selection (Ctrl+A on a physical keyboard selects everything). Rename opens with the name before the extension already selected, so typing `novo` on `example-file.zip` gives `novo.zip`. Shift: one press capitalizes the next letter, a second press locks caps (`⇪`), a third turns it off. Keys that a field doesn't accept (e.g. `\ / : * ? " < > |` in file names) are dimmed. Holding West, LB/RB, or South on `⌫ ◀ ▶` repeats (it speeds up the longer you hold); Done and the other keys never repeat. The cursor is the accent-colored bar in the text field; LT/RT (or Home/End) jump to the start or end, and moving it never changes the text, page or Shift.
The on-screen keyboard opens with the focus on the first letter (`q`), not on the number row. It has the text field on top, four character rows, a function row (`⇧` Shift · `ABC` letters · `@#:` symbols · space · `⌫`) and a bottom row (cursor `◀ ▶` · `…` more · Cancel · **Done**). `…` opens accents, **Select all** (`Sel. tudo`), **Clear** and the PT-BR/EN switch. Selected text is highlighted and underlined: typing replaces it, `⌫` deletes it and `◀ ▶` just drop the selection (Ctrl+A on a physical keyboard selects everything). Rename opens with the name before the extension already selected, so typing `novo` on `example-file.zip` gives `novo.zip`. Shift: one press capitalizes the next letter, a second press locks caps (`⇪`), a third turns it off. Keys that a field doesn't accept (e.g. `\ / : * ? " < > |` in file names) are dimmed. Only the focused key has an outline; **Done** is marked by its accent-colored text. On handhelds the prompts under the keyboard show only the essentials (Select, Delete, Shift, Symbols, Done, Cancel); LB/RB and LT/RT still move the cursor. Holding West, LB/RB, or South on `⌫ ◀ ▶` repeats (it speeds up the longer you hold); Done and the other keys never repeat. The cursor is the accent-colored bar in the text field; LT/RT (or Home/End) jump to the start or end, and moving it never changes the text, page or Shift.

**Suggestions:** in name, search and path fields a strip above the keys suggests matching names (case and accents don't matter: `rel` finds `Relatório 2026`): names you typed before and names in the current folder; for paths, your favorites and recent folders. Press Up from the first row to reach the strip, Left/Right to pick, South to use it (it replaces the text), Down to go back to the keys; Up again continues to the last row. Everything stays on this PC; password fields never show or store suggestions. Menu → Configurações (settings) → **Sugestões do teclado** turns them off and erases the typed history.

Expand Down Expand Up @@ -138,7 +138,7 @@ The list sits in a card with a column header: mark box, **Nome** (name), **Tipo*

On the right of the list is the **details panel** for the focused item: a large icon (or the image thumbnail), name, type and real data — for a folder, the path, how many items and how much space are inside (summed in the background, only for the focused folder, with "Calculando…"); for a file, size and date; for an image, format and dimensions; for a ZIP or 7z archive, how many files it holds (without extracting); for a drive, file system, capacity, free space and the usage bar. With marked items, it shows how many and their total size. The grid has the same panel on its right (in folders, home, This PC, search, archives and the Recycle Bin): it follows the focused tile without taking focus, and the grid uses fewer columns to make room. With marked items the panel also says whether the focused item is one of them; when focus is on the top bar it only summarizes the marked items ("Nenhum item em foco"). On handhelds (1280×720/800) and narrow windows the panel steps aside by default; Actions → Properties shows the same data. Menu → Configurações → **Painel de detalhes: visível/oculto** (details panel: shown/hidden) toggles it; the list and the grid each remember their own choice (saved like the view and density), and on a handheld showing it gives the grid fewer columns instead of covering it.

Menu → Configurações → **List density** switches between **comfortable** (tall rows, for the TV) and **compact** (short rows, more items on screen), with the same columns. In a narrow window the type column goes first. The choice is saved.
Menu → Configurações → **List density** switches between **comfortable** (tall rows, for the TV) and **compact** (short rows, more items on screen), with the same columns. In a narrow window the type column goes first. The choice is saved. On a handheld (1280×720/800) comfortable rows are shorter (about 64 px), and the very first launch there starts in **compact**; once you pick a density, ControlFS never changes it. Long paths in the details panel lose their middle (`C:\…\2026\Relatórios trimestrais`), keeping the drive and the last folders.

Menu → Configurações → **View** (or **R3**, pressing the right stick, or **Ctrl+G** on the keyboard) switches between the **list** and a **grid** of cards (large icon, name, type and size, states and, for folders, a chevron), in folders, search results, archives, the Recycle Bin and the home screen. Columns follow the width left for the grid: 3 at 1080p (2 with the details panel beside it), 2 on a handheld (1 if you show the panel there), 1 in a narrow window, 4 on a 4K TV (one more in compact density). In the grid the D-pad and stick move up, down, left and right between tiles: left/right continue onto the previous/next row at the ends, and down onto a shorter last row lands on its last item. The triggers page one screen of rows. Since left no longer goes to the parent folder in the grid, use Back or the path bar (LB). Density applies to the grid too (compact = smaller tiles), and switching views keeps the focused item. The R3 prompt names the action: **Ver em grade** (view as grid) in the list, **Ver em lista** (view as list) in the grid.

Expand Down
Loading
Loading