Image Picker with Customizable UI for Android, Pick an image from Gallery

Last update: May 29, 2022

Related tags

ImageView android image image-picker kotlin-android android-library image-picker-library image-picker-android

Overview

Image Picker

A Image Picker Library for Android (Supports Android 12) with fully customizable UI

🔥 Features

Pick gallery images
Customizable and Material Design UI
Supports Android 12

🔥 RoadMap

Capture in Camera Mode (Work in Progress)
Videos Picker (In Future)

🔧 Installation

In settings.gradle file, add JitPack maven like below:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Add the following dependency in app build.gradle:

dependencies {
    implementation 'com.github.nafiskabbo:ImagePicker:1.0'
}

⚡ Usage

Define an ActivityResultLauncher class variable in Activity or Fragment.

private val launcher = registerImagePicker { images ->
    // Selected images are ready to use
    if(images.isNotEmpty()){
        val sampleImage = images[0]
        Glide.with(this@MainActivity)
             .load(sampleImage.uri)
             .into(imageView)
    }
}

Then, launch image picker when needed.

With default configuration:

launcher.launch()

With customize configuration:

val config = ImagePickerConfig(
    statusBarColor = "#000000",
    isLightStatusBar = false,
    isFolderMode = true,
    isMultipleMode = true,
    maxSize = 10,
    rootDirectory = Config.ROOT_DIR_DOWNLOAD,
    subDirectory = "Photos",
    folderGridCount = GridCount(2, 4),
    imageGridCount = GridCount(3, 5),
    // See more at configuration attributes table below
)

launcher.launch(config)

Configuration attributes

Name	Description	Default
`statusBarColor`	Status bar color (require API >= 21)	`#000000`
`isLightStatusBar`	Set status bar to light/dark mode to change it's content to dark/light (require API >= 21)	`false`
`toolbarColor`	Toolbar color	`#212121`
`toolbarTextColor`	Toolbar text color	`#FFFFFF`
`toolbarIconColor`	Toolbar icon color	`#FFFFFF`
`backgroundColor`	Background color	`#424242`
`progressIndicatorColor`	Loading indicator color	`#009688`
`selectedIndicatorColor`	Selected image's indicator color	`#1976D2`
`isCameraOnly` (Work in Progress)	Open camera, then capture and return an image	`false`
`isMultipleMode`	Allow to select multiple images	`true`
`isFolderMode`	Show images by folders	`false`
`folderGridCount`	Set folder colums for portrait and landscape orientation	`GridCount(2, 4)`
`imageGridCount`	Set image colums for portrait and landscape orientation	`GridCount(3, 5)`
`doneTitle`	Done button title	`DONE`
`folderTitle`	Toolbar title for folder mode (require FolderMode = `true`)	`Albums`
`imageTitle`	Toolbar title for image mode (require FolderMode = `false`)	`Photos`
`isShowCamera` (Work in Progress)	Show camera button	`true`
`isShowNumberIndicator`	Show selected image's indicator as number	`false`
`isAlwaysShowDoneButton`	Show done button even though no images've been selected yet	`false`
`rootDirectory`	Public root directory of captured image, should be one of: `RootDirectory.DCIM`, `RootDirectory.PICTURES`, `RootDirectory.DOWNLOADS`.	`RootDirectory.DCIM`
`subDirectory`	Root directory's sub folder of captured image	Application name
`maxSize`	Max images can be selected	`Int.MAX_VALUE`
`limitMessage`	Message to be displayed when total selected images exceeds max size	...
`selectedImages`	List of images that will be shown as selected in ImagePicker	Empty list

💥 Compatibility

Library - Android Marshmallow 5.0+ (API 21)

✔️ Changelog

Version: 1.0

Initial Build

📃 Libraries Used

Glide [https://github.com/bumptech/glide] - Version 4.12.0

✨ Contributors

_nafiskabbo

License

You might also like...

Flickable ImageView for Android. It's like a view of twitter's detail image.

FlickableView Flickable ImageView for Android. It's like a view of twitter's detail image. It's possible that other views animate with FlickableView.

153 Nov 14, 2022

Android library written in kotlin that add a noise effect to image.

NoiseView With NoiseView you can easily add a noise effect to your image. See demo on YouTube Setup The library is pushed to jCenter() as an AAR, so y

46 Sep 8, 2022

This is a library for make auto slide image in android

Auto Image Slider Screenshot Image Slider Default Image Slider With Custom Adapter Usage Add ImageSlider to your layout

17 Dec 1, 2022

Android Library for cropping an image at ease.

Cropper - Android Image Cropper Android Image Cropper Powerful (Zoom, Rotation, Multi-Source); Customizable (Shape, Limits, Style); Optimized (Async,

24 Aug 24, 2022

A library for Android provides blurred drop shadows to ImageView similar to iOS image backdrop shadows

A library for Android provides blurred drop shadows to ImageView similar to iOS image backdrop shadows.Provides fast canvas draw as no renderscript needed .The similar shadow blurred effects can also be seen in iOS Music App.

163 Dec 31, 2022

Add curve at bottom of image views and relative layouts.

Crescento Android library that adds a curve at the below of image views and relative layouts. CrescentoImageView and CrescentoContainer are the image

1.3k Nov 18, 2022

Custom ImageView to generate captcha image.

CaptchaImageView Custom ImageView to generate captcha image. Add CaptchaImageView to your layout test.jinesh.captchaimageviewlib.CaptchaImageView

610 Oct 18, 2022

A photoView to scale image and finish activity，高仿微信可拖拽返回PhotoView

DragPhotoView(English) 高仿微信可拖拽返回PhotoView 基于 PhotoView ##下载APK体验特性拖拽缩放图片,并且结束Activity 其他PhotoView所有特性如下: Out of the box zooming, using multi-touch a

1.6k Dec 5, 2022

Custom ImageView for android with polygon shape (Android)

PolygonImageView Create a custom ImageView with polygonal forms. Usage To use PolygonImageView, add the module into your project and start to build xm