Skip to main content

A colorful alternative to "adb logcat"

Project description

# 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/).

Project details


Release history Release notifications

History Node

0.6.0

History Node

0.5

History Node

0.4

History Node

0.3

This version
History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
logcat-color-0.2.tar.gz (7.3 kB) Copy SHA256 hash SHA256 Source None Jun 24, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page