PyTranslucidTb

Barra de tarefas transparente no Windows 11, em Python puro. Um clone leve e enxuto do TranslucentTB: deixa a barra de tarefas transparente, desfocada ou acrílica, com janela de configurações na área de trabalho e ícone na bandeja do sistema.

• 🪟 Transparente, desfoque, acrílico ou invisível — escolha o efeito pela janela ou pela bandeja
• 🎚️ Transparência ajustável (0–100%) — regule o nível no modo Transparente
• 👻 Modo invisível — esconde a barra por completo
• 🌙 Boot silencioso — ao iniciar com o Windows, abre só na bandeja (sem a janela)
• 🖥️ Janela de configurações — controle tudo por uma interface simples (área de trabalho)
• 🔘 Ligar/desligar a qualquer momento
• 💾 Persistência — suas preferências ficam salvas em %APPDATA%\PyTranslucidTb
• 🚀 Início com o Windows — marque na própria janela; aparece em Aplicativos de inicialização
• 🧩 Executável real (.exe) — arquivo único via PyInstaller, sem depender de Python instalado
• 📦 Instalador e desinstalador — instala por usuário e registra em Adicionar ou remover programas
• 🔒 Instância única — reabrir foca a janela existente, sem duplicar

Como funciona

O Windows expõe a função não documentada SetWindowCompositionAttribute na user32.dll. O PyTranslucidTb define uma ACCENT_POLICY nas janelas da barra de tarefas (Shell_TrayWnd e as secundárias Shell_SecondaryTrayWnd) para obter cada efeito. Como o Windows reaplica o estilo próprio da barra com frequência (ao abrir o Menu Iniciar, passar o mouse etc.), um laço leve reaplica o efeito escolhido a cada ~100 ms.

ℹ️ O resultado visual pode variar conforme a build do Windows 11, já que a barra passou a ser renderizada em XAML. É a mesma API usada pelo TranslucentTB.

Requisitos

• Windows 10 ou 11
• Python 3.9+

Instalação

Opção A — Instalador (recomendado)

1. Baixe/clone o projeto
2. Dê duplo-clique em Instalar.bat

O instalador (por usuário, sem exigir administrador):

• instala o executável PyTranslucidTb.exe em %LOCALAPPDATA%\Programs\PyTranslucidTb (compila na hora se ainda não existir — não depende de Python em runtime);
• cria atalhos no Menu Iniciar e na Área de Trabalho (com a logo);
• liga o início automático (aparece em Aplicativos de inicialização);
• registra o app em Adicionar ou remover programas.

Para gerar só o executável (sem instalar), rode build.ps1 — a saída fica em dist\PyTranslucidTb.exe (arquivo único, sem console).

Para remover, use Desinstalar.bat ou o botão Desinstalar em Adicionar ou remover programas — ele encerra o app, apaga atalhos, início automático, preferências e a pasta.

Opção B — Manual (a partir do código)

git clone https://github.com/perepepeu/PyTranslucidTb.git
cd PyTranslucidTb
pip install -r requirements.txt

Uso

python -m pytranslucidtb

Só roda uma instância por vez — abrir de novo apenas traz a janela já aberta para a frente.

Abre a janela de configurações na área de trabalho e um ícone na bandeja do sistema. Na janela (ou no menu da bandeja, com o botão direito) você controla:

Item	O que faz
Efeito ativado	liga/desliga o efeito
Efeito	escolhe entre Transparente, Desfoque, Acrílico, Invisível ou Normal
Transparência (0–100%)	no modo Transparente, define o quão transparente fica a barra
Invisível	esconde a barra por completo (janela em camadas com alfa 0)
Iniciar com o Windows	registra/remove o início automático
Ocultar na bandeja / X	esconde a janela sem encerrar (fica na bandeja)
Sair (bandeja)	restaura a barra e encerra de vez

A janela e a bandeja compartilham o mesmo estado — mudar em um reflete no outro na hora.

Para rodar sem janela de console (por exemplo, no início automático), use run.pyw:

pythonw run.pyw

Início automático

Ao marcar Iniciar com o Windows, é criado um valor em HKCU\Software\Microsoft\Windows\CurrentVersion\Run. É esse mecanismo que faz o app surgir em Aplicativos de inicialização (Gerenciador de Tarefas → Inicializar / Configurações → Aplicativos → Inicializar) e subir junto com o sistema. Desmarcar remove o registro.

Estrutura do projeto

pytranslucidtb/
  taskbar.py         efeito na barra via ctypes/user32
  config.py          preferências em %APPDATA%
  autostart.py       início automático via registro
  single_instance.py instância única (mutex + evento)
  window.py          janela de configurações (tkinter)
  app.py             bandeja + janela + laço principal
  assets/            logo.png, icon.ico
  __main__.py        python -m pytranslucidtb
  paths.py           caminhos de assets (código e .exe)
run.pyw              entrada sem console
build.ps1            compila dist\PyTranslucidTb.exe (PyInstaller)
installer/           install.ps1, uninstall.ps1
Instalar.bat         instala (duplo-clique)
Desinstalar.bat      remove (duplo-clique)

Licença

MIT