Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chrispenner/lumberjack
A terminal-ui log watcher written in Go using the Flux architecture
https://github.com/chrispenner/lumberjack
cli logging tools viewer
Last synced: 3 months ago
JSON representation
A terminal-ui log watcher written in Go using the Flux architecture
- Host: GitHub
- URL: https://github.com/chrispenner/lumberjack
- Owner: ChrisPenner
- License: mit
- Created: 2016-05-14T04:39:15.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-05-16T02:48:22.000Z (over 7 years ago)
- Last Synced: 2024-06-20T03:56:12.973Z (7 months ago)
- Topics: cli, logging, tools, viewer
- Language: Go
- Homepage:
- Size: 1.31 MB
- Stars: 38
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LumberJack [](https://circleci.com/gh/ChrisPenner/LumberJack)
[Download Binary](https://github.com/ChrisPenner/LumberJack/releases/latest)
## What is it?
A command-line interface log viewer
## Why did I build it
I got really sick of trying to find the things I was looking for in a big blob of unstructured text.
Printing my logs out to the terminal just wasn't sufficient anymore.
## What's it do?
Well, first and foremost it show your logs...
It can also:
- Stream logs into the viewer as they occur
- Filter to only show lines matching a given search term or regular expression
- Perform a search (from the latest logs upwards of course)
- Display logs from multiple servers side by side
- Display multiple views into the same log file
- Highlight text matching a given regular expression
## Install
### Binary
The simplest method is to download a binary for your platform here:
[Download Binary](https://github.com/ChrisPenner/LumberJack/releases/latest)
### Homebrew
```
brew update
brew install chrispenner/tools/lumberjack
```
### Source
Or you can install from source:
Assuming `go` is installed:
```bash
$ go get github.com/chrispenner/lumberjack
$ $GOPATH/bin/lumberjack logs1 logs2
```
Put `$GOPATH/bin` on your `$PATH` to use the `lumberjack` command.
## Keybindings
### Log view:
- ``: Select a log-file for the current pane
- ``: Toggle the filters/highlighters side-pane
- `?` or `/`: Start a search
- `w`: Toggle text-wrapping
- `^h` and `^l`: Switch panes left and right respectively
- `` and ``: Scroll 1 line at a time
- `b` or `^u`: Scroll up half a screen
- `^d`: Scroll down half a screen
- `G`: Scroll to bottom (latest) logs
- `n`: Find next occurrance
- `N`: Find previous occurrance
- `1-4`: Display 1-4 panes respectively
- ` + 0-9`: Toggle the respective filter/highlighter
### Filter/Highlighter pane:
- ``: Toggle the filters/highlighters side-pane
- ``: Edit the current modifier
- ``: Toggle the current modifier
- `j`: Move down one modifier
- `k`: Move up one modifier