>_ FadCat

FadCat is a lightweight, feature-rich, cross‑platform Android logcat replacement for Android Studio, without the bloat. It bundles ADB for supported architectures and runs in GUI, CLI, or MCP server mode.

Tip

This project is part of the FadSec Lab suite.
Discover our focus on ad-free, privacy-first applications and stay updated on future releases!

FadCat also ships specialized FadCam media tools to browse and pull FadCam media for backups.
FadCam repository: FadCam

⭐		From the FadSec-Lab suite: Also, check out our Desktop app/file/folder locker: FadCrypt

>_ Features

• Multi‑device logcat sessions: dedicated tabs per device/session
• Search with modes: regex, fuzzy search, grep mode, and case toggle
• Highlighting: matches are highlighted with clear current‑match focus
• Log level chips: filter by V/D/I/W/E/F instantly
• Package picker: searchable package list for fast targeting
• Visual clarity: colored log levels/tags and readable UI defaults
• Customizable: tag padding, ignored tags, and UI options via settings
• Bundled ADB: architecture‑aware selection without relying on system ADB
• MCP server: AI assistants can inspect devices, logs, processes, and media
• FadCam integration: browse and pull FadCam media for backups
• Cross‑platform utility: macOS, Linux, and Windows

>_ What FadCat Is For

FadCat is designed for fast daily Android debugging: logcat exploration, device inspection, and structured AI workflows via MCP.
It is also a specialized companion for FadCam, built to browse and manage FadCam media and pull backups to your PC.

There are many logcat wrappers, but most are CLI‑heavy and feel too manual for daily work.
FadCat adds a clean, feature‑rich GUI with options that are easy to use.

>_ Modes

>_ GUI (default)

fadcat

>_ CLI

fadcat --cli

>_ MCP Server (stdio)

fadcat --mcp

>_ MCP Overview

FadCat exposes a FastMCP server so AI assistants can use FadCat’s MCP tools.

Core MCP capabilities

• Device discovery and system info
• Logcat streaming and search
• App process inspection
• FadCam media browsing and selective pulls

Roadmap direction FadCat MCP is evolving toward more autonomous Android workflows. Planned areas include:

• Device automation and capture flows (e.g., integration with open‑source tools like scrcpy)
• APK‑level inspection and reverse‑engineering helpers
• Richer device diagnostics and automated debugging routines

>_ MCP Setup (IDE)

Recommended: OpenCode (Free)

1. Run: opencode mcp add
2. Use:
   • Name: fadcat
   • Type: local
   • Command: fadcat
   • Args: --mcp

Manual Config (Other AI Tools) Add one of the following MCP configs in your IDE settings:

Installed (recommended)

{
  "fadcat": {
    "type": "stdio",
    "command": "fadcat",
    "args": ["--mcp"],
    "env": {"PYTHONUNBUFFERED": "1"}
  }
}

Local Dev (run from source)

{
  "fadcat": {
    "type": "stdio",
    "command": "/opt/homebrew/bin/python3",
    "args": ["-m", "src.mcp"],
    "env": {
      "PYTHONUNBUFFERED": "1",
      "PYTHONPATH": "/path/to/FadCat"
    }
  }
}

Notes:

• Replace command with your Python path from which python3.
• Replace PYTHONPATH with the path where you cloned the FadCat repo.

On macOS, the CLI command is registered on first launch.

>_ MCP Prompt Examples

>_ FadCam MCP

• Browse FadCam beta camera recordings in internal storage.
• Browse FadCam Pro+ recordings on the SD card.
• Browse FadCam media and tell me total videos and space used.
• Browse the forensic gallery, then pull the latest 5 forensic snapshots.
• Pull this exact file: FadCam_YYYYMMDD_HHMMSS.mp4

>_ General MCP

• Summarize the latest logcat warnings and errors.
• Analyze app crash logs and suggest the root cause.
• List connected devices and show device details.
• Show system info and storage stats for the selected device.

>_ 📱 Screenshots

>_ ⬇️ Download

Download the latest release from the releases page.

>_ Join Community

Join our Discord server to share ideas, seek help, or connect with other users. Your feedback and contributions are welcome!

>_ Support & Shop

Support development via Patreon.

Contributing and Requirements

Contributing

• Open an issue first to discuss the feature or fix.
• Fork the repo and create a feature branch.
• Commit your changes with a clear message.
• Open a pull request and link the related issue.

Requirements

• Python 3.8+ (built and tested on Python 3.14)
• Dependencies in requirements.txt

Dev quick start

pip3 install -r requirements.txt
python3 FadCat.py

>_ Credits

• Built on top of pidcat

>_ License

Apache 2.0