diff --git a/CHANGELOG.md b/CHANGELOG.md index 9606899..c36c78a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,7 @@ Change Log ========== -Unreleased +Version 2.2.0 *(2026-07-20)* ---------------------------- * New: Interactive full-screen filter UI, on by default when both stdin and stdout are a diff --git a/README.md b/README.md index 58b4f1b..01e5492 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,11 @@ -PID Cat -======= +PID Cat REPL +============ -An update to Jeff Sharkey's excellent [logcat color script][1] which only shows -log entries for processes from a specific application package. +A fork of [JakeWharton/pidcat][5], which is itself an update to Jeff Sharkey's +excellent [logcat color script][1]. Both filter `adb logcat` down to the log +entries for a specific application package; this fork adds an interactive, +full-screen filter UI on top, turning `pidcat` into more of a REPL than a +one-shot stream. During application development you often want to only display log messages coming from your app. Unfortunately, because the process ID changes every time @@ -14,6 +17,10 @@ convenient development process. pidcat com.oprah.bees.android +If you just want the original, non-interactive `pidcat`, use the upstream +[JakeWharton/pidcat][5] project or pass `--plain` here, see [Interactive +mode](#interactive-mode) below. + Here is an example of the output when running for the Google Plus app: @@ -41,7 +48,11 @@ uses plain streaming, since there is no terminal to draw the UI on. Install ------- -Get the script: +This fork isn't packaged anywhere; download `pidcat.py` from this repo and +place it on your PATH. + +The Homebrew and AUR packages below install the upstream, non-interactive +`pidcat` instead: * OS X: Use [Homebrew][2]. @@ -54,8 +65,6 @@ Get the script: * Arch Linux : Install the package called `pidcat-git` from the [AUR][4]. - * Others: Download the `pidcat.py` and place it on your PATH. - Make sure that `adb` from the [Android SDK][3] is on your PATH. This script will not work unless this is that case. That means, when you type `adb` and press @@ -84,3 +93,4 @@ sudo apt-get -t focal install coreutils [2]: http://brew.sh [3]: http://developer.android.com/sdk/ [4]: https://aur.archlinux.org/packages/pidcat-git/ + [5]: https://github.com/JakeWharton/pidcat diff --git a/pidcat.py b/pidcat.py index a1811ee..e93c386 100755 --- a/pidcat.py +++ b/pidcat.py @@ -33,7 +33,7 @@ import subprocess import threading from subprocess import PIPE -__version__ = '2.1.0' +__version__ = '2.2.0' LOG_LEVELS = 'VDIWEF' LOG_LEVELS_MAP = dict([(LOG_LEVELS[i], i) for i in range(len(LOG_LEVELS))])