---
title: Configuração Pós-Instalação e Atalhos do Hyprland
description: Tarefas comuns a fazer após a instalação e visão geral dos atalhos
ai_translated: true
---

import { Kbd } from 'starlight-kbd/components'
import ImageComponent from '~/components/image-component.astro';
import { Aside } from '@astrojs/starlight/components';

:::note
O Hyprland é um compositor Wayland que suporta vários layouts como dwindle (tiling), scrolling, master, monocle e layouts personalizados. **Não** é um ambiente de desktop completo (DE).
:::

### Porque usar o Hyprland?

O Hyprland é um belo gestor de mosaico dinâmico que oferece uma variedade de layouts e funcionalidades avançadas de compositor como VRR, tearing e HDR. Os dotfiles do CachyOS para o Hyprland são configurados com valores padrão gerais que devem ser completamente utilizáveis imediatamente, com aplicações que seguem o tema geral do sistema.

**Dotfiles mantidos por [Jinra](https://github.com/Jinra)**

Para questões relacionadas com o Noctalia, consulte a [documentação do Noctalia](https://docs.noctalia.dev/).

## Tarefas Pós-Configuração

Pretenderá configurar algumas coisas específicas do utilizador após a configuração. Para definições adicionais, consulte a wiki do Hyprland https://wiki.hypr.land/Configuring/Start/

### Localização `~/.config/hypr/config`
* `monitors.lua` irá configurar os seus monitores. (consulte https://wiki.hypr.land/Configuring/Basics/Monitors/). Um bloco padrão é criado para si, pode adicionar mais para monitores adicionais.
  * `output` edite `variables.lua` em vez disso com o valor do monitor; pode executar `hyprctl monitors` para obter este id (ex: `DP-1`). Se adicionar mais monitores, use MONITOR2, MONITOR3, etc e adicione-os também ao `variables.lua`.
  * `mode` deve estar num formato como `1920x1080@60` (horizontal x vertical @ taxa de atualização).
  * `scale` Provavelmente pretenderá `1`, mas pode querer este valor mais alto para monitores de resolução mais elevada.
  * Pode precisar de reiniciar após o primeiro ajuste, mas ajustes futuros devem ser refletidos em tempo real.
* `variables.lua`
  * Adicione as suas atribuições de monitor aqui. o seu `PRIMARY_MONITOR` e `MONITOR1` devem geralmente ser o mesmo monitor. Pode remover/adicionar variáveis `MONITOR#` conforme necessário.
  * Defina o seu número de workspaces por monitor. Não exceda 10.
* `input.lua` Pode definir as várias definições de input do hypr aqui. Provavelmente pretenderá ajustar a `sensitivity`.
* `binds.lua` Revise este ficheiro para ver todos os atalhos para estes dots. Pode também consultar a visão geral geral abaixo.
* `windowrules.lua` Se se perguntar porque certas janelas têm certos comportamentos, consulte este ficheiro; pode também adicionar/remover regras conforme achar apropriado.
* `workspaces.lua` Adicione várias definições de workspace aqui. É recomendado adicionar 3 workspaces por monitor (como mostrado nos exemplos) mais o workspace de gaming ao monitor principal.
* `environment.lua` é usado para definir variáveis de ambiente específicas do hypr ou do utilizador. Não é necessário ajustar se estiver a usar UWSM, e é mais preferível adicionar estas ao ficheiro de ambiente do UWSM em vez disso (veja abaixo).
### Localização `~/.config/uwsm`
* `env` é um ficheiro usado para definir variáveis globais, pode usar isto para variáveis gerais que precisam de ser atribuídas para a sua conta de utilizador específica (Exemplos: `HYPRCURSOR_THEME`, `XCURSOR_THEME`, `QT_QPA_PLATFORM`, etc.)
### Localização `~/.config/noctalia` (Apenas V5; V4 terá ficheiros aqui, mas não precisa de os tocar pois podem ser configurados através das definições do Noctalia)
* `config.toml` é aqui que vive a configuração padrão do cachyos-hypr-noctalia. Se se pergunta porque os padrões diferem de uma instalação vanilla do noctalia v5, esta é a razão. Não deverá ter de tocar em nada neste ficheiro.
### Localização `definições do noctalia` (Super + Z)
* Pode editar as definições do Noctalia aqui. É recomendado ir à secção de templates e ativar qualquer template de cor para quaisquer aplicações que possa usar.
* Consulte também a loja de plugins para plugins oficiais e da comunidade úteis.

## Atalhos (Keybinds)

A maioria das combinações de teclas requer o uso da tecla mod que no nosso caso é a tecla Windows/Command (referenciada como SUPER), pode alterá-la em `binds.lua`.

### Gestão de Janelas

| Descrição | Tecla |
|-------------|-----|
| Forçar fechar aplicação/janela (segure combo e clique) | <Kbd linux="Super+Escape" /> |
| Fechar janela/aplicação focada | <Kbd linux="Super+Q" /> |
| Alternar flutuante/mosaico | <Kbd linux="Super+Alt+Space" /> |
| Maximizar janela focada | <Kbd linux="Super+D" /> |
| Janela focada em ecrã inteiro | <Kbd linux="Super+F" /> |
| Alternar direção de divisão | <Kbd linux="Super+J" /> |
| Focar esquerda | <Kbd linux="Super+Left" /> |
| Focar direita | <Kbd linux="Super+Right" /> |
| Focar cima | <Kbd linux="Super+Up" /> |
| Focar baixo | <Kbd linux="Super+Down" /> |
| Alternar foco de janela no workspace | <Kbd linux="Alt+Tab" /> |
| Abrir alternador de janelas | <Kbd linux="Super+Tab" /> |
| Mover janela focada para monitor | <Kbd linux="Super+Shift+#" /> |
| Mover janela focada para workspace | <Kbd linux="Super+Shift+Control+#" /> |
| Mover janela focada para workspace especial | <Kbd linux="Super+Shift+S" /> |
| Mover janela focada para a direita | <Kbd linux="Super+Shift+Right" /> |
| Mover janela focada para a esquerda | <Kbd linux="Super+Shift+Left" /> |
| Mover janela focada para cima | <Kbd linux="Super+Shift+Up" /> |
| Mover janela focada para baixo | <Kbd linux="Super+Shift+Down" /> |
| Mover janela focada para o próximo workspace | <Kbd linux="Super+Control+Shift+Right" /> |
| Mover janela focada para o workspace anterior | <Kbd linux="Super+Control+Shift+Left" /> |
| Mover janela focada para o workspace anterior (rato) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;up" /> |
| Mover janela focada para o próximo workspace (rato) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;down" /> |
| Mover janela focada para o próximo monitor | <Kbd linux="Super+Shift+Scroll&nbsp;down" /> |
| Mover janela focada para o monitor anterior | <Kbd linux="Super+Shift+Scroll&nbsp;up" /> |
| Mover janela (rato) | <Kbd linux="Super+Left&nbsp;Click" /> |
| Redimensionar janela (rato) | <Kbd linux="Super+Right&nbsp;Click" /> |

### Launcher

| Descrição | Tecla |
|-------------|-----|
| Abrir Terminal | <Kbd linux="Super+Return" /> |
| Abrir Gestor de Ficheiros | <Kbd linux="Super+E" /> |
| Abrir Editor | <Kbd linux="Super+T" /> |
| Abrir Calculadora | <Kbd linux="Super+C" /> |
| Abrir Navegador | <Kbd linux="Super+W" /> |
| Abrir Monitor do Sistema (btop) | <Kbd linux="Control+Shift+Escape" /> |
| Alternar Definições do Noctalia | <Kbd linux="Super+Z" /> |
| Alternar Centro de Controlo | <Kbd linux="Super+X" /> |
| Alternar Launcher de Aplicações | <Kbd linux="Super+Space" /> |
| Abrir Launcher de Emoji | <Kbd linux="Super+period" /> |
| Bloquear ecrã | <Kbd linux="Super+L" /> |
| Alternar menu de sessão | <Kbd linux="Super+Alt+C" /> |

### Controlos de Hardware

| Descrição | Tecla |
|-------------|-----|
| Aumentar Volume | <Kbd linux="Volume Up" /> |
| Diminuir Volume | <Kbd linux="Volume Down" /> |
| Silenciar Saída de Áudio | <Kbd linux="Mute" /> |
| Silenciar Entrada do Microfone | <Kbd linux="MicMute" /> |
| Reproduzir/Pausar Média | <Kbd linux="Play" /> / <Kbd linux="Pause" /> |
| Faixa de Média Seguinte | <Kbd linux="Next" /> |
| Faixa de Média Anterior | <Kbd linux="Previous" /> |
| Aumentar Brilho do Ecrã | <Kbd linux="Brightness Up" /> |
| Diminuir Brilho do Ecrã | <Kbd linux="Brightness Down" /> |

### Utilitários

| Descrição | Tecla |
|-------------|-----|
| Seletor de Cor | <Kbd linux="Super+P" /> |
| Captura de Ecrã & Anotar | <Kbd linux="Print" /> |
| Captura de Janela de Ecrã & Anotar (v4) | <Kbd linux="Super+Print" /> |
| Captura de Monitor de Ecrã & Anotar (v5) | <Kbd linux="Super+Print" /> |
| Alternar Gravador de Ecrã (apenas v4) | <Kbd linux="Super+R" /> |
| Alternar Menu de Wallpaper | <Kbd linux="Super+Shift+W" /> |
| Abrir Histórico da Área de Transferência | <Kbd linux="Super+V" /> |
| Alternar Histórico de Notificações | <Kbd linux="Super+A" /> |
| Ampliar | <Kbd linux="Super+Plus" /> |
| Reduzir | <Kbd linux="Super+Minus" /> |

### Workspaces & Monitores

| Descrição | Tecla |
|-------------|-----|
| Mudar para workspace [1-10] | <Kbd linux="Super+[0-9]" /> |
| Mover janela para workspace [1-10] (seguir) | <Kbd linux="Super+Shift+[0-9]" /> |
| Mover janela para workspace [1-10] (não seguir) | <Kbd linux="Super+Alt+[0-9]" /> |
| Focar workspace (Relativo) | <Kbd linux="Super+Control+#" /> |
| Focar workspace (Absoluto) | <Kbd linux="Super+Alt+#" /> |
| Focar próximo workspace | <Kbd linux="Super+Control+Right" /> |
| Focar workspace anterior | <Kbd linux="Super+Control+Left" /> |
| Focar primeiro workspace vazio | <Kbd linux="Super+Control+Down" /> |
| Focar próximo workspace (rato) | <Kbd linux="Super+Control+Scroll&nbsp;down" /> |
| Focar workspace anterior (rato) | <Kbd linux="Super+Control+Scroll&nbsp;up" /> |
| Focar próximo monitor (rato) | <Kbd linux="Super+Scroll&nbsp;down" /> |
| Focar monitor anterior (rato) | <Kbd linux="Super+Scroll&nbsp;up" /> |
| Alternar workspace especial (scratchpad) | <Kbd linux="Super+S" /> |

## Migrar de outro DE/WM

Se já tiver outro DE/WM instalado, pode migrar para estes dots com as instruções abaixo.

:::note
Embora seja possível usar a mesma conta de utilizador com o Hyprland, é altamente recomendado criar uma nova conta de utilizador (instruções incluídas). Adicionalmente, mesmo com uma nova conta de utilizador, pode haver conflitos de daemon com o seu DE/WM anterior, por isso é mais ideal usar um único ambiente.
:::

Certifique-se de substituir as variáveis entre parênteses angulares (\<\>) abaixo, incluindo os próprios parênteses angulares.

1. Execute `sudo pacman -S cachyos-hypr-noctalia`. Se encontrar um conflito de pacote com outro pacote `-settings` (como `cachyos-kde-settings`), pode eliminar o pacote em conflito, pois estes pacotes não afetam utilizadores atuais.
1. Para criar um novo utilizador, execute `sudo useradd -m <new_user> -s /bin/fish`. Pode também usar outra shell se preferir (ex: /bin/zsh).
1. Execute `sudo passwd <new_user>` para definir uma password para a conta.
    * Se _realmente_ quiser usar a mesma conta (altamente desencorajado), em vez disso copie os dots para a pasta do utilizador `cp -r /etc/skel/. ~` (certifique-se de criar um backup/snapshot primeiro!)
1. Opcionalmente instale `noctalia-greeter` ou `sddm` como o seu gestor de ecrã. `noctalia-greeter` integra-se melhor com o Noctalia, mas a configuração é ligeiramente mais complicada.
    * Para ativar o sddm como o seu gestor de ecrã, instale-o com `sudo pacman -Syu sddm`, depois execute `systemctl disable display-manager` e `systemctl enable sddm`.
    * Para instalar o [Noctalia Greeter](https://github.com/noctalia-dev/noctalia-greeter), execute `sudo pacman -Syu noctalia-greeter`, e siga a secção "Setting up greetd" da documentação vinculada. Depois, execute `systemctl disable display-manager` e `systemctl enable greetd`.
1. Reinicie e selecione a sessão Hyprland (UWSM) no seu gestor de ecrã.
    * Se a shell falhar ao carregar, tente reiniciar mais uma vez.
1. Inicie sessão e siga as [Tarefas Pós-Configuração](/pt/configuration/desktop_environments/hyprland/#tarefas-p%C3%B3s-configura%C3%A7%C3%A3o).

## Migrar de dots v4 para V5 / Atualizar os seus dots

Se atualmente estiver a usar cachyos-hypr-noctalia com Noctalia v4 e atualizou da versão de pacote 1.0 para uma versão mais recente, ou quiser atualizar os seus dots, siga as instruções abaixo.
Consulte os registos de alterações completos no release para determinar se deve atualizar os seus dots.
https://github.com/CachyOS/cachyos-hypr-noctalia/releases

### Atualizações do Hypr

:::note
Uma vez que migrar os seus atalhos de v4 para v5, estes já não funcionarão para chamar chamadas IPC do Noctalia.
:::

1. Instale `meld` se não o tiver (`pacman -Q meld` para verificar se o tem).
1. Execute `meld /etc/skel/.config/hypr ~/.config/hypr`.
1. A partir do meld verá uma visão geral de todos os ficheiros com alterações. Ficheiros azuis têm alterações, enquanto ficheiros verdes são totalmente novos.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/meld_overview.png')} />
1. Clique num ficheiro azul para ver as alterações a aplicar. Pode usar o seu melhor julgamento para determinar o que aplicar, mas se não fez quaisquer alterações, é seguro sobrescrever o ficheiro inteiro. Clique na seta para aplicar alterações e no x para remover linhas antigas.
    <Aside type="note">Certifique-se de não sobrescrever coisas que pode ter alterado, como as suas definições de monitor.</Aside>
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge.png')} />
1. Pode fundir tudo também.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_1.png')} />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_2.png')} />
1. Quando terminar as suas alterações para o ficheiro, guarde e saia.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/save_exit.png')} />
1. Os ficheiros verdes totalmente novos pedirão onde quer guardá-los. Pode guardá-los em `~/.config/hypr/config/` com o mesmo nome. Há 4 ficheiros novos.
    * defaults.lua agora é variables.lua. Deve mover manualmente quaisquer adições/alterações personalizadas para o novo ficheiro.
    * keybinds.lua agora é binds.lua. Deve mover manualmente quaisquer adições/alterações personalizadas para o novo ficheiro.
    * input.lua agora é inputs.lua. Deve mover manualmente quaisquer adições/alterações personalizadas para o novo ficheiro.
    * workspaces.lua é novo totalmente e pode ser movido limpa e simplesmente sem alterações.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/workspaces.png')} />

### Atualizações do Noctalia

1. Execute `rm -rf ~/.config/noctalia` para remover as configurações atuais. Alternativamente, mova-as para outro lado se pensar que pode precisar de algo lá.
1. `cp -r /etc/skel/.config/noctalia ~/.config` irá copiar a nova configuração para a sua pasta pessoal.

:::note
O único ficheiro importante é config.toml, por isso pode copiá-lo individualmente em vez de eliminar e substituir a pasta inteira quando o pacote atualizar, se quiser.
:::

### Outras Atualizações

Outros ficheiros podem ter atualizações, pode usar meld para integrar estes. Consulte o registo de alterações completo do release para ver o que mais pode ter mudado.

### Remover órfãos (migração v4->v5)

Após atualizar o pacote, as dependências antigas ficarão órfãs, pode removê-las executando `shelly purify -o`.

### Reinício

Reiniciar deve fazer com que as alterações entrem em vigor. Se a shell falhar ao carregar, tente reiniciar mais uma vez.

## FAQ

> _"O meu histórico da área de transferência não persiste através dos reinícios"_

Precisa de configurar uma loja de segredos (secrets store) para isto funcionar corretamente. O Kwallet está instalado por predefinição, mas pode também usar gnome-keyring ou outra loja de segredos. Se quiser usar kwallet, instale `kwalletmanager` do repo, depois abra-o e crie uma nova carteira. É mais fácil deixar a password em branco, mas pode também configurar desbloqueio automático com o seu gestor de ecrã, o que está fora do âmbito desta wiki; consulte a [arch wiki](https://wiki.archlinux.org/title/KDE_Wallet#Configuration) para mais detalhes. Após configurar uma carteira, inicialize-a no seu ficheiro `autostart.lua` com `hl.exec_cmd("kwalletd6")`.

> _"Como faço para o satty não aparecer após tirar uma captura de ecrã?"_

Pode facilmente dispensar o satty premindo ctrl + s para guardar a sua captura de ecrã ou ctrl + c para copiar. Se não quiser que o satty apareça de todo, pode configurar a definição para copiar para a área de transferência ou guardar para ficheiro nas definições do Noctalia > shell > screenshot.

> _"Como altero o meu input de teclado?"_

Edite `inputs.lua` e adicione `kb_layout`. Consulte [aqui](https://wiki.hypr.land/Configuring/Basics/Variables/#input)

> _"Porque é que algumas opções de tema não estão a funcionar (ícones do Dolphin, alguns elementos QT, etc)"_

O repo padrão do Cachy só fornece `qt6ct` (QT6 Configuration Tool). No entanto, há outra ferramenta que funciona melhor para aplicações Plasma QT como dolphin, gwenview, etc. Descarregue `qt6ct-kde` do AUR em vez disso e aplique o tema Noctalia com ele. Isto deve ter as suas aplicações plasma com melhor tema no Hyprland.

> _"Como altero o meu navegador predefinido?"_

Execute `xdg-settings set default-web-browser your_browser.desktop`. Pode encontrar o nome do ficheiro desktop do seu navegador executando `ls /usr/share/applications/`