logserver

pager designed for rapid navigation with multiple keyword searching on giant log files

requirements

• libz-dev
• libncurses-dev
• catch2 (for unit tests)

That's it.

building

project uses cmake:

• create a build subdirectory
• cmake ..
• make
• optionally sudo make install or copy logserver to your $PATH

packaging

• cmake -B build -S . -DCMAKE_BUILD_TYPE=Release
• cmake --build build
• cpack --config build/CPackConfig.cmake

using

• command-stdout | logserver
• logserver filename

keybindings

h for help!

          q: quit
          h: help page (this)
          n: toggle line numbers
          c: toggle colours
          !: insert line marker
          s: save current line to /tmp/logserver_save
          S: save current view to /tmp/logserver_save
          b: break a long line into reasonable length new lines
          B: breaks the line using the next keypress as breakpoint (e.g., comma, semicolon, etc.)
          i: give more info for a line (repeat to try harder)
          I: give more info for a bunch of lines around (repeat to try harder and farther)
          t: toggle tab inference
          dd: delete line
          |: begin a pipe command
          :: go to a line number
          t: turn on tab inferrance and tabbbing
          y: copy current line to system clipboard
          #: write a comment, gets saved in a file called storytime.txt with nearby context lines
          e: edit the current line (useful to tidy for a screenshot)
          S: save the file (takes a filename)
          s: save the current line (takes a filename)
          C: wipes entire contents but keeps streaming in new data


 (navigation)
     arrows: move in that direction
  G or HOME: move to top line
   T or END: move to bottom line
    PAGE-UP: move up some lines (shift for many lines)
  PAGE-DOWN: move down some lines (shift for many lines)
 shift-HOME: move to start of current line
  shift-END: move to end of current line
 shift-LEFT: move to previous matching keyword on line
shift-RIGHT: move to next matching keyword on line
 shift-DOWN: move to next matching keyword downwards
   shift-UP: move to next matching keyword upwards
          J: set a jump point at line
          j: go to next jump point

(search)
          /: start a search
          ^: start a left anchored search
          $: start a right anchored search
          \: start a remove search
          +: add lines of context around matches
          -: remove lines of context around matches      
          p: pin the current line so it appears in searches
      ENTER: finish search term
  BACKSPACE: remove the last search term
         TAB: switch between ALL (off), AND and OR mode for search terms

 (stacks)
           %: filter current matching lines into a new page, if in ALL mode then takes content between nearest line markers in each direction (i.e., from !)
         ESC: pop current page, go back to old one
       ENTER: finish a pipe and run command to new view
           <: moves left on view stack
           >: moves right on view stack