Toolong

Terminal log viewer that tails, merges, and searches log files and JSONL, with web server log highlighting and support for multi-gigabyte files.

install

Toolong is a terminal UI for reading log files, started with the tl command. It was intended as a replacement for the tail + less combination (hence its earlier working name, Tailless). It supports live tailing, scrolling through existing content, and searching, and it highlights the syntax of common web server log formats.

Files are opened by passing names to tl. Multiple files open in tabs, and the --merge switch combines several files into a single view by auto-detecting timestamps, for example tl access.log* --merge. It opens gzip (.gz) and bzip2 (.bz2) compressed logs. JSONL files are pretty printed line by line. It supports viewing multi-gigabyte log files. Output from another process can also be piped in, e.g. tree / | tl. Pressing f1 inside the app shows help.

Toolong is aimed at developers and operators who inspect logs, particularly on servers over ssh. It runs on Linux, macOS, and Windows. The README names lnav as a more mature alternative, and credits the LogMerger project as a reference for its timestamp regexes. It is written in Python and built by the Textualize author.

Installation

# via pipx
pipx install toolong
# via pip
pip install toolong

Toolong displaying JSONL records and a formatted record detail

Alternatives & related tools

add a badge to your README

Maintain Toolong? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/toolong.svg)](https://www.trmn.sh/tools/toolong?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/toolong?utm_source=badge"><img src="https://www.trmn.sh/badge/toolong.svg" alt="Featured on trmn" height="20"></a>