# JakeWharton/timber

A logger with a small, extensible API which provides utility on top of Android's normal Log class.

Repository: https://github.com/JakeWharton/timber
Canonical: https://ross.abutalabs.com/products/timber
Homepage: https://jakewharton.github.io/timber/docs/5.x/
Language: Kotlin
License: Apache-2.0
License Family: permissive
Last push: 2026-08-24T18:13:24+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 4794, "days_push": 9, "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 10846, forks 995 (observed 2026-08-28T04:10:44.490273+00:00)

## What it is
Timber is a lightweight, extensible logging library for Android built on top of the standard android.util.Log class. Behavior is added by planting Tree instances, and it ships with embedded lint rules to catch common logging mistakes.

## Use cases
- log messages in an Android app with automatic class-name tags
- plant custom logging trees for crash reporting or file logging
- avoid logging in production builds
- catch wrong format string arguments with lint checks
- replace verbose android.util.Log calls with a cleaner API

## When to choose
- you are building an Android app and want a simple, extensible logging API
- you want automatic tags derived from the calling class
- you want lint rules enforcing logging best practices

## When to avoid
- you are not developing for Android or the JVM
- you need structured or centralized logging infrastructure for backend services
- you need a logging facade for multi-platform non-Android projects

## Facets
- artifact type: library
- maturity: stable
- function: logging
- domain: android-tools, developer-tools, mobile-development
- platform: jvm
- tags: android-logging, extensible-api, lint-rules, debug-tree, android

## Member repositories
- JakeWharton/timber (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:44.490273+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-29T17:17:30.109550+00:00, confidence not recorded.
  - readme: https://github.com/JakeWharton/timber (fetched 2026-08-28T04:10:44.490273+00:00, sha 5db0c52055f2)
  - homepage: https://jakewharton.github.io/timber/docs/5.x/ (fetched 2026-08-29T08:16:25.514845+00:00, sha a5285db7ae2c)
- Data as of 2026-08-30T08:39:29.467469+00:00.