skip to navigation
skip to content

Not Logged In

logcat-color 0.2

A colorful alternative to "adb logcat"

Latest Version: 0.6.0

# logcat-color
A colorful alternative to the standard `adb logcat` command from the Android SDK.

# Installation

**Installation with pip / easy_install** (may require sudo)

    $ pip install logcat-color
    .. or ..
    $ easy_install logcat-color

**Installation from source** (requires setuptools, may require sudo)

    $ python setup.py install


## <a id="configuration"></a>Configuration

logcat-color supports a configuration file at `$HOME/.logcat-color`

The configuration file is simply a python script, with a few interesting variables
and types available to it.

**Sample .logcat-color**

    # Width of the TAG column, default is 20
    tag_width = 20

    # Width of the PID column, default is 8
    pid_width = 8

    # Width of priority (log level) column, default is 3
    priority_width = 3


## <a id="profiles"></a> Profiles

Profiles allow logcat-color to customize logging even further.

In short, a single Profile can:
- Filter certain tags, priorities, or messages
- Use certain command line arguments
- Customized display and color configuration

Profiles live in the [logcat-color configuration file](#configuration). Here is an example:

    Profile(name = "radio",
        # Enable both radio and main buffers (-b radio -b main)
        buffers = ("radio", "main"),

        # Only pay attention to the RIL and RILC tags, and give them custom colors
        # Valid colors: RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE
        tags = {
            "RIL": BLUE,
            "RILC": GREEN
        },

        # Only look at these priority levels
        # Valid priorities: V (verbose), D (debug), I (info), W (warn), E (error), F (fatal)
        priorities = [ "I", "W", "E" ],

        # Only pay attention to log messages that match any of these filters
        # Each string is compiled as a regular expression.
        # Functions are called with the tag, priority, and message and
        # must return True to include the message in the log output.
        filters = [
          r"My Custom Regex",
          lambda tag, priority, message: message == "Custom filter"
        ]
    )


## Examples

Run and colorify `adb logcat`

    $ logcat-color

Colorify an old logcat text file you have laying around

    $ logcat-color < /path/to/my.log

Pipe logcat-color to egrep for only the tags you care about

    $ logcat-color -e | egrep '(Tag1|Tag2)'

Run logcat-color with a custom profile for filters, colors, and custom arguments (see [Profiles](#profiles))

    $ logcat-color <profile-name>

logcat-color also supports most of the standard adb / logcat arguments, making it a suitable full-time replacement for `adb logcat`

    $ alias logcat=/path/to/logcat-color
    $ logcat -e
    $ logcat -d
    $ logcat -s 123456789 -b radio -b main

## Thanks

Thanks to [Jeff Sharkey](http://jsharkey.org) for the original script that logcat-color is based on, [coloredlogcat.py](http://jsharkey.org/blog/2009/04/22/modifying-the-android-logcat-stream-for-full-color-debugging/).
 
File Type Py Version Uploaded on Size
logcat-color-0.2.tar.gz (md5) Source 2012-06-24 7KB
  • Downloads (All Versions):
  • 15 downloads in the last day
  • 112 downloads in the last week
  • 636 downloads in the last month