Repo brief: Baseflow/PhotoView

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T15:35:10.769Z · commit 565505d5cb84

Verdict

Mixed — Stale — last commit 4y ago

• 20 active contributors
• Apache-2.0 licensed

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

PhotoView is an Android ImageView subclass that adds pinch-to-zoom, double-tap zoom, and fling-scroll capabilities with smooth gesture handling. It solves the problem of standard ImageView being unable to handle multi-touch zoom gestures natively, providing out-of-the-box zoomable image viewing with matrix transformations. Simple two-module structure: photoview/src/main/java/com/github/chrisbanes/photoview/ contains core classes (PhotoView, PhotoViewAttacher, CustomGestureDetector, various listener interfaces), and sample/ provides a complete reference implementation. Core logic lives in PhotoViewAttacher.java which handles matrix transformations; PhotoView.java is a thin wrapper…

Start here

Open these first:

• photoview/src/main/java/com/github/chrisbanes/photoview/PhotoView.java — Public API entry point that wraps PhotoViewAttacher; all consumer code uses this class to enable zoom functionality on…
• photoview/src/main/java/com/github/chrisbanes/photoview/PhotoViewAttacher.java — Core engine handling all zoom, pan, fling, and gesture logic; understanding this class is essential to modify scaling…
• photoview/src/main/java/com/github/chrisbanes/photoview/CustomGestureDetector.java — Detects and normalizes all touch gestures (pinch, double-tap, single-tap, long-press, fling); any gesture enhancement or…
• photoview/src/main/java/com/github/chrisbanes/photoview/OnGestureListener.java — Primary callback interface that all gesture responses use; defines the contract between gesture detection and scale/pan…
• photoview/build.gradle — Module-level build configuration; contributors need to understand min/max SDK targets and any library dependencies added.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/chrisbanes/PhotoView.git
cd PhotoView
./gradlew build
./gradlew sample:assembleDebug  # Build the sample app

Daily commands:

./gradlew sample:installDebug  # Install sample app to connected device/emulator
adb shell am start -n com.github.chrisbanes.photoview.sample/.MainActivity
# Or in Android Studio: Open sample/ module and click Run

Key cautions & unknowns

• Stale — last commit 4y ago
• Concentrated ownership — top contributor handles 60% of recent commits
• 1. ViewPager and DrawerLayout will throw exceptions unless wrapped (see HackyDrawerLayout.java pattern—this is a framework limitation, not a bug). 2) Matrix state is cumulative; improper reset can cause transform…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.