Flannel takes the input from standard input (stdin), meaning, to readJSON output, pipe what you want from another command:

::

$ ./do-this-thing | flannel

Already have a log file you’d like to read? Don’t need that much extrawork done:

::

$ cat myfile.log | flannel

If you play your cards right the following window should appear:

A few things to note:

- Each key in the json log entry corresponds to

- A field in the **filter content** section. - A header in the table

- The **Show Table Headings** is an entry, where you can type in any field listed (comma seperated) and the table will show only those columns you specify. You can also order the columns.- Sometimes a program may spit out strings not in json format. That’s why I included the **Raw Output** tab, so that if things aren’t working out, you can see what went wrong. Note this is the raw output for *your program*, not for *flannel*.

It’s not an issue with flannel, but, rather, with how UNIX handlesstandard input and output. When a program writes content to theterminal, only stdout is piped. A program will typically write logentries to ``stderr``, which is not piped to ``stdin``.

**tl;dr:** Do this instead:

::

$ ./do-this-thing 2>&1 | flannel

Notice the **2>&1**. That redirects stderr to stdout. Then you shouldsee output.

Log slowing down?~~~~~~~~~~~~~~~~~

You might not want to keep *all* the logs in memory. Hitting the``[Clear]`` button next to the output table should–er–clear things up.

Requirements------------

- Python 3+- PyQt5 and up- Lord of the Config

Optionally, faker is used for the testing module``flannel.json_output``.