rogcat

A adb logcat wrapper. Features:

• Painted adb logcat
• Log to files
• Split files into chunks of a given size
• Filter on tag, message, pid or tid
• Capture (< Android 7) bugreports into (zipped) files
• Higlight patterns on terminal output
• Read from stdin, adb or files
• Log via adb shell log with input from stdin

Usage

``` rogcat 0.2.6-pre Felix Obenhuber felix@obenhuber.de A 'adb logcat' wrapper and log processor

USAGE: rogcat [FLAGS] [OPTIONS] [COMMAND] [SUBCOMMAND]

FLAGS: --no-timestamp No timestamp in terminal output --overwrite Overwrite output file if present --shorten-tags Shorten tags by removing vovels if too long for terminal format --show-date Show month and day in terminal output --show-time-diff Show the time difference between the occurence of equal tags in terminal output -c, --clear Clear (flush) the entire log and exit -g, --get-ringbuffer-size Get the size of the log's ring buffer and exit --help Prints help information -S, --output-statistics Output statistics -r, --restart Restart command on exit -V, --version Prints version information

OPTIONS: -a, --filename-format Select format for output file names. By passing 'single' the filename provided with the '-o' option is used. 'enumerate' appends a file sequence number after the filename passed with '-o' option whenever a new file is created (see 'records-per-file' option). 'date' will prefix the output filename with the current local date when a new file is created [values: single, enumerate, date] -f, --file-format Select format for output files [values: csv, html, raw] -l, --level Minimum level [values: trace, debug, info, warn, error, fatal, assert, T, D, I, W, E, F, A] -n, --records-per-file Write n records per file. Use k, M, G suffixes or a plain number -e, --terminal-format Select format for stdout [default: human] [values: human, raw, csv] -h, --highlight ... Highlight messages that match this pattern in RE -i, --input ... Read from file instead of command. Use 'serial://COM0@11520,8N1 or similiar for reading a serial por -m, --message ... Message (payload) filters in RE2. The prefix ! inverts the match -o, --output

Write output to file -t, --tag ... Tag filters in RE2. The prefix '!' inverts the match

ARGS: Optional command to run and capture stdout from. Pass "-" to capture stdin'. If omitted, rogcat will run "adb logcat -b all" and restarts this commmand if 'adb' terminate

SUBCOMMANDS: bugreport Capture bugreport. This is only works for Android versions < 7. completions Generates completion scripts devices Show list of available devices help Prints this message or the help of the given subcommand(s) log Add log message(s) log buffer ```

``` rogcat-bugreport Capture bugreport. This is only works for Android versions < 7.

USAGE: rogcat bugreport [FLAGS] [FILE]

FLAGS: --overwrite Overwrite report file if present -z, --zip Zip report -h, --help Prints help information -V, --version Prints version information

ARGS: Output file name - defaults to -bugreport ```

``` rogcat-log Add log message(s) log buffer

USAGE: rogcat log [OPTIONS] [MESSAGE]

FLAGS: -h, --help Prints help information -V, --version Prints version information

OPTIONS: -l, --level Log on level [values: trace, debug, info, warn, error, fatal, assert, T, D, I, W, E, F, A] -t, --tag Log tag

ARGS: Log message. Pass "-" to capture from stdin' ```

``` rogcat-completions Generates completion scripts

USAGE: rogcat completions

FLAGS: -h, --help Prints help information -V, --version Prints version information

ARGS: The shell to generate the script for [values: bash, fish, zsh] ```

Bugs

There are plenty. Please report on GitHub, or - even better - open a pull request.

Licensing

Rogcat is open source software; see COPYING for details.