Easy-to-use log file monitor and analyzer with various highlighting features
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
colors
core
docs
filters
icons
samples
snippets
wiki
CHANGELOG
CONTACT
LICENSE
README
README.md
REQUIREMENTS
compat.sh
install.sh
salomon.cfg
salomon.png
salomon.sh

README.md

SaLoMon SaLoMon logo

Table of contents


Definition

The SaLoMon project is a simple log file monitor and analyzer with various filter and highlighting features which can also be used with other text files.

Top

Details

SaLoMon sample outputThe project was primarily built to monitor and analyze log files inside a terminal emulator and also on systems without a graphical user interface. Of course, you can use SaLoMon to also process (most likely analyze) other plain text files of any kind.

The input files will be processed line by line.

Each line can easily be colorized with a user-defined color (and additionally highlighted in different ways) depending on given criteria. For example, all lines which contain the word "error" can be displayed red and those that contain the word "success" can be displayed green (as shown above). Furthermore, the output can be filtered to only return certain lines instead of all.

SaLoMon interactive dialogThere are various additional combinable features such as multiple ways to filter the output (e. g. by using exclude and remove patterns) and different methods to additionally highlight the filter terms. The output can also be paused or slowed down with a user-defined delay.

Furthermore, as you can see on the right, there is the option to use interactive dialogs instead of or in combination with command-line arguments which is useful when e. g. running SaLoMon via shortcut in a terminal window on a graphical user interface.

Top

Usage

Quick start

You can get started with SaLoMon in less than two minutes by reading the quick start guide.

Documentation

You can find a fundamental documentation inside the wiki.

In the docs sub-directory of the project, there are plain text files containing a detailed documentation for each component with further information and usage examples.

Top

Requirements

The SaLoMon project was developed on (and for) the Bash shell, which is the default shell on many Unix-like systems (or at least Linux distributions).

Furthermore, it uses popular shell utilities that should be pre-installed by default, see the included REQUIREMENTS file for details.

Top

Support the project

You do not need to be a software developer to support and improve the SaLoMon project.

For example, if you have created a color config file for a log file which you want to share, you can send it to me so I can add it to the color config files distributed with SaLoMon.

This also applies to suggestions, requests and improvements for color config files.

Top

Contact

Any suggestions, questions, bugs to report or feedback to give?

You can contact me by sending an email to dev@urbanware.org.

Further information can be found inside the CONTACT file.

Top

Useless facts

Whoever cares can find them here.

Top