phos

Greek: φως "light"

A fast, universal log colorizer. 99 programs built-in, 13 themes, webhook alerts.

Install

# Homebrew (macOS/Linux)
brew install Hydepwns/phos/phos

# Cargo (crates.io)
cargo install phoscat

# Arch Linux (AUR)
yay -S phos

# Nix
nix run github:Hydepwns/phos

# Docker
docker run --rm -i mfdroo/phos

# From source
cargo install --git https://github.com/Hydepwns/phos

Usage

phos -p docker -- docker logs mycontainer    # Wrap command
docker logs myapp | phos -p docker           # Pipe mode
phos -- docker logs mycontainer              # Auto-detect program
phos -c lodestar -t dracula -- docker logs   # Ethereum client + theme

Shell Integration

Add to your shell config for automatic colorization of common commands:

# bash (~/.bashrc)
eval "$(phos shell-init bash)"

# zsh (~/.zshrc)
eval "$(phos shell-init zsh)"

# fish (~/.config/fish/config.fish)
phos shell-init fish | source

This gives you:

• p alias for phos (e.g., p -p docker -- docker logs)
• Auto-wrapped commands: git, cargo, npm, docker, kubectl, terraform, etc.
• Disable with export PHOS_NO_ALIASES=1

Pipe with Auto-Detect

# phoscat auto-detects the program from log content
docker logs mycontainer | phoscat
cargo build 2>&1 | phoscat

# Or specify explicitly
docker logs mycontainer | phoscat docker

Commands

phos list                    # List all 99 programs
phos list -c ethereum        # List by category
phos themes                  # List 13 themes
phos info docker             # Program details
phos preview                 # Preview themes

Programs (99)

See ETHEREUM.md for Ethereum-specific guides.

Themes

phos -t dracula      # Dracula
phos -t nord         # Nord
phos -t catppuccin   # Catppuccin Mocha
phos -t gruvbox      # Gruvbox
phos -t tokyo-night  # Tokyo Night
phos -t matrix       # Green monochrome

All 13: default-dark, dracula, nord, catppuccin, synthwave84, gruvbox, monokai, solarized, matrix, phosphor, tokyo-night, horizon, high-contrast

Alerting

# Discord/Telegram webhooks on errors, peer drops, sync stalls
phos -c lodestar --alert "https://discord.com/api/webhooks/xxx/yyy" \
  --alert-on error --alert-on "peer-drop:10" -- docker logs -f lodestar

Conditions: error, error-threshold:N, peer-drop:N, sync-stall, pattern:REGEX

Statistics

phos -p docker --stats -- docker logs mycontainer
phos -p docker --stats-export json -- docker logs mycontainer
docker logs -f myapp | phos -p docker --stats-interval 30

Custom Programs

Create ~/.config/phos/programs/myapp.yaml:

name: myapp
category: custom
detect: [myapp]
rules:
  - regex: '\[ERROR\]'
    colors: [error]
    bold: true

Custom Themes

Create ~/.config/phos/themes/mytheme.yaml:

name: mytheme
palette:
  red: "#FF5555"
  green: "#50FA7B"
  cyan: "#8BE9FD"

Library

use phos::{Colorizer, Theme, programs};

let registry = programs::default_registry();
let program = registry.get("docker").unwrap();
let mut colorizer = Colorizer::new(program.rules()).with_theme(Theme::dracula());
println!("{}", colorizer.colorize("container abc123 started"));

Performance

Acknowledgments

Inspired by grc (Generic Colouriser) by Radovan Garabik.

License

MIT OR Apache-2.0