ctail — Cross-Platform Log Tail Viewer with Highlighting

ctail — short for color tail — is a desktop log file viewer built with Wails v2 (Go backend + Svelte frontend). Think tail -f, but with regex-powered color highlighting, multiple tabs, and a full GUI. Inspired by BareTail. Supports Windows, Linux, and macOS.

📖 User Manual — Full documentation on features, settings, and usage.

Screenshots

Features

• Multi-tab interface — Open multiple log files simultaneously with keyboard navigation (Ctrl+Tab / Ctrl+Shift+Tab)
• Tab drag-and-drop — Reorder tabs by dragging them to new positions
• Tab toggle — Quick Ctrl+Tab toggles between the two most recent tabs
• Real-time tailing — Follow mode streams new lines as they're written, with automatic enable/disable on scroll
• Regex-based highlighting — Rules with foreground/background colors, bold/italic, line-level or match-level matching
• Sliding window buffer — Memory-bounded scrolling through large files; only a configurable window of lines (default 500) is kept in memory
• Profile system — Multiple highlighting profiles with visual rule preview and drag-and-drop reordering
• AI assistant — Ask AI about your logs or auto-generate highlighting rule profiles. Supports GitHub Copilot, GitHub Models, OpenAI, and any OpenAI-compatible server (Ollama, LM Studio, etc.)
• Non-blocking I/O — Files on slow or unreachable network mounts (NFS, CIFS/SMB, SSHFS) won't freeze the UI; all file operations run in the background with timeouts
• Session persistence — Window position/size, open tabs, active profile, and all settings survive restarts
• Recent files — Quick access to recently opened files from the File menu
• Native menu bar — File, Edit, View, Tools, and Help menus with standard keyboard accelerators
• Context menus — Right-click tabs for close/close others, right-click logs for copy/select/AI assist
• Search — Ctrl+F to filter lines within the buffer
• Check for updates — Manual update check from the Help menu
• Themes — 21 built-in color themes (Catppuccin, Nord, Tokyo Night, Gruvbox, Dracula, One Dark, Solarized, Everforest, Ayu, Kanagawa, Matrix, Rosé Pine, Monokai, and more), each with dark and light modes. Supports custom themes via JSON files.
• Cross-platform — Linux, Windows, and macOS

Quick Start

Prerequisites

• Go 1.21+
• Node.js 18+
• Wails CLI v2
• Linux: libgtk-3-dev, libwebkit2gtk-4.1-dev (Ubuntu 24.04+) or libwebkit2gtk-4.0-dev
• Windows: WebView2 (included in Windows 10/11)

Build & Run

# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# Run in dev mode (hot reload)
make dev

# Build for production
make build

# Run tests
make test

Note: On Ubuntu 24.04+ / Zorin OS 18, the webkit2_41 build tag is required (handled automatically by the Makefile). Override with make dev TAGS= on systems with webkit2gtk-4.0.

Install (Linux)

After building, install system-wide with desktop integration:

make build
sudo make install

This installs the binary to /usr/local/bin/, a .desktop file for application launchers, and icons at all standard sizes. Uninstall with sudo make uninstall.

Linux Packages (deb/rpm)

Build .deb or .rpm packages with proper dependencies (libgtk-3-0, libwebkit2gtk-4.1-0):

# Requires nfpm: go install github.com/goreleaser/nfpm/v2/cmd/nfpm@latest
make package-deb    # → build/ctail_0.4.0_amd64.deb
make package-rpm    # → build/ctail-0.4.0-1.x86_64.rpm

# Install
sudo dpkg -i build/ctail_0.4.0_amd64.deb   # Debian/Ubuntu
sudo rpm -i build/ctail-0.4.0-1.x86_64.rpm  # Fedora/RHEL

Architecture

Go Backend                          Svelte Frontend
┌──────────────┐                    ┌──────────────────┐
│ File Tailer  │ ──Wails Events──▶  │ Tab Bar          │
│ (polling,    │                    │ Log View (scroll)│
│  offset idx) │                    │ Highlighted Lines│
├──────────────┤                    ├──────────────────┤
│ Config Mgr   │ ◀──Wails Bind──▶  │ Settings Panel   │
│ (JSON files) │                    │ Rule Editor      │
├──────────────┤                    ├──────────────────┤
│ Rule Engine  │                    │ Highlight Utils  │
│ (regex)      │                    │ (client-side)    │
├──────────────┤                    ├──────────────────┤
│ AI Client    │ ◀──Wails Bind──▶  │ AI Dialog        │
│ (multi-      │                    │ (chat, rules gen)│
│  provider)   │                    │                  │
└──────────────┘                    └──────────────────┘

• Go backend handles file I/O (polling + direct seek via byte offset index), configuration persistence, the rules engine, and AI provider communication
• Svelte frontend handles rendering, client-side highlighting (for instant rule feedback), scroll buffer management, and the AI assistant dialog
• Communication via Wails bindings (sync method calls) and events (async streaming)
• No external Go dependencies beyond Wails itself

Menu Bar

Themes

ctail ships with 21 built-in color themes, each with dark and light modes:

Switch themes in Settings → Theme and toggle between dark/light with View → Toggle Theme.

🎨 Credits: The built-in theme palettes are inspired by and adapted from OpenCode by Anomaly, which provides a wonderful collection of editor color themes. Thank you for making great design accessible to everyone!

Custom Themes

Create your own themes by dropping a JSON file in the themes directory. See the Custom Themes Guide for full documentation, examples, and tips on adapting VS Code themes.

Configuration

Config files are stored in platform-specific directories:

See the User Manual for details on all settings and configuration options.

Keyboard Shortcuts

Known Issues

Multi-monitor maximize on Wayland (Linux)

On Wayland with multiple monitors of different resolutions, the maximize button may use the wrong monitor's dimensions. This is an upstream bug in GTK/WebKit2GTK affecting all Wails v2 apps.

Workaround: Use the --x11 flag to force the X11 backend:

ctail --x11

License

MIT