Skip to content

Latest commit

Β 

History

109 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CaudalGhost

El instrumento sereno que mide el caudal de tu red β€” observa, jamΓ‘s interfiere.

Licencia VersiΓ³n Plataforma Hecho por Parlox Network

EspaΓ±ol Β· English


CaudalGhost te muestra quΓ© aplicaciones y a quΓ© servidores consume tu conexiΓ³n β€” medido por interfaz y por aplicaciΓ³n con eBPF, con histΓ³rico escalonado en SQLite y un panel en vivo. Es telemetrΓ­a pura: solo observa, no es un firewall y nada llama a casa.

Tres caras

Un mismo daemon, tres formas de mirarlo:

CLI β€” caudalghost consultas de un disparo, scriptables (table/json/csv/ndjson) para cron, systemd y pipelines con jq
TUI β€” caudalghost live dashboard interactivo a pantalla completa en la terminal apps Β· interfaces Β· servidores, en vivo o histΓ³rico
GUI β€” caudalghost-gui app de escritorio con grΓ‘ficos fluidos para el dΓ­a a dΓ­a
$ caudalghost serie hoy
πŸ“ˆ serie Β· rango: hoy Β· cubo: hora
β–ƒβ–β–β–‚β–…β–‡β–ˆβ–†β–„β–ƒβ–‚β–β–‚β–ƒβ–…β–ƒβ–β–
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ tiempo      ┆        rx ┆        tx ┆     total β”‚
β•žβ•β•β•β•β•β•β•β•β•β•β•β•β•β•ͺ═══════════β•ͺ═══════════β•ͺ═══════════║
β”‚ 09:00       ┆  40.9 MiB ┆ 144.3 MiB ┆ 185.1 MiB β”‚
β”‚ 10:00       ┆  12.4 MiB ┆   3.1 MiB ┆  15.5 MiB β”‚
β”‚ 11:00       ┆   4.6 MiB ┆   2.7 MiB ┆   7.3 MiB β”‚
β”‚ Ξ£ total     ┆   1.1 GiB ┆ 402.7 MiB ┆   1.5 GiB β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

$ caudalghost top hoy -n 3 -o csv --fields app,total
app,total
firefox,820.4 MiB
thunderbird,73.2 MiB
syncthing,41.9 MiB

(datos de ejemplo)

πŸ“¦ InstalaciΓ³n

Dos ediciones .deb (Debian/Ubuntu y derivadas):

# Escritorio β€” daemon + CLI + GUI
sudo apt install ./caudalghost_0.8.1-1_amd64.deb

# Servidor headless β€” daemon + CLI (sin GUI)
sudo apt install ./caudalghost-server_0.8.1-1_amd64.deb

Descarga la ΓΊltima versiΓ³n en Releases o en caudalghost.parlox.net.

πŸ›‘οΈ Privacidad y seguridad

  • Solo observa β€” mide bytes, no inspecciona contenido ni bloquea nada (no es un firewall).
  • Nada llama a casa β€” sin telemetrΓ­a externa; tus datos viven en tu mΓ‘quina (SQLite local).
  • Sin sudo para el servicio β€” el daemon corre con capacidades acotadas (CAP_BPF/CAP_PERFMON), no como root.
  • Software libre β€” AGPL-3.0-only.

πŸ“– MΓ‘s

DocumentaciΓ³n, capturas de la GUI y el porquΓ© del diseΓ±o en caudalghost.parlox.net.


πŸ‡¬πŸ‡§ English

CaudalGhost shows you which apps and which servers your connection is talking to β€” measured per interface and per application with eBPF, with tiered history in SQLite and a live dashboard. It's pure telemetry: it only watches β€” it is not a firewall and nothing phones home.

Three faces

One daemon, three ways to look at it:

CLI β€” caudalghost one-shot, scriptable queries (table/json/csv/ndjson) for cron, systemd and jq pipelines
TUI β€” caudalghost live interactive full-screen terminal dashboard apps Β· interfaces Β· servers, live or historical
GUI β€” caudalghost-gui desktop app with fluid charts for everyday use
$ caudalghost serie hoy      # "hoy" = today
πŸ“ˆ serie Β· rango: hoy Β· cubo: hora
β–ƒβ–β–β–‚β–…β–‡β–ˆβ–†β–„β–ƒβ–‚β–β–‚β–ƒβ–…β–ƒβ–β–
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ tiempo      ┆        rx ┆        tx ┆     total β”‚
β”‚ 09:00       ┆  40.9 MiB ┆ 144.3 MiB ┆ 185.1 MiB β”‚
β”‚ Ξ£ total     ┆   1.1 GiB ┆ 402.7 MiB ┆   1.5 GiB β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

(sample data β€” the interface is currently Spanish; an English UI is planned)

πŸ“¦ Install

Two .deb editions (Debian/Ubuntu and derivatives):

# Desktop β€” daemon + CLI + GUI
sudo apt install ./caudalghost_0.8.1-1_amd64.deb

# Headless server β€” daemon + CLI (no GUI)
sudo apt install ./caudalghost-server_0.8.1-1_amd64.deb

Grab the latest build from Releases or caudalghost.parlox.net.

πŸ›‘οΈ Privacy & security

  • Watches only β€” counts bytes, never inspects content or blocks anything (not a firewall).
  • Nothing phones home β€” no external telemetry; your data stays on your machine (local SQLite).
  • No sudo for the service β€” the daemon runs with scoped capabilities (CAP_BPF/CAP_PERFMON), not as root.
  • Free software β€” AGPL-3.0-only.

πŸ“– More

Docs, GUI screenshots and the design rationale live at caudalghost.parlox.net.


Hecho con ❀ por Parlox Network · AGPL-3.0-only

About

πŸ’§ The serene instrument that measures your network's flow β€” it observes, never interferes. A local, eBPF-based Linux bandwidth monitor with a CLI, a TUI and a GUI (desktop app).

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages