# guardian/toolargetool

A tool to help you debug TransactionTooLargeExceptions on Android 7+

Repository: https://github.com/guardian/toolargetool
Canonical: https://ross.abutalabs.com/products/toolargetool
Language: Kotlin
License: MIT
License Family: permissive
Topics: production
Last push: 2026-08-02T00:42:18+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 8, longevity 100
- inputs: {"age_days": 3443, "days_push": 32, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1214, forks 106 (observed 2026-08-28T04:04:00.889165+00:00)

## What it is
toolargetool is a Kotlin library for Android that helps debug TransactionTooLargeException crashes by logging how much data components write to the Binder transaction buffer. It integrates into an app's startup and reports Bundle sizes via logcat.

## Use cases
- debug TransactionTooLargeException crashes on Android 7+
- find which activity or fragment writes oversized Bundles in onSaveInstanceState
- measure serialized Parcel sizes of saved instance state
- track transaction buffer usage during app runtime via logcat

## When to choose
- you are debugging TransactionTooLargeException crashes in an Android app
- you need to identify which components pass too much data through Binder transactions
- you want a lightweight temporary dependency you can remove after debugging

## When to avoid
- you need a permanent production monitoring solution rather than a debugging aid
- your project is not Android/Kotlin or Java based
- you need automated crash prevention rather than diagnostic logging

## Facets
- artifact type: library
- maturity: active
- function: logging, developer-tools
- domain: android-tools, developer-tools, mobile-development
- platform: -
- tags: android, kotlin, debugging, transactiontoolargeexception, logcat, saved-instance-state

## Member repositories
- guardian/toolargetool (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:00.889165+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:17:21.940920+00:00, confidence not recorded.
  - readme: https://github.com/guardian/toolargetool (fetched 2026-08-28T04:04:00.889165+00:00, sha 244e6a994f45)
- Data as of 2026-08-30T08:39:29.467469+00:00.
