big-dream / klogg

Really fast log explorer based on glogg project

Home Page:https://klogg.filimonov.dev

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

media_small

GitHub license C++ GitHub contributors PRs Welcome Codacy Badge

Github all releases Github

Packaging status

Check GitHub releases for Windows installers and Linux/Mac packages.

Development status

Next milestone Ready for testing Need documentation GitHub commits CI Build and Release

Chat on Discord Join the chat at https://gitter.im/klogg_log_viewer/community

Overview

Klogg is a multi-platform GUI application that helps browse and search through long and complex log files. It is designed with programmers and system administrators in mind and can be seen as a graphical, interactive combination of grep, less, and tail.

Klogg main window

Please refer to the documentation page for how to use Klogg.

Latest testing builds

Windows Linux Mac
continuous-win continuous-linux continuous-osx

Table of Contents

  1. About the Project
  2. Installation
  3. Building
  4. How to Get Help
  5. Contributing
  6. License
  7. Authors

About the Project

Klogg started as a fork of glogg - the fast, smart log explorer in 2016.

Since then it has evolved from fixing small annoying bugs to rewriting core components to make it faster and smarter that predecessor.

Development of klogg is driven by features my colleagues and I need to stay productive as well as feature requests from users on Github and in glogg mailing list.

Latest news about klogg development can be found at https://klogg.filimonov.dev.

Comparing with glogg

Klogg has all best features of glogg:

  • Runs on Unix-like systems, Windows and Mac thanks to Qt5
  • Is fast and reads the file directly from disk, without loading it into memory
  • Can operate on huge text files (10+ Gb is not a problem)
  • Search results are displayed separately from original file
  • Supports Perl-compatible regular expressions
  • Colorizes the log and search results
  • Displays a context view of where in the log the lines of interest are
  • Watches for file changes on disk and reloads it (kind of like tail)
  • Is open source, released under the GPL

And on top of that klogg:

  • Is heavily optimized using multi-threading and SIMD
  • Supports logical combinations of search patterns
  • Supports many common text encodings
  • Detects file encoding automatically using uchardet library (supports utf8, utf16, cp1251 and more)
  • Can limit search operations to some part of huge file
  • Allows to configure several highlighters sets and switch between them
  • Has a scratchpad window for taking notes and doing basic data transformations
  • Provides lots of small features that make life easier (closing tabs, copying file paths, favorite files menu, etc.)

Here is a small demo showing how much faster klogg is (searching in ~1Gb file stored on tmpfs):

klogg_vs_glogg.mp4

List of glogg issues that have been fixed/implemented in klogg can be found here.

Prominent features of dev-builds compared to latest stable release:

  • support for files with more than 2147483647 lines
  • much faster regular expressions search (2-4 times)
  • ability to combine regular expressions with boolean operators (AND, OR, NOT)
  • configurable shortcuts
  • list of configurable predefined regular expression patterns
  • better dark mode
  • build scripts allow to use more dependencies from OS packages instead of vendored versions

List of all changes can be found here.

Back to top

Installation

This project uses Calendar Versioning. For a list of available versions, see the repository tag list.

Current stable release builds

Current release is 20.12. Binaries for all platforms can be downloaded from GitHub releases.

Release

Windows

Windows installer is also available from Chocolatey:

Chocolatey

Mac OS

Package for Mac can be installed from Homebrew

homebrew cask

Linux

It is recommended to use klogg package from distribution-specific repositories.

Generic packages are available from klogg DEB and RPM repositories hosted at JFrog Artifactory. They are built to run on Ubuntu 16.04 and Centos 8 (x86-64 only).

For DEB add klogg artifactory repository, then install from apt:

echo deb [trusted=yes] https://favpackage.jfrog.io/artifactory/klogg_deb stable utils | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-get install klogg

For RPM create klogg repo file in /etc/yum.repos.d/klogg-rpm.repo with this content:

[Klogg]
name=Klogg
baseurl=https://favpackage.jfrog.io/artifactory/klogg_rpm/
enabled=1
gpgcheck=0

Then install using yum

sudo yum update
sudo yum install klogg

Testing builds

CI Build and Release

Windows Linux Mac
continuous-win continuous-linux continuous-osx

Back to top

Building

Please review BUILD.md for how to setup Klogg on your local machine for development and testing purposes.

How to Get Help

First, please refer to the documentation page.

You can open issues using klogg issues page or post questions to glogg development mailing list.

Contributing

We encourage public contributions! Please review CONTRIBUTING.md for details on our code of conduct and development process.

License

This project is licensed under the GPLv3 or later - see COPYING file for details.

Authors

See also the list of contributors who participated in this project.

Back to top

About

Really fast log explorer based on glogg project

https://klogg.filimonov.dev

License:GNU General Public License v3.0


Languages

Language:C++ 83.1%Language:CMake 5.8%Language:CSS 2.4%Language:JavaScript 1.9%Language:HTML 1.8%Language:SCSS 1.3%Language:C 1.2%Language:NSIS 1.0%Language:Python 0.8%Language:Batchfile 0.3%Language:AppleScript 0.1%Language:Dockerfile 0.1%Language:Shell 0.1%Language:PowerShell 0.1%