Terminal user interface for journalctl, file system logs, as well Docker and Podman containers for quick viewing and filtering with fuzzy find and regex support (like fzf and grep), written in Go with the awesome-gocui (fork gocui) library.

This tool is inspired by and with love for lazydocker and lazygit.

Functional

• Simple installation, to run it, just download a single executable file without dependencies.
• List of all units (services, sockets, etc.) via systemctl with current running status.
• View all system and user journals via journalctl (tool for reading logs from systemd-journald).
• List of all system boots for kernel log output.
• File system logs (example, for Apache or Nginx), as well as syslog or messages, dmesg (kernel), etc.
• List of all log files of descriptors used by processes, as well as all log files in the home directories of users.
• Reading archived logs (gz format).
• Podman pods, Docker containers and Swarm services logs for all systems.
• Displays the currently selected log and filters output in real-time.

Supports 3 filtering modes:

• Default - case sensitive exact search.
• Fuzzy - custom inexact case-insensitive search (searches for all phrases separated by a space anywhere on a line).
• Regex - search with regular expression support (based on regexp library), case insensitive by default (in case a regular expression syntax error occurs, the input field will be highlighted in red).

Roadmap

This is an up-to-date roadmap in addition to the functionality described above.

• File system support for MacOS and the RHEL based systems.
• Syntax coloring for logging output (like tailspin).
• Interface for scrolling and mouse support.
• Windows support (Windows Events via PowerShell and log files from Program Files and others directories).
• Support remote machines via ssh protocol.

Install

Binaries for the Linux operating system are available on the releases page.

Development is carried out on the Ubuntu Server system, and is also tested on the Raspberry Pi (aarch64 platform), the WSL environment on the Oracle Linux system and the Darwin system (x64 platform).

Run the command in the console to quickly install or update the stable version on Linux or MacOS:

curl https://raw.githubusercontent.com/Lifailon/lazyjournal/main/install.sh | bash

This command will run a script that will download the latest executable from the GitHub repository into your current user's home directory along with other executables (or create a directory) and grant execution permission.

You can also use Go for install the dev version. To do this, the Go interpreter must be installed on the system, for example, in Ubuntu you can use the SnapCraft package manager:

sudo snap install go --classic
grep -F 'export PATH=$PATH:$HOME/go/bin' $HOME/.bashrc || echo 'export PATH=$PATH:$HOME/go/bin' >> $HOME/.bashrc && source $HOME/.bashrc

go install github.com/Lifailon/lazyjournal@latest

You can launch the interface anywhere (no parameters are used):

lazyjournal

Access to all system logs and containers may require elevated privileges for the current user.

Windows is not currently supported, but the project will work to access Docker and Podman containers logs.

Build

Clone the repository, install dependencies from go.mod and run the project:

git clone https://github.com/Lifailon/lazyjournal
cd lazyjournal
go mod tidy
go run main.go

Build executable files for different platforms and all systems:

bash build.sh

Hotkeys

• Tab - switch between windows.
• Shift+Tab - return to previous window.
• Left/Right - switch between log lists in the selected window.
• Enter - selection a journal from the list to display log.
• Up/Down - move up or down through all journal lists and log output, as well as changing the filtering mode in the filter window.
• <Shift/Alt>+<Up/Down> - quickly move up or down (every 10 or 500 lines) through all journal lists and log output.
• Ctrl+R - refresh the current log manually and go to the bottom of the output.
• Ctrl+<D/W> - clear text input field for filter to quickly update current log output without filtering.
• Ctrl+C - exit.

Contributing

Any contribution is welcome. If you want to implement a feature or fix something, please open an issue first.

Alternatives

• lnav - The Logfile Navigator is a log file viewer for the terminal.
• Dozzle - is a small lightweight application with a web based interface to monitor Docker logs.

If you like using TUI tools, try multranslate for translating text in multiple translators simultaneously, with support for translation history and automatic language detection.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Copyright (C) 2024 Lifailon (Alex Kup)