All Projects → stfalcon-studio → Stfalconimageviewer

stfalcon-studio / Stfalconimageviewer

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

Programming Languages

9241 projects
68154 projects - #9 most used programming language

Projects that are alternatives of or similar to Stfalconimageviewer

Image slide-show viewer with multiple predefined transition styles, with ability to create new transitions with ease.
Stars: ✭ 186 (-89.27%)
Mutual labels:  image, photo, transition, pinch-to-zoom, zoom
A simple and customizable Android full-screen image viewer 一个简单且可自定义的Android全屏图像浏览器
Stars: ✭ 1,889 (+8.94%)
Mutual labels:  image, gallery, viewer, zoom, imageviewer
Customizable Android full screen image viewer for Fresco library supporting "pinch to zoom" and "swipe to dismiss" gestures. Made by Stfalcon
Stars: ✭ 1,807 (+4.21%)
Mutual labels:  pinch-to-zoom, viewer, zoom, swipe-to-dismiss
Photo view
📸 Easy to use yet very customizable zoomable image widget for Flutter, Photo View provides a gesture sensitive zoomable widget. Photo View is largely used to show interacive images and other stuff such as SVG.
Stars: ✭ 1,280 (-26.18%)
Mutual labels:  pinch-to-zoom, gallery, zoom
An easy to use Image Viewer that is inspired by Facebook
Stars: ✭ 1,071 (-38.24%)
Mutual labels:  image, photo, gallery
"Image Album" — or "Photo Album" if you like that better — View( Controller) for all crazy iOS developers out there...
Stars: ✭ 199 (-88.52%)
Mutual labels:  image, photo, gallery
React Image Magnify
A responsive image zoom component designed for shopping sites.
Stars: ✭ 391 (-77.45%)
Mutual labels:  image, photo, zoom
Stars: ✭ 2,798 (+61.36%)
Mutual labels:  image, photo, gallery
An image resizing library for Android
Stars: ✭ 406 (-76.59%)
Mutual labels:  image, photo, photo-gallery
React Viewer
react image viewer, supports rotation, scale, zoom and so on
Stars: ✭ 502 (-71.05%)
Mutual labels:  image, gallery, viewer
An iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.
Stars: ✭ 544 (-68.63%)
Mutual labels:  photo, gallery, viewer
AngularJS super image gallery
Stars: ✭ 46 (-97.35%)
Mutual labels:  gallery, transition, transitions
V Viewer
Image viewer component for vue, supports rotation, scale, zoom and so on, based on viewer.js
Stars: ✭ 1,776 (+2.42%)
Mutual labels:  image, gallery, viewer
An initial implementation of a "showcase" view( controller) for iOS apps... Visualizes images, videos and PDF files beautifully! (by @pittleorg) [meta: image, photo, video, document, pdf, album, gallery, showcase, gallery, iOS, iPhone, iPad, component, library, viewer]
Stars: ✭ 395 (-77.22%)
Mutual labels:  image, photo, gallery
Photo gallery for self-hosted personal servers
Stars: ✭ 553 (-68.11%)
Mutual labels:  photo, gallery, photo-gallery
jQuery Zoom Gallery plugin
Stars: ✭ 120 (-93.08%)
Mutual labels:  image, gallery, zoom
jQuery plugin to zoom and pan images, even those with a size that is a percentage of their container
Stars: ✭ 50 (-97.12%)
Mutual labels:  image, viewer
【拇指先生】 a simple easy video thumbnail provider,顺滑的获取视频缩略图,支持本地和网络视频,有问题大胆提Issues
Stars: ✭ 60 (-96.54%)
Mutual labels:  image, photo
Extended image
A powerful official extension library of image, which support placeholder(loading)/ failed state, cache network, zoom pan image, photo view, slide out page, editor(crop,rotate,flip), paint custom etc.
Stars: ✭ 1,021 (-41.12%)
Mutual labels:  image, zoom
图片选择器, 支持多图选择和图片预览
Stars: ✭ 62 (-96.42%)
Mutual labels:  image, photo

codebeat badge Codacy Badge Download License

Stfalcon ImageViewer

A simple and customizable full-screen image viewer with shared image transition support, "pinch to zoom" and "swipe to dismiss" gestures. Compatible with all of the most popular image processing libraries such as Picasso, Glide etc. Based on PhotoView by chrisbanes.

alt tag alt tag

Who we are

Need iOS and Android apps, MVP development or prototyping? Contact us via [email protected]. We develop software since 2009, and we're known experts in this field. Check out our portfolio and see more libraries from stfalcon-studio.


  • A project configured with the AndroidX
  • SDK 19 and and higher

Demo Application

Get it on Google Play


Download via Gradle:

Add this to the project build.gradle file:

allprojects {
    repositories {
        maven { url "" }

And then add the dependency to the module build.gradle file:

implementation 'com.github.stfalcon-studio:StfalconImageViewer:v1.0.1'

Download via Maven:


Where the latest_version is the value from Download badge.


Simple usage

All you need to show the viewer is to pass the context, list or array of your image objects and the implementation of the ImageLoader and call the show() method:

StfalconImageViewer.Builder<Image>(context, images) { view, image ->

Piece of cake!

Transition animation

To improve the UX of your app you would like to add a transition when a user opens the viewer. And this is simple as never before! Just tell the viewer which image should be used for animation using withTransitionFrom(myImageView) method and the library will do it for you!

If you need more advanced behavior like updating transition target while changing images in the viewer please see the sample app for how to do this.

Update images list on the fly

There are a lot of common cases (such as pagination, deleting, editing etc.) where you need to update the existing images list while the viewer is running. To do this you can simply update the existing list (or even replace it with a new one) and then call updateImages(images).

Change current image

Images are not always leafed through by the user. Maybe you want to implement some kind of preview list at the bottom of the viewer - setCurrentPosition is here for help. Change images programmatically wherever you want!

Custom overlay view

If you need to show some content over the image (e.g. sharing or download button, description, numeration etc.) you can set your own custom view using the setOverlayView(customView) and bind it with the viewer through the ImageViewer.OnImageChangeListener.


Use the setBackgroundColorRes(colorRes) or setBackgroundColor(colorInt) to set a color of the fading background.

Images margin

Simply add margins between images using the withImagesMargin(context, dimenRes) method for dimensions, or use the withImageMarginPixels(int) for pixels size.

Container padding

Overlay image hides part of the images? Set container padding with dimens using withContainerPadding(context, start, top, end, bottom) or withContainerPadding(context, dimen) for all of the sides evenly. For setting a padding in pixels, just use the withContainerPadding(...) methods variant.

Status bar visibility

Control the status bar visibility of the opened viewer by using the withHiddenStatusBar(boolean) method (true by default)


If you need to disable some of the gestures - you can use the allowSwipeToDismiss(boolean) and allowZooming(boolean) methods accordingly.

Options overview

Here is the example with all of the existing options applied:

StfalconImageViewer.Builder<String>(this, images, ::loadImage)
            //.withContainerPadding(R.dimen.paddingStart, R.dimen.paddingTop, R.dimen.paddingEnd, R.dimen.paddingBottom)
            //.withContainerPaddingPixels(paddingStart, paddingTop, paddingEnd, paddingBottom)

Also, you can take a look at the sample project for more information.

Usage with Fresco

If you use the Fresco library - check out the FrescoImageViewer which was also developed by our team.


Copyright (C) 2018

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].