clamav-tray

Indicador de bandeja para uma instalação de ClamAV gerenciada por systemd. Responde, sem abrir terminal: os serviços estão de pé, tem varredura rodando agora, e como terminou a última?

Um clique abre o estado completo — serviços, varredura, mídia removível e quarentena:

As imagens são renderizações fiéis, montadas a partir da estrutura que o próprio programa produz, com os SVGs do tema Adwaita. Os ícones aparecem brancos porque é assim que são de fato: o indicador pede um ícone pelo nome (security-high-symbolic) e quem pinta é o shell, com a cor de primeiro plano do painel — o que distingue um estado do outro é a forma e o rótulo ao lado, não a cor. A barra de progresso usa as constantes do próprio widgets.py, lidas do código, para a imagem não poder divergir do programa. As duas são regeneráveis: python3 docs/screenshots/make-tray-states.py e make-menu-states.py.

Por que existe

O ClamTk é a referência da categoria (436★), mas é um scanner sob demanda: zero referências a systemd, zero a bandeja, e o último push de código foi em março de 2024. Os demais projetos da busca têm 0 ou 1 estrela.

Ninguém preencheu o espaço de "meu ClamAV já roda por systemd, quero ver o estado dele".

Requer systemd. É a premissa, não uma limitação temporária — o valor do projeto é justamente ler o estado das unidades.

Instalação

sudo apt install python3-gi gir1.2-ayatanaappindicator3-0.1   # Debian/Ubuntu
pipx install --system-site-packages clamav-tray

--system-site-packages é obrigatório. O PyGObject (gi) vem da distro, não do pip — compilá-lo num virtualenv exige toolchain e os cabeçalhos do GTK. Sem a flag, o venv do pipx não enxerga o python3-gi do sistema; o programa detecta isso e diz como corrigir.

Dependências de sistema: python3-gi, GTK 3 e um dos dois AppIndicator (gir1.2-ayatanaappindicator3-0.1 ou gir1.2-appindicator3-0.1 — o programa tenta os dois).

Do código-fonte: clone e pipx install --system-site-packages .

Subir sozinho no login

./packaging/install-autostart.sh          # serviço de usuário, supervisionado
./packaging/install-autostart.sh xdg      # autostart XDG, sem supervisão

Nenhum dos dois precisa de root. Prefira o primeiro: se o processo morrer, ele volta, e o journal guarda o motivo. O autostart XDG dispara e esquece — foi assim que o indicador que deu origem a este projeto sumiu da bandeja sem deixar rastro.

O instalador e os extras ficam no repositório, não no pacote do PyPI: quem instalou por pipx precisa clonar (ou baixar só o packaging/) para usá-los.

O instalador funciona antes de pipx install: sem o clamav-tray no PATH, ele aponta a unidade para o código no diretório atual. E confere se o serviço subiu — não afirma "ativado" sem olhar.

Bandeja no seu desktop

O que funciona numa instalação limpa

O programa observa o que existe. Não instala unidade, não agenda varredura e não decide o que varrer — é essa escolha que o mantém instalável sem root.

Metade de cima funciona; a metade da varredura nasce vazia. Não é bug: a distro não agenda varredura, e o programa não deve inventar uma.

Para preencher, há extras opcionais e independentes em contrib/extras/ — varredura diária, monitor de Downloads, varredura de USB e publicação das estatísticas de quarentena. Cada um com instalador próprio, que recusa sobrescrever e diz como desinstalar.

Configuração

Há um item Configurações no menu: ele cria o arquivo comentado se não existir e abre no seu editor. O arquivo é relido sozinho ao salvar.

Nada é obrigatório — o programa descobre as unidades pelo glob clam* e os caminhos pelo clamconf.

Idioma

Inglês é o padrão e a fonte. Traduzir é opcional por construção: chave sem tradução aparece em inglês em vez de quebrar.

[general]
language = "pt_BR"   # ou "auto" para seguir o locale

Para contribuir com um idioma, copie o bloco pt_BR em clamav_tray/i18n.py e traduza — sem instalar ferramenta nenhuma. Não usa gettext de propósito; o porquê está em docs/design.md.

Documentação

Este projeto é também meu caderno de Rust

Decidi usar este projeto para aprender Rust, migrando um módulo por vez até que não sobre Python.

• A migração acontece em branch separada (rust), nunca na main
• A main continua sendo a versão Python, funcional e mantida
• A virada de chave só acontece quando eu tiver confiança na linguagem — não por prazo, não por metade dos módulos portados. Se essa confiança não vier, a versão Python permanece e isso não é fracasso
• Quem instala usa Python e não precisa saber de nada disso

O desenho em módulos existe por causa disso: cada arquivo tem uma fronteira clara e pode ser portado sozinho. A ordem e o critério estão no ROADMAP.

Se você é contribuidor: mande PR contra a main, em Python. A branch rust é exercício pessoal e pode ser reescrita à força a qualquer momento.

Estado

v0.1, em uso diário por uma pessoa. Publicado porque o nicho estava vazio, não porque seja maduro. Se você usar, espere arestas — e abra issue.

Licença

MIT.