# iielse/imageviewer

A simple and customizable Android full-screen image viewer 一个简单且可自定义的Android全屏图像浏览器

Repository: https://github.com/iielse/imageviewer
Canonical: https://ross.abutalabs.com/products/iielse-imageviewer
Language: Kotlin
License: MIT
License Family: permissive
Topics: viewer, imageviewer, photobrowser, gallery, zoom, wechat, viewpager, gif, image, video, gesture, draggable, transferee
Last push: 2026-06-05T10:02:35+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 86, release rhythm 55, longevity 100
- inputs: {"age_days": 3514, "days_push": 89, "days_rel": 90, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2302, forks 311 (observed 2026-08-28T04:06:35.512205+00:00)

## What it is
A customizable Android full-screen image and video viewer library written in Kotlin. It supports smooth thumbnail-to-fullsize transition animations, zooming, drag-to-dismiss, long image subsampling, GIFs, video playback, and paged data sources.

## Use cases
- show full-screen image gallery from thumbnails in an android app
- add wechat-style photo viewer with drag to dismiss
- preview long images with chunked subsampling loading
- play videos in a full-screen preview overlay
- implement paged image browsing with infinite data loading
- customize image preview ui and transition animations

## When to choose
- you need a drop-in full-screen image viewer for an android app
- you want smooth shared-element-like transitions from thumbnails
- your app displays mixed content like images, long images, gifs, and videos

## When to avoid
- you need an ios or cross-platform image viewer
- you want a complete gallery app rather than an embeddable component
- your min sdk is below 23

## Facets
- artifact type: library
- maturity: active
- function: ui-components, image-processing, animation
- domain: mobile-development, android-tools, media
- platform: -
- tags: image-viewer, photo-browser, gesture, zoom, kotlin, viewpager, gif, video-preview, transition-animation, android, mobile

## Member repositories
- iielse/imageviewer (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:35.512205+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:40:09.857496+00:00, confidence not recorded.
  - readme: https://github.com/iielse/imageviewer (fetched 2026-08-28T04:06:35.512205+00:00, sha bdda42846f6d)
- Data as of 2026-08-30T08:39:29.467469+00:00.