Logcat
Android logcat is the system log stream: messages from apps, the framework, and drivers. NearMirror opens a dedicated Logcat window so you can watch logs in real time, filter them, copy text, and save to disk—without leaving the main app window.
Open the viewer
- Go to the Devices section in the sidebar.
- On a connected device card, click Logcat (document icon) in the row of actions next to Launch.
A separate desktop window opens, titled Logcat — device name. You can keep it open while using the rest of NearMirror.
Closing the Logcat window ends that session and stops the adb logcat stream for that window.
Toolbar (top)
First row
| Control | What it does |
|---|---|
| Standard / Compact | Standard shows time, PID/TID, tag, resolved package, level, and message on two lines. Compact shows a single denser line. |
| Wrap | Allows message text to wrap to multiple lines instead of a single truncated line. |
| Follow | When on, the list scrolls to the newest line as new logs arrive. Turn off to read without being pulled to the bottom. |
| Level | Minimum severity for lines shown in the viewer (Verbose, Debug, Info, Warn, Error). |
| Buffer | Which Android log buffers to stream: All, Main, System, or Crash. Changing buffer restarts the live stream for that device. |
| Scroll-to-end | Jumps the list to the latest line (useful if Follow is off). |
Second row
| Field | What it does |
|---|---|
| Package | Keeps lines whose resolved process/package label contains this text (case-insensitive substring). |
| Tag | Keeps lines whose tag contains this text (case-insensitive substring). |
Log list
- Logs are read with
adb logcat -v threadtimeand shown as they arrive. - NearMirror keeps a ring buffer of up to 10 000 lines in memory for the session. When that limit is exceeded, the oldest lines are dropped to make room for new ones.
- Process IDs are periodically mapped to package / process names for the Standard layout and for the Package filter.
Text selection and copy
- The list is wrapped in one selection scope so you can drag to select across multiple visible lines (like a text editor).
- Copy (in the bottom bar) and Ctrl+C / ⌘+C (with the Logcat window focused) copy an export of all lines that match the current filters (what you see in the list after Level / Package / Tag filtering). The shortcut always copies that full filtered export, not only a partial mouse selection.
- Ctrl+A / ⌘+A selects all filtered rows for highlighting; use Copy or ⌘+C to put the filtered export on the clipboard.
Because the list is virtualized, selection only spans lines that are currently on screen. For a full dump of many lines, use Save buffer… or Save… (see below).
Long-press a line
Press and hold a row (or use the platform equivalent) to open a small menu:
- Copy line — copies that line’s export text.
- Clear viewer — clears on-screen buffers for this window (does not by itself clear the device’s ring buffer).
Bottom actions
Actions are grouped in two rows inside a bordered panel.
Viewer row
| Button | What it does |
|---|---|
| Pause / Resume | Pause stops new lines from being added to the viewer while paused. Resume continues the stream. |
| Clear | Clears the in-memory log lines shown in this window (viewer only). |
| Restart (clear) | Clears the device log buffer (adb logcat -c), restarts the live stream, and clears the viewer. Use when you want a clean capture from “now”. |
| Copy | Copies filtered visible lines to the clipboard (same as ⌘/Ctrl+C). |
Save row
| Control | What it does |
|---|---|
| Save buffer… | Writes all lines currently held in the session ring buffer (up to the 10 000-line cap) to a .txt file you choose. This is the full in-memory capture for this window, not only the lines matching Package/Tag filters. |
| Lines | Used only with Save…: limits how many recent lines are included in a one-shot adb logcat -d dump (Last 500, 1000, 5000, or All). Default in the UI is Last 5000 for new windows. |
| Save… | Runs adb logcat -d with the current Level, Buffer, and Lines settings, then lets you save the result as UTF-8 text. |
When you save to a file, the suggested filename looks like logcat-YYYYMMDD-HHmmss.txt.
Level, buffer, and line limits (reference)
The same concepts apply to both the live viewer (Level + Buffer on the toolbar) and the Save… dump (plus Lines).
Log level
Lower levels include everything above them.
| Level | What's included |
|---|---|
| Verbose | All messages — the most detail (default) |
| Debug | Debug and above |
| Info | Info and above |
| Warn | Warnings and errors |
| Error | Errors only |
Buffer
| Buffer | What's included |
|---|---|
| All | Combined buffers (default) |
| Main | Apps and framework |
| System | OS and system services |
| Crash | Crash buffer |
Lines (Save… only)
| Option | Effect |
|---|---|
| Last 500 / 1000 / 5000 | Passes a tail limit to logcat -d for that many recent lines. |
| All | Entire retained log — can be very large. |
Use Verbose and All buffers unless you need a smaller shareable file; then raise Level or cap Lines.