muxtop

A modern, multiplexed system monitor for the terminal.

muxtop remplace le workflow htop + iftop + ctop par une interface à onglets unique. Pensez htop, mais avec une UX de multiplexeur (à la tmux/zellij) et une palette de commandes à la VS Code.

Installation

Via crates.io

cargo install muxtop

Via Homebrew (macOS / Linux)

brew tap lanexadev/tap
brew install muxtop

Via APT (Debian / Ubuntu)

# Ajout du repo (une seule fois)
curl -fsSL https://lanexadev.github.io/apt/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/lanexadev.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/lanexadev.gpg] https://lanexadev.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/lanexadev.list

# Installation
sudo apt update
sudo apt install muxtop

Binaire pré-compilé (Linux / macOS)

curl -sSfL https://raw.githubusercontent.com/lanexadev/muxtop/main/scripts/install.sh | sh

Depuis les sources

git clone https://github.com/lanexadev/muxtop.git
cd muxtop
cargo build --release
# Binaire disponible dans target/release/muxtop

MSRV : Rust 1.88

Fonctionnalités

Privilèges

L'accès à la socket Docker (/var/run/docker.sock) est équivalent à un accès root sur la machine hôte : tout utilisateur du groupe docker peut lancer un conteneur privilégié et s'évader. Pour exécuter muxtop avec un budget de privilèges minimal, utilisez Podman en mode rootless — la socket utilisateur ($XDG_RUNTIME_DIR/podman/podman.sock) est isolée par utilisateur et muxtop la détecte automatiquement. Évitez de lancer muxtop-server en root sur un hôte exposé : préférez un compte de service avec uniquement la socket Podman rootless montée en lecture/écriture.

Utilisation

muxtop                              # lancement normal (autodétecte Docker/Podman)
muxtop --refresh 2                  # rafraîchissement toutes les 2 secondes
muxtop --filter firefox             # démarre avec un filtre de processus
muxtop --sort mem                   # tri par mémoire au démarrage
muxtop --tree                       # démarre en vue arborescente
muxtop --about                      # version, licence, déclaration de confidentialité

# Onglet Conteneurs — par défaut muxtop cherche $DOCKER_HOST, /var/run/docker.sock,
# puis les sockets Podman. Passez un chemin pour forcer, ou désactivez complètement :
muxtop --docker-socket /var/run/docker.sock   # override du socket
muxtop --no-containers                        # désactive la collecte conteneurs

# Démarrer le serveur (TLS + auth obligatoire)
muxtop-server --token "mon-secret-16chars" --tls-generate
muxtop-server --token "mon-secret-16chars" --tls-cert cert.pem --tls-key key.pem
muxtop-server --token "mon-secret-16chars" --tls-generate --bind 0.0.0.0:4242 --max-clients 10

# Monitoring distant (TLS)
muxtop --remote host:port --token "mon-secret-16chars" --tls-skip-verify  # dev
muxtop --remote host:port --token "mon-secret-16chars" --tls-ca cert.pem  # production
MUXTOP_TOKEN="mon-secret-16chars" muxtop --remote host:port --tls-ca cert.pem

Raccourcis clavier

Benchmarks

Testé sur macOS avec 500+ processus (benchmark Thomas) :

Lancez le benchmark vous-même :

just bench-thomas
# ou
./scripts/bench-thomas.sh

Architecture

muxtop/
├── src/                         # Point d'entrée (CLI clap + bootstrap tokio)
└── crates/
    ├── muxtop-core/             # Collecte système, modèles de données, actions
    │   ├── src/collector.rs     # Boucle async sysinfo (1 Hz) + boucle conteneurs (0.5 Hz)
    │   ├── src/process.rs       # Tri, filtrage, arbre de processus
    │   ├── src/system.rs        # Snapshots CPU / mémoire / charge
    │   ├── src/network.rs       # Interfaces réseau + historique
    │   ├── src/containers.rs    # Modèle conteneurs (ContainerSnapshot, états, engine)
    │   ├── src/container_engine.rs # Trait async + détection socket Docker/Podman
    │   └── src/docker_engine.rs # Implémentation concrète via bollard
    ├── muxtop-tui/              # Interface ratatui
    │   ├── src/app.rs           # Machine à états, gestion des événements
    │   └── src/ui/              # Onglets General, Processes, Network, Containers, palette, thème
    ├── muxtop-proto/            # Protocole filaire et sérialisation binaire
    └── muxtop-server/           # Daemon TCP pour le monitoring à distance

Développement

just check    # fmt + clippy + tests
just bench    # micro-benchmarks criterion
just dev      # vérification continue avec bacon

Feuille de route

Vie privée & télémétrie

muxtop ne collecte AUCUNE télémétrie, AUCUNE statistique et ne contacte PERSONNE. Jamais.

Il ne fait aucun appel réseau. Il est conçu pour les serveurs de production air-gappés. Si vous observez une activité réseau sortante depuis muxtop, c'est un bug — veuillez le signaler.

Contribuer

Les contributions sont les bienvenues ! Consultez CONTRIBUTING.md pour les prérequis, les conventions de code, le workflow de branches et les instructions pour soumettre une PR.

Licence

Disponible sous l'un ou l'autre des licences suivantes, à votre choix :

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT License (LICENSE-MIT)