# stfalcon-studio/StfalconImageViewer

A simple and customizable Android full-screen image viewer with shared image transition support, "pinch to zoom" and "swipe to dismiss" gestures

Repository: https://github.com/stfalcon-studio/StfalconImageViewer
Canonical: https://ross.abutalabs.com/products/stfalconimageviewer
Homepage: http://stfalcon.com
Language: Kotlin
License: Apache-2.0
License Family: permissive
Topics: android, imageviewer, swipe-to-dismiss, transitions, pinch-to-zoom, zoom, android-library, viewer, gallery, photo-gallery, photo, image, easy-to-use, transition
Last push: 2024-05-03T16:49:28+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2826, "days_push": 852, "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 2024, forks 270 (observed 2026-08-28T04:06:06.719457+00:00)

## What it is
StfalconImageViewer is an Android library providing a customizable full-screen image viewer with shared-element transition animations, pinch-to-zoom, and swipe-to-dismiss gestures. It works with popular image-loading libraries such as Picasso and Glide and is built on top of PhotoView.

## Use cases
- show a full-screen image viewer in an android app
- open images from a gallery with a shared element transition animation
- add pinch to zoom to image viewing on android
- implement swipe to dismiss for a photo viewer
- build an image carousel with paging between photos
- display images loaded with picasso or glide in a fullscreen overlay

## When to choose
- you need a ready-made fullscreen image viewer with zoom and swipe gestures on Android
- you want smooth shared-element transition animations when opening images
- your app already uses Picasso, Glide, or another image loader and you want to plug in a viewer

## When to avoid
- you are not building an Android app
- you need video playback or complex media editing rather than image viewing
- you need a viewer actively developed with frequent updates - the project appears to be in maintenance mode

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, image-processing, animation
- domain: mobile-development, android-tools, media, photography
- platform: jvm
- tags: image-viewer, pinch-to-zoom, swipe-to-dismiss, shared-element-transition, androidx, gallery-viewer, photoview, android, mobile

## Member repositories
- stfalcon-studio/StfalconImageViewer (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:06.719457+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-30T02:59:59.469267+00:00, confidence not recorded.
  - readme: https://github.com/stfalcon-studio/StfalconImageViewer (fetched 2026-08-28T04:06:06.719457+00:00, sha 616f9faa1427)
  - homepage: http://stfalcon.com (fetched 2026-08-29T10:39:56.807951+00:00, sha c319c79518c8)
  - site_page: http://stfalcon.com/en/about-us (fetched 2026-08-29T10:39:56.810909+00:00, sha fdd781be2c7c)
- Data as of 2026-08-30T08:39:29.467469+00:00.
