GholsX

Arch Linux + Hyprland + Quickshell em português do Brasil.

Um setup pessoal, limpo e versionado, pensado para produtividade, organização e foco.

---

Sobre

O GholsX é um projeto pessoal de dotfiles para construir um ambiente Linux moderno, limpo e totalmente versionado.

A proposta é criar um sistema que ajude na organização visual, reduza distrações e favoreça o foco — especialmente para pessoas com dificuldade de concentração, como no TDAH.

Além de ser meu ambiente diário, este repositório também serve como registro de aprendizado sobre Linux, Hyprland, Quickshell, Git, automação e documentação técnica.

---

Stack

Categoria	Ferramenta
Sistema	Arch Linux
Compositor	Hyprland
Shell visual	Quickshell
Terminal	Ghostty
Shell	Fish
Arquivos	Yazi
Versionamento	Git + GitHub

---

Estrutura

gholsx/
├── assets/
├── configs/
│   ├── ghostty/
│   ├── hypr/
│   └── quickshell/
├── docs/
├── notes/
├── scripts/
├── themes/
├── LICENSE
└── README.md

---

Configuração do Hyprland

O GholsX usa hyprland.lua como arquivo principal de configuração do Hyprland.

configs/hypr/hyprland.lua

Com os symlinks ativos, o sistema acessa essa configuração em:

~/.config/hypr/hyprland.lua

---

Symlinks

As configurações principais são versionadas dentro do repositório e ligadas ao sistema por symlinks:

~/.config/hypr       -> ~/Projetos/gholsx/configs/hypr
~/.config/quickshell -> ~/Projetos/gholsx/configs/quickshell
~/.config/ghostty    -> ~/Projetos/gholsx/configs/ghostty

Para criar os symlinks:

./scripts/system/link-dotfiles.sh

Para remover os symlinks:

./scripts/system/unlink-dotfiles.sh

---

Keybinds

Atalho	Ação
SUPER + Return	Abrir terminal
SUPER + Space	Abrir lançador de aplicativos
SUPER + tecla de aplicativos	Histórico da área de transferência
SUPER + C	Escolher papel de parede
SUPER + B	Embaralhar papel de parede e aplicar tema
SUPER + L	Logout
SUPER + E	Abrir gerenciador de arquivos
SUPER + Shift + S	Printscreen de área selecionada
SUPER + PrintScreen	Printscreen da tela inteira
SUPER + ← / →	Alternar áreas de trabalho

Terminal

Atalho	Ação
Ctrl + C	Copiar
Ctrl + V	Colar
Ctrl + Shift + C	Cancelar operação no terminal

---

Instalação

Este projeto ainda está em desenvolvimento e não possui instalador final.

Clone o repositório:

git clone git@github.com:TheGhols/gholsx.git ~/Projetos/gholsx
cd ~/Projetos/gholsx

Revise os scripts antes de executar:

sed -n "1,220p" scripts/system/link-dotfiles.sh

Depois, se estiver tudo certo:

./scripts/system/link-dotfiles.sh

---

Notas

• Este é um projeto pessoal em desenvolvimento ativo.
• Use a branch dev para testes e a branch main para versões estáveis.
• Leia os scripts antes de executar em outra máquina.
• Algumas funções visuais, como wallpaper picker, retheme e clipboard history, podem depender de scripts e pacotes adicionais.
• O objetivo do projeto é priorizar clareza, organização e manutenção simples.

---

Suporte

Este projeto é mantido principalmente para uso pessoal e aprendizado.

Sugestões, ideias e correções podem ser abertas como issues no GitHub.

---

Créditos

O GholsX é inspirado por comunidades, projetos e rices do ecossistema Linux, Arch, Hyprland e Quickshell.

Wallpapers, ícones, temas ou imagens de terceiros serão creditados conforme forem adicionados ao projeto.

---

Licença

Distribuído sob a licença MIT.

Veja o arquivo LICENSE.