Go to file
Maciej Winnicki 79f63d39fb Some parameters moved from jshint to jscs 2014-10-07 23:40:55 +02:00
bin Moved to index.js 2013-08-22 17:46:35 +02:00
lib Tests and README update 2014-10-06 22:55:51 +02:00
preset Tests and README update 2014-10-06 22:55:51 +02:00
test Tests and README update 2014-10-06 22:55:51 +02:00
.gitignore jscs check 2014-10-05 14:33:25 +02:00
.jscsrc Some parameters moved from jshint to jscs 2014-10-07 23:40:55 +02:00
.jshintignore lint fixes 2013-11-01 23:36:45 +02:00
.jshintrc Some parameters moved from jshint to jscs 2014-10-07 23:40:55 +02:00
.travis.yml jscs check 2014-10-05 14:33:25 +02:00
LICENSE License in separate file 2013-11-24 12:26:44 +01:00
README.md Tests and README update 2014-10-06 22:55:51 +02:00
index.js Tests and README update 2014-10-06 22:55:51 +02:00
package.json temp package update because of travis build failure 2014-10-05 14:57:07 +02:00

README.md

frontail(1) realtime log stream in the browser

frontail is node.js application for serving tail -F output to browser.

Build Status NPM version

Features

  • search (Tab to focus, Esc to clear)
  • user basic authentication
  • log rotation
  • auto-scrolling
  • marking logs
  • themes (default, dark)
  • number of unread logs in favicon

Installation

npm install frontail -g

Usage

frontail [options] [file ...]

Options:

  -h, --help                    output usage information
  -V, --version                 output the version number
  -h, --host <host>             listening host, default 0.0.0.0
  -p, --port <port>             listening port, default 9001
  -n, --number <number>         starting lines number, default 10
  -l, --lines <lines>           number on lines stored in browser, default 2000
  -t, --theme <theme>           name of the theme (default, dark)
  -d, --daemonize               run as daemon
  -U, --user <username>         Basic Authentication username, option works only along with -P option
  -P, --password <password>     Basic Authentication password, option works only along with -U option
  -k, --key <key.pem>           Private Key for HTTPS, option works only along with -c option
  -c, --certificate <cert.pem>  Certificate for HTTPS, option works only along with -k option
  --pid-path <path>             if run as daemon file that will store the process id, default /var/run/frontail.pid
  --log-path <path>             if run as daemon file that will be used as a log, default /dev/null
  --ui-hide-topbar              hide topbar (log file name and search box)
  --ui-no-indent                don't indent log lines
  --ui-highlight [path]         highlight words or lines if defined string found in logs, default preset ./preset/default.json

Web interface is on http://localhost:[port].

Highlighting

--ui-highlight option turns on highlighting in UI. By default preset from ./preset/defatult.json is used:

{
    "words": {
        "err": "color: red;"
    },
    "lines": {
        "err": "font-weight: bold;"
    }
}

which means that every "err" string will be in red and every line with "err" will be bolded.

Screenshot

screenshot1