ducktrace-tui

A terminal user interface for browsing logs and managing services – aiming to provide both good UX as well as DX.

Features

• 📁 Browse local log files (default ~/.config/duckTrace/)

• 🌐 Secure network support - using SSH

• ⚙️ List and view logs of system and user services (via journalctl)

• 🔍 Scroll through logs with arrow keys, PageUp/Down

• 👁️ Follow logs in real‑time (tail)

• 🛠️ Start, stop, restart services

• 🦆 Works seamlessly with:

  • ducktrace-loggger (Rust apps)
  • ducktrace-python (Python apps)
  • ducktrace-sh (Bash scripts)
  • sytemd (System & User service management)

Installation

NixOS (using flakes)

Add the flake input and overlay to your configuration:

{
  inputs.ducktrace-tui.url = "github:QuackHack-McBlindy/ducktrace-tui";

  outputs = { self, nixpkgs, ducktrace-tui, ... }: {
    nixosConfigurations.myMachine = nixpkgs.lib.nixosSystem {
      modules = [
        {
          environment.systemPackages = [
            ducktrace-tui.packages.${system}.default
          ];
        }
      ];
    };
    
  };}

Build from source

$ git clone https://github.com/QuackHack-McBlindy/ducktrace-tui
$ cd ducktrace-tui
$ cargo build --release
# Run the binary
./target/release/ducktrace-tui

Configuration

The TUI respects these environment variables (they override defaults):

$DT_LOG_PATH – directory containing log files (default: ~/.config/duckTrace/)
$DT_SSH_HOST - hostname of the machine to browse logs on
$DT_SSH_USER - username to connect to DT_SSH_PORT - SSH port to connect on (default: 22)

No other configuration is required – log files with the .log extension are automatically discovered.

Usage

Run ducktrace-tui in your terminal.

Keybindings

License

MIT