Customizando o Terminal

Configurações e instruções para personalizar o Windows Terminal e o WSL usando Oh My Posh e Nerd Fonts.

Visão geral

Este repositório reúne passos práticos para deixar seu terminal mais legível e visualmente agradável. Aqui você encontra:

• Instalação de Oh My Posh
• Instalação e configuração de Nerd Fonts
• Ajustes no Windows Terminal (esquema de cores e perfil)
• Integração com WSL (Linux)
• Tema customizado pronto para uso

Requisitos

• Sistema operacional: Windows com WSL opcional
• Shells suportados: PowerShell, bash, zsh
• Permissões: privilégios para instalar binários e fontes
• Conexão com a internet para baixar pacotes e fontes

Instalar fontes Nerd Fonts

• Acesse Nerd Fonts.
• Baixe uma família compatível (por exemplo FiraCode Nerd Font).
• Extraia o ZIP e instale as variantes desejadas (ex.: Regular, Bold, Medium, Retina).
• No Windows: clique com o botão direito sobre cada .ttf e escolha Instalar.
• Reinicie o terminal para que a nova fonte seja aplicada.

Dica: se algum ícone não aparecer, troque para outra Nerd Font e confirme que o terminal está configurado para usar a fonte instalada.

Configurar esquema de cores no Windows Terminal

1. Abra as configurações do Windows Terminal com Ctrl + ,.

2. Clique em Abrir arquivo JSON para editar settings.json.

3. Localize ou crie a chave "schemes" e adicione o esquema abaixo (substitua ou ajuste cores conforme preferir):

   {
     "schemes": [
       {
         "name": "Custom color",
         "background": "#101010",
         "foreground": "#F0F0F0",
         "black": "#101010",
         "white": "#F1F1F1",
         "red": "#F80A2F",
         "green": "#00B050",
         "blue": "#0070C0",
         "yellow": "#FFC000",
         "purple": "#7030A0",
         "cyan": "#00B0F0",
         "brightBlack": "#404040",
         "brightRed": "#F86071",
         "brightGreen": "#75B070",
         "brightBlue": "#61CBF4",
         "brightYellow": "#FFCE66",
         "brightPurple": "#7B63A0",
         "brightCyan": "#8EE4F0",
         "brightWhite": "#E3E3E3",
         "cursorColor": "#52F568",
         "selectionBackground": "#52F568"
       }
     ]
   }

4. Salve settings.json. O Windows Terminal normalmente aplica as alterações automaticamente; caso contrário, reinicie o aplicativo.

Ajustar perfil padrão do Windows Terminal

No mesmo settings.json, dentro de "profiles" ajuste os valores padrão para usar a fonte e o esquema:

{
  "profiles": {
    "defaults": {
      "colorScheme": "Custom color",
      "font": { "face": "FiraCode Nerd Font Mono" },
      "padding": "8",
      "backgroundImage": "desktopWallpaper",
      "backgroundImageOpacity": 0.2
    }
  }
}

Observações importantes

• "backgroundImage" pode ser um caminho absoluto de uma imagem ou "desktopWallpaper".
• "backgroundImageOpacity" varia de 0.0 a 1.0.
• Ajuste "padding" conforme preferência.

Instalar Oh My Posh no Windows

Via winget

winget install JanDeDobbeleer.OhMyPosh -s winget

Nota: Reinicie o terminal após a instalação para que as alterações tenham efeito.

Instalação alternativa (script oficial)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://ohmyposh.dev/install.ps1'))

Nota: Reinicie o terminal após a instalação para que as alterações tenham efeito.

Verifique a instalação

oh-my-posh --version

Se o comando não for encontrado, adicione o diretório do binário ao PATH e reinicie o terminal:

$env:Path += ";C:\Users\<YOUR-USER>\AppData\Local\Programs\oh-my-posh\bin"

Substitua <YOUR-USER> pelo seu usuário.

Ativar Oh My Posh no PowerShell

1. Abra o perfil do PowerShell:

   notepad $PROFILE

2. Adicione a inicialização do Oh My Posh:

   oh-my-posh init pwsh --config "$env:USERPROFILE\.poshthemes\custom.omp.json" | Invoke-Expression

3. Salve e reinicie o PowerShell.

Alternativa mínima

Import-Module oh-my-posh
Set-PoshPrompt -Theme Paradox

Usar tema customizado no Windows

1. Copie custom.omp.json para um diretório de temas, por exemplo:

   C:\Users\<YOUR-USER>\AppData\Local\Programs\oh-my-posh\themes\custom.omp.json

2. Aponte o init do PowerShell para esse arquivo (veja seção anterior).

3. Reinicie o terminal para ver o tema aplicado.

Instalar Oh My Posh no WSL

1. Baixe o binário e torne executável:

   sudo wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/posh-linux-amd64 -O /usr/local/bin/oh-my-posh
   sudo chmod +x /usr/local/bin/oh-my-posh

2. Verifique a instalação:

   oh-my-posh --version

3. Edite o arquivo de inicialização do shell (ex.: ~/.bashrc ou ~/.zshrc) e adicione:

   # Oh My Posh
   eval "$(oh-my-posh init bash --config /mnt/c/Users/<YOUR-USER>/AppData/Local/Programs/oh-my-posh/themes/custom.omp.json)"

4. Salve e recarregue o shell:

   source ~/.bashrc
   
   # ou
   
   source ~/.zshrc

Observação: o caminho do tema no WSL pode apontar para o diretório do Windows (/mnt/c/...) ou para um tema armazenado dentro do próprio WSL.

Estrutura de temas Oh My Posh

• Temas são arquivos JSON com segments, blocks e propriedades de cor.

• Mantenha temas personalizados em ~/.poshthemes ou em um diretório versionado no repositório.

• Para baixar temas oficiais:

oh-my-posh get Paradox --output ~/.poshthemes/paradox.omp.json

Troubleshooting rápido

• Ícones não aparecem: confirme a Nerd Font instalada e selecionada no terminal.
• oh-my-posh não encontrado: verifique o PATH e a localização do binário.
• Permissão negada no Linux: execute chmod +x /usr/local/bin/oh-my-posh e, se necessário, instale com sudo.
• Configuração não carrega no login: confirme que você editou o arquivo de perfil correto (~/.bashrc, ~/.zshrc, ~/.config/powershell/profile.ps1 ou $PROFILE no PowerShell).

Boas práticas

• Guarde temas customizados em ~/.poshthemes e versione no repositório.
• Teste pequenas alterações antes de aplicar no perfil principal.
• Documente mudanças no tema para facilitar manutenção.

Contribuição

• Faça fork do repositório.
• Crie uma branch com sua alteração.
• Abra um pull request descrevendo a mudança.
• Sugestões de temas, correções de comandos e melhorias na documentação são bem‑vindas.

Referências

• Oh My Posh: https://ohmyposh.dev/docs/
• Nerd Fonts: https://www.nerdfonts.com/font-downloads
• Windows Terminal: https://learn.microsoft.com/windows/terminal/