Arch Linux · Hyprland · Quickshell · Python
Manual de uso ·
Criar um DNA ·
Dolphin
O Omnitrix, agora no seu desktop.
Project Azmuth é uma rice para Arch Linux e Hyprland que transforma o desktop em um Omnitrix interativo. Cada alien representa um DNA: um perfil que reúne aparência, organização das janelas, aplicativos e comportamento do ambiente.
Você abre o disco, escolhe uma transformação e entra em outro jeito de trabalhar. O verde do Massa Cinzenta toma a interface; as janelas se reorganizam, o terminal acompanha a paleta e o Omnitrix começa a consumir energia. Ao voltar ao Neutral, o sistema recarrega para a próxima transformação.
O nome homenageia Azmuth, o Galvan criador do Omnitrix em Ben 10. O projeto foi concebido e é mantido por Miguel Do Vale.
Um DNA é descrito em YAML e aplicado pelo motor do Azmuth durante a sessão. Ele define a paleta, o wallpaper, o layout do Hyprland, os aplicativos que podem abrir e os gatilhos de contexto.
| DNA | Identidade | Uso atual |
|---|---|---|
| Neutral | Azul elétrico, Arch no núcleo | Uso diário e recarga do Omnitrix. |
| Massa Cinzenta | Verde galvânico, silhueta do alien | Desenvolvimento e foco, com layout e aplicativos próprios. |
Esses são os dois estados disponíveis hoje. Os outros nove aliens clássicos estão no catálogo e aparecem bloqueados até receberem um DNA funcional.
A abertura automática de aplicativos por transformação pode ser configurada na Central. O ambiente deve acompanhar a tarefa que você escolheu.
| Sistema | O que você encontra |
|---|---|
| Omnitrix HUD | Disco interativo, navegação por setas ou scroll, seleção de DNA, arte do alien e animação de transformação. |
| Desktop vivo | Núcleo que muda entre Arch e Omnitrix, circuitos animados, silhueta do alien e anéis de energia e métricas. |
| Barra galvânica | Workspaces, aplicativos, bandeja, rede, áudio, bateria e o DNA ativo em uma identidade visual comum. |
| Constelação | Alternância de janelas e exploração espacial de workspaces, com miniaturas ao vivo, zoom e navegação WASD. |
| Lançador de aplicativos | Disco com playlists editáveis: nome, runa, cor, ordem e aplicativos. Apps sem playlist continuam acessíveis. |
| Desktop canvas | Widgets que você arrasta e redimensiona, com guias de alinhamento e medidas dos espaços entre eles. |
| Calendário | Eventos, cores, horários e lembretes; criação rápida pelo próprio widget e edição pela Central. |
| Área de transferência | Busca, filtros, favoritos, prévias de imagens, amostras de cores e exclusão em lote. |
| Central | Configurações do Omnitrix, playlists, widgets, calendário, Wi-Fi e som, incluindo áudio por aplicativo. |
| Dolphin | Paleta do DNA, navegação compacta e editor de pastas com cores livres, runas, texto e camadas de marcadores. |
| Notificações | Servidor próprio, ações, histórico no Dashboard, limite de itens visíveis e modo Não perturbe. |
| Capturas e gravação | Seleção de área direta, capturas de tela/janela e gravação, com arquivos salvos e integração com a área de transferência. |
| Login SDDM | Tema opcional do Omnitrix para a entrada na sessão. |
| Terminal | Kitty, prompt e banner do Omnitrix, cores do DNA e botão direito para colar. |
| Bloqueio e energia | Tela de bloqueio temática, sequência de movimentos do Omnitrix, senha do sistema em runas e menu de energia próprio. |
O bloqueio personalizado e a integração da sessão ainda fazem parte de uma rice em desenvolvimento. A senha do sistema continua disponível no modo de autenticação por PAM.
A experiência também tem comportamento inspirado no dispositivo:
- Energia: por padrão, uma transformação descarrega em 10 minutos; o Neutral recarrega em 5. A duração e os limites são ajustáveis.
- Destransformação: a carga chega a zero e o sistema retorna ao Neutral.
- Master Control: acesso direto aos DNAs disponíveis e carga congelada.
- Life-Form Lock: mantém o DNA escolhido até a liberação.
- Failsafe: retorna ao Neutral em condições de bateria crítica ou temperatura elevada.
- Sinais do núcleo: amarelo para coleta de DNA/downloads, azul para recalibração durante atualizações e vermelho para recarga.
Esses mecanismos organizam a experiência do desktop. Seus limites e comportamentos estão descritos no manual.
O Azmuth já tem 24 runas próprias, com significados como Mente, Código, Energia, Tempo, Rede e Núcleo. Elas aparecem nas playlists, nos menus, no bloqueio e nos marcadores de pastas.
A próxima etapa é desenvolver esse conjunto como uma linguagem: combinações, significados, dicionário e tradutor. A gramática ainda está em construção.
A fonte dos símbolos fica em tools/gen_galvan.py. O conjunto gerado é compartilhado pela interface em shell/Galvan.js.
O Context Engine atual funciona por regras. Ele observa o aplicativo em foco e pode sugerir um DNA apropriado; com Master Control, pode aplicar a transformação automaticamente. As sugestões respeitam intervalos de espera para evitar trocas a cada alternância de janela.
O assistente Azmuth tem uma interface própria e uma integração existente com Claude Code em modo não interativo. Essa parte depende de uma conta e de acesso válido ao provedor; a rice pode ser usada sem o assistente.
Quando você faz uma pergunta, a integração prepara um resumo do DNA, energia, janelas, próximos eventos e hora para enviar ao provedor.
A integração com Gemini é uma possibilidade em avaliação. Voz e novos provedores fazem parte dos próximos estudos.
| Atalho | Ação |
|---|---|
Super + Space |
Abrir o Omnitrix e escolher um DNA. |
Super + Esc |
Voltar ao Neutral. |
Super + D |
Abrir o lançador de aplicativos. |
Alt + Tab |
Alternar janelas pela Constelação. |
Super + Tab |
Explorar a Constelação com WASD. |
Super + W |
Abrir o Dashboard. |
Super + Shift + O |
Abrir a Central de Configuração. |
Super + Alt + E |
Editar os widgets na área de trabalho. |
Super + E |
Abrir o Dolphin tematizado. |
Super + Shift + V |
Abrir a área de transferência. |
Super + Shift + S |
Capturar uma área da tela. |
Super + M |
Bloquear a sessão. |
Super + Shift + Q |
Abrir o menu de energia. |
No Dolphin: clique direito numa pasta → Azmuth · ferramentas → Personalizar pasta · cores e runas. Escolha a cor, adicione os marcadores, arraste para posicionar e clique em Aplicar.
A lista completa de atalhos, comandos e configurações está no Manual do Project Azmuth.
O Azmuth é desenvolvido e usado em uma instalação pessoal de Arch Linux, Hyprland com configuração Lua e Bash. A preparação ainda é manual; caminhos, fontes, aplicativos e configuração da sessão precisam ser adaptados ao ambiente.
Dependências e preparação
- Hyprland com suporte à API Lua utilizada em
hypr/azmuth.lua. - Quickshell com os módulos de Wayland, Hyprland, PAM, PipeWire, MPRIS, notificações e Networking usados pela shell.
- Python 3 e PyYAML.
- Hyprpaper, Hypridle, Kitty e Fastfetch.
- NetworkManager para Wi-Fi; PipeWire e WirePlumber para áudio.
- Cliphist e wl-clipboard para a área de transferência.
- Grim e Slurp para capturas; wf-recorder para gravação.
- Dolphin para o explorador tematizado.
- Rofi e Hyprlock para os caminhos de fallback.
- As fontes Orbitron, Rajdhani, JetBrainsMono Nerd Font e Font Awesome 7 Free usadas pela interface.
SDDM é opcional. Claude Code é necessário apenas para o assistente atual. Pillow e NumPy são dependências das ferramentas de geração de arte e som.
Na raiz do repositório:
python3 -m venv .venv
.venv/bin/python -m pip install PyYAML
.venv/bin/python src/core.py rosterO último comando lista os DNAs disponíveis sem transformar a sessão.
- Ajuste
PROJECTemhypr/azmuth.luapara o caminho onde você colocou o repositório. O valor atual é~/Documents/Coding/Project Azmuth. - Execute
.venv/bin/python src/core.py install. O comando conecta a CLI, os arquivos do Hyprland, o Kitty e o Fastfetch, e acrescenta o prompt ao.bashrc. Configurações substituídas por links recebem uma cópia com o sufixo.pre-azmuth. - Garanta que
~/.local/binesteja no seuPATHe acrescenterequire("azmuth")ao seu~/.config/hypr/hyprland.lua. - Revise os atalhos e autostarts da sua configuração para evitar duas barras ou dois serviços de notificações disputando a sessão. Entre novamente na sessão para iniciar a shell e os serviços do Azmuth.
Os aplicativos de exemplo do Massa Cinzenta são VS Code, Kitty e Obsidian. Adapte o YAML ou a configuração de aplicativos do DNA ao que você utiliza.
# Dolphin: instalação própria com backup
azmuth files --setup
# SDDM: tema de login opcional, com privilégios administrativos
bash sddm/install.shO Dolphin tem documentação e restauração próprias em filemanager/README.md.
azmuth apply massa_cinzenta # transformar
azmuth neutral # retornar à base
azmuth current # DNA atual
azmuth roster # catálogo de DNAs
azmuth files --split projetos downloads| Camada | Responsabilidade | Fonte |
|---|---|---|
| DNA | Paletas, layout, wallpaper, apps, serviços e gatilhos de contexto. | dna/*.yaml |
| Motor | Validar os perfis, aplicar transformações, controlar o estado e oferecer a CLI. | src/core.py |
| Shell | Barra, discos, painéis, notificações, bloqueio, widgets e Constelação. | shell/*.qml |
| Sessão | Atalhos, autostart e integração com o compositor por Lua e IPC. | hypr/azmuth.lua |
| Contexto | Observar o uso, sugerir DNAs e acompanhar condições do sistema. | src/context_engine.py |
| Assistente | Preparar o contexto e consultar o provedor de IA configurado na implementação. | src/azmuth_ai.py |
| Arquivos | Aplicar o tema do Dolphin e compor ícones de pastas com marcadores. | src/file_manager.py, src/folder_style.py |
Os perfis ficam no repositório; preferências e dados de execução ficam
em ~/.local/state/azmuth/. A configuração Lua liga esses componentes
à sessão do Hyprland.
assets/ Artes, wallpapers e sons
bin/ Entrada da CLI azmuth
dna/ Perfis e catálogo do Omnitrix
docs/ Manual, conceitos e especificação de DNA
filemanager/ Tema do Dolphin e editor de pastas
hypr/ Integração Lua e configurações da sessão
shell/ Interface Quickshell/QML
src/ Motor, contexto, assistente e integrações
terminal/ Kitty, prompt e Fastfetch
sddm/ Tema de login
tools/ Geradores de runas, arte e sons
As preferências, os eventos e o estado de execução são gravados em
~/.local/state/azmuth/, fora da árvore do código.
- Lapidar a experiência dos sistemas existentes no uso diário.
- Desenvolver a linguagem Galvan, seu dicionário e tradutor.
- Refinar o Context Engine e estudar a próxima integração do assistente.
- Definir a função de cada alien antes de habilitar novos DNAs.
- Tornar a instalação mais fácil de reproduzir em outras máquinas.
O segundo Core voltado a segurança e as formas Ultimate continuam como visões futuras. O foco atual é consolidar o Arch Core e os DNAs que já existem.
Ideias de interação, relatos de bugs, documentação e melhorias visuais ajudam o projeto a evoluir. Ao propor um novo alien, explique como a habilidade dele se traduz em uma função útil do desktop.
Para entender a intenção do projeto, leia o documento-mestre. Ele também registra decisões e histórico; algumas seções refletem etapas anteriores. Para operação atual, consulte o manual e o código.
Concepção, direção e manutenção: Miguel Do Vale (@Miguel-doVale, também conhecido como Sun_Akuma).
Copyright (C) 2026 Miguel Do Vale.
O código original do Project Azmuth é distribuído sob a GNU General Public License v3.0, identificador GPL-3.0-only. O texto integral está em LICENSE.
A licença permite usar, modificar e redistribuir o código, inclusive comercialmente, com as obrigações de preservar os avisos de autoria e licença e disponibilizar o código correspondente das versões distribuídas nas condições da GPL-3.0.
Ao divulgar o projeto, identifique o Project Azmuth e sua origem.
Este é um projeto independente de fã, inspirado em Ben 10, sem afiliação oficial. Personagens, nomes, símbolos e outros elementos da franquia pertencem aos respectivos titulares. Referências à franquia não concedem direitos sobre esses materiais.