logcatf

Logcatf

A Command line tool for format Android Logcat.

Use like this.

$ adb logcat -v time | logcatf --color

Output:

Examples

# show time, pid and message formatted.
$ adb logcat -v time | logcatf "%t %4i %m"

# output to csv format.
$ adb logcat -v threadtime | logcatf --to-csv > logcat.csv

# get screencap on Exception
$ adb logcat -v time | logcatf -o "MY_APP.*Error" -c "adb shell screencap -p /sdcard/a.png"

Install

You can get binary from github release page.

-> Release Page

or, use go get:

$ go get github.com/ujiro99/logcatf

Basic Usage

$ adb logcat -v time | logcatf "%t, %m"

Available Format:

Other Flags:

Default Format:

"%t %p %a: %m"

Options

execute commands

You can execute other commands when a keyword matched to Logcat.

-o, --on=ON              regex to trigger a COMMAND.
-c, --command=COMMAND    COMMAND will be executed on regex matched.

• In COMMAND, you can use parsed logcat value using keyword same as format or environment variables.

ex) -o "MY_APP.*Error" -c "echo %m > error.log"
    -o "MY_APP.*Error" -c "echo \${message} > error.log"  # linux, mac
    -o "MY_APP.*Error" -c "echo %message% > error.log"    # Windows

• Command's stdout is redirected to stderr of logcatf.
• You can use multiple -o / -c pairs.

Output CSV

output to CSV format.

    --to-csv             output to CSV format. double-quote will be escaped.
    --encode=ENCODE      output character encode. { utf-8 | shift-jis | euc-jp | iso-2022-jp }

• if use on Windows, encode will be used shift-jis.

Color

specify output Color.

    --color            enable ANSI color. ( defalult = false )
    --color-v=COLOR    - color for verbose.
    --color-d=COLOR    - color for debug.
    --color-i=COLOR    - color for information.
    --color-w=COLOR    - color for warning.
    --color-e=COLOR    - color for error.
    --color-f=COLOR    - color for fatal.

• This function uses mitchellh/colorstring.
• In format string, you can use color tags.

ex) $ adb logcat | logcatf "%t [invert] %a [reset] [_white_] %m" --color --color-i "cyan"

Available Color Tags:

Contribution

1. Fork (https://github.com/ujiro99/logcatf/fork)
2. Create a feature branch
3. Commit your changes
4. Rebase your local changes against the master branch
5. Run test suite with the go test ./... command and confirm that it passes
6. Run gofmt -s
7. Create a new Pull Request

Author

ujiro99