blackview
TUI estilo dockview para listar, instalar e rodar ferramentas do BlackArch Linux.
2 testes · 2 passou · 0 falhou · 0 skip
- test_mount_and_tabs0.40s
- test_filter_and_help0.44s
Entrypoints (CLI)
blackview
Módulos e funções principais
src/blackview/__init__.py
- —
src/blackview/blacklib.py
categories()list_tools()— Lista ferramentas (repo se disponível, senão cache).sync()— Sincroniza a lista do repo blackarch (requer repo habilitado).is_installed()install()— Instala via sudo pacman -S --needed. Requer senha de sudo.remove()binary_path()— Tenta adivinhar o binario principal do pacote.run_help()— Captura a saida de `<bin> --help` para exibir na TUI.
src/blackview/cli.py
main()
src/blackview/theme.py
- —
src/blackview/tui.py
- —
Estrutura de arquivos
- LICENSE
- README.md
- pyproject.toml
- src/blackview/__init__.py
- src/blackview/blacklib.py
- src/blackview/cli.py
- src/blackview/theme.py
- src/blackview/tui.py
- tests/test_tui.py
README
# blackview
TUI interativa para o **BlackArch Linux** — lista, instala e executa
ferramentas de segurança, no estilo do **dockview**.
## Funcionalidades
- **Tools**: lista as ferramentas do BlackArch (sync do `pacman -Sl blackarch`
ou cache de fallback embutido). Filtra por nome/descrição/categoria.
- **Categorias**: agrupa por categoria (scanner, cracker, sniffer, forensic,
malware, wireless, web, defensive, ...).
- **Installed**: mostra o que já está instalado no sistema.
- **Log**: saída das ações (instalação, --help das ferramentas).
## Atalhos
| Tecla | Ação |
|-------|------|
| `tab` / `shift+tab` | trocar aba |
| `r` | atualizar lista |
| `f` | filtrar |
| `i` | instalar ferramenta selecionada (sudo) |
| `u` | remover ferramenta |
| `x` | ver saída de `--help` da ferramenta |
| `t` | abrir ferramenta num terminal gráfico (kitty/foot/alacritty) |
| `s` | sincronizar repo BlackArch |
| `q` | sair |
## Instalação
```bash
python3 -m venv .venv && . .venv/bin/activate
pip install -e .
```
Dependências: `textual>=8.2`. Para instalar ferramentas de verdade, precisa do
repo **BlackArch** habilitado e de `sudo`:
```bash
curl -s https://blackarch.org/strap.sh | sudo sh
sudo pacman -Syu
```
Sem o repo, a TUI ainda abre com o cache de fallback (lista representativa).
## ⚠️ Aviso ético
O BlackArch reúne ferramentas de **ofensivas e defensivas**. Use apenas em
ambientes próprios, labs autorizados ou com permissão explícita. A instalação
requer `sudo` e modifica o sistema — confirme antes de prosseguir.
## Licença
MIT
Como rodar na prática (entrada → saída):
$ blackview
[BlackArch] 76 ferramentas\n Tab Files: navegue o PC\n 'i' instala (sudo pacman)\n 'x' mostra --help
$ blackview (tecla i em 'wireshark')
[sudo] pacman -S blackarch/wireshark\ninstalando wireshark... OK