📸Image Picker Library for Android

_{Built with ❤︎ by
Dhaval Patel and

contributors}

Easy to use and configurable library to Pick an image from the Gallery or Capture image using Camera. It also allows to Crop and Compresses the Image based on Aspect Ratio, Resolution and Image Size.

Almost 90% of the app that I have developed has an Image upload feature. Along with the image selection, Sometimes I needed a crop feature for profile image for that I've used uCrop. Most of the time I need to compress the image as the image captured from the camera is more than 5-10 MBs and sometimes we have a requirement to upload images with specific resolution/size, in that case, image compress is the way to go option. To simplify the image pick/capture option I have created ImagePicker library. I hope it will be useful to all.

🐱‍🏍Features:

Pick Gallery Image
Pick Image from Google Drive
Capture Camera Image
Crop Image(Crop image based on provided aspect ratio or let user choose one)
Compress Image(Compress image based on provided resolution and size)
Retrieve Image Result as File, File Path as String or Uri object
Handle Runtime Permission for Camera and Storage

🎬Preview

Profile Image Picker	Gallery Only	Camera Only

💻Usage

Gradle dependency:

allprojects {
   repositories {
      	jcenter()
       	maven { url "https://jitpack.io" }  //Make sure to add this in your project for uCrop
   }
}

implementation 'com.github.dhaval2404:imagepicker:1.8'

If you are yet to Migrate on AndroidX, Use support build artifact:

implementation 'com.github.dhaval2404:imagepicker-support:1.7.1'

If you want to get the activity result inline in a modern way (lambda) install InlineActivityResult library:

implementation 'com.github.florent37:inline-activity-result-kotlin:1.0.4'

If you target Android 10 or higher(targetSdkVersion >= 29), set the value of requestLegacyExternalStorage to true in your app's manifest file:

<manifest ... >
    <!-- This attribute is "false" by default on apps targeting
         Android 10 or higher. -->
    <application android:requestLegacyExternalStorage="true" ... >
      ...
    </application>
</manifest>

The ImagePicker configuration is created using the builder pattern.

Kotlin

ImagePicker.with(this)
        .crop()	    			//Crop image(Optional), Check Customization for more option
        .compress(1024)			//Final image size will be less than 1 MB(Optional)
        .maxResultSize(1080, 1080)	//Final image resolution will be less than 1080 x 1080(Optional)
        .start()

Java

ImagePicker.Companion.with(this)
        .crop()	    			//Crop image(Optional), Check Customization for more option
        .compress(1024)			//Final image size will be less than 1 MB(Optional)
        .maxResultSize(1080, 1080)	//Final image resolution will be less than 1080 x 1080(Optional)
        .start()

Handling results

Default method(Preferred way)
Override onActivityResult method and handle ImagePicker result.

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
     super.onActivityResult(requestCode, resultCode, data)
     if (resultCode == Activity.RESULT_OK) {
         //Image Uri will not be null for RESULT_OK
         val fileUri = data?.data
         imgProfile.setImageURI(fileUri)
      
        //You can get File object from intent
        val file:File = ImagePicker.getFile(data)!!
       
        //You can also get File Path from intent
        val filePath:String = ImagePicker.getFilePath(data)!!
     } else if (resultCode == ImagePicker.RESULT_ERROR) {
         Toast.makeText(this, ImagePicker.getError(data), Toast.LENGTH_SHORT).show()
     } else {
         Toast.makeText(this, "Task Cancelled", Toast.LENGTH_SHORT).show()
     }
}

Inline method (with InlineActivityResult library, Only Works with FragmentActivity and AppCompatActivity) (Not to be used with crop. See #32)

ImagePicker.with(this)
        .compress(1024)         //Final image size will be less than 1 MB(Optional)
        .maxResultSize(1080, 1080)  //Final image resolution will be less than 1080 x 1080(Optional)
        .start { resultCode, data ->
            if (resultCode == Activity.RESULT_OK) {
                //Image Uri will not be null for RESULT_OK
                 val fileUri = data?.data
                 imgProfile.setImageURI(fileUri)
              
                //You can get File object from intent
                val file:File = ImagePicker.getFile(data)
               
                //You can also get File Path from intent
                val filePath:String = ImagePicker.getFilePath(data)
            } else if (resultCode == ImagePicker.RESULT_ERROR) {
                Toast.makeText(context, ImagePicker.getError(data), Toast.LENGTH_SHORT).show()
            } else {
                Toast.makeText(context, "Task Cancelled", Toast.LENGTH_SHORT).show()
            }
        }

🎨Customization

Pick image using Gallery

ImagePicker.with(this)
	.galleryOnly()	//User can only select image from Gallery
	.start()	//Default Request Code is ImagePicker.REQUEST_CODE

Capture image using Camera

ImagePicker.with(this)
	.cameraOnly()	//User can only capture image using Camera
	.start()

Crop image

ImagePicker.with(this)
	.crop()	    //Crop image and let user choose aspect ratio.
	.start()

Crop image with fixed Aspect Ratio

ImagePicker.with(this)
	.crop(16f, 9f)	//Crop image with 16:9 aspect ratio
	.start()

Crop square image(e.g for profile)

ImagePicker.with(this)
    .cropSquare()	//Crop square image, its same as crop(1f, 1f)
    .start()

Compress image size(e.g image should be maximum 1 MB)

ImagePicker.with(this)
	.compress(1024)	//Final image size will be less than 1 MB
	.start()

Set Resize image resolution

ImagePicker.with(this)
	.maxResultSize(620, 620)	//Final image resolution will be less than 620 x 620
	.start()

Intercept ImageProvider, Can be used for analytics

ImagePicker.with(this)
    .setImageProviderInterceptor { imageProvider -> //Intercept ImageProvider
        Log.d("ImagePicker", "Selected ImageProvider: "+imageProvider.name)
    }
    .start()

Intercept Dialog dismiss event

ImagePicker.with(this)
	.setDismissListener {
		// Handle dismiss event
		Log.d("ImagePicker", "onDismiss");
	}
	.start()

Specify Directory to store captured, cropped or compressed images

ImagePicker.with(this)
    //Provide directory path to save images
    .saveDir(File(Environment.getExternalStorageDirectory(), "ImagePicker"))
    // .saveDir(Environment.getExternalStorageDirectory())
    // .saveDir(getExternalFilesDir(null)!!)
    .start()

Limit MIME types while choosing a gallery image

ImagePicker.with(this)
    .galleryMimeTypes(  //Exclude gif images
        mimeTypes = arrayOf(
          "image/png",
          "image/jpg",
          "image/jpeg"
        )
      )
    .start()

You can also specify the request code with ImagePicker

ImagePicker.with(this)
	.maxResultSize(620, 620)
	.start(101)	//Here 101 is request code, you may use this in onActivityResult

Add Following parameters in your colors.xml file, If you want to customize uCrop Activity.

<resources>
    <!-- Here you can add color of your choice  -->
    <color name="ucrop_color_toolbar">@color/teal_500</color>
    <color name="ucrop_color_statusbar">@color/teal_700</color>
    <color name="ucrop_color_widget_active">@color/teal_500</color>
</resources>

💥Compatibility

Library - Android Kitkat 4.4+ (API 19)
Sample - Android Kitkat 4.4+ (API 19)

✔️Changelog

Version: 1.8

Added dialog dismiss listener (Special Thanks to kibotu)
Added text localization (Special Thanks to yamin8000 and Jose Bravo)
Fixed crash issue on missing camera app #69
Fixed issue selecting images from download folder #86
Fixed exif information lost issue #121
Fixed crash issue on large image crop #122
Fixed saving image in cache issue #127

Version: 1.7

Added option to limit MIME types while choosing a gallery image (Special Thanks to Marchuck)
Introduced ImageProviderInterceptor, Can be used for analytics (Special Thanks to Marchuck)
Fixed .crop() opening gallery or camera twice #32
Fixed FileProvider of the library clashes with the FileProvider of the app #51 (Special Thanks to OyaCanli)
Added option to set Storage Directory #52
Fixed NullPointerException in FileUriUtils.getPathFromRemoteUri() #61 (Special Thanks to himphen)
Fixed UCropActivity Crash Android 4.4 (KiKat) #82
Fixed PNG image saved as JPG after crop issue #94
Fixed PNG image saved as JPG after compress issue #105
Added Polish text translation #115 (Special Thanks to MarcelKijanka)
Failed to find configured root exception #116

Version: 1.6

Improved UI/UX of sample app
Removed Bitmap Deprecated Property #33 (Special Thanks to nauhalf)
Camera opens twice when "Don't keep activities" option is ON #41 (Special Thanks to benji101)
Fixed uCrop Crash Issue #42

Version: 1.5

Fixed app crash issue, due to Camera Permission in manifest #34
Added Option for Dynamic Crop Ratio. Let User choose aspect ratio #36 (Special Thanks to Dor-Sloim)

Version: 1.4

Optimized Uri to File Conversion (Inspired by Flutter ImagePicker)
Removed redundant CAMERA permission #26 (Special Thanks to PerrchicK)

Version: 1.3

Sample app made compatible with Android Kitkat 4.4+ (API 19)
Fixed Uri to File Conversion issue #8 (Special Thanks to squeeish)

Version: 1.2

Added Support for Inline Activity Result(Special Thanks to soareseneves)
Fixed issue #6

Version: 1.1

Optimized Compression Logic
Replace white screen with transparent one.

Version: 1.0

Initial Build

📃 Libraries Used

uCrop https://github.com/Yalantis/uCrop
Compressor https://github.com/zetbaitsu/Compressor
InlineActivityResult https://github.com/florent37/InlineActivityResult

Let us know!

We'll be really happy if you sent us links to your projects where you use our component. Just send an email to [email protected] And do let us know if you have any questions or suggestion regarding the library.

License

Copyright 2019-2020, Dhaval Patel

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

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Name		Name	Last commit message	Last commit date
Latest commit History 182 Commits
art		art
gradle/wrapper		gradle/wrapper
imagepicker		imagepicker
sample		sample
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
build.gradle		build.gradle
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
ktlint.gradle		ktlint.gradle
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

📸Image Picker Library for Android

🐱‍🏍Features:

🎬Preview

💻Usage

🎨Customization

💥Compatibility

✔️Changelog

Version: 1.8

Version: 1.7

Version: 1.6

Version: 1.5

Version: 1.4

Version: 1.3

Version: 1.2

Version: 1.1

Version: 1.0

📃 Libraries Used

Let us know!

License

About

Releases

Packages

Languages

License

Ealshehada/ImagePicker

Folders and files

Latest commit

History

Repository files navigation

📸Image Picker Library for Android

🐱‍🏍Features:

🎬Preview

💻Usage

🎨Customization

💥Compatibility

✔️Changelog

Version: 1.8

Version: 1.7

Version: 1.6

Version: 1.5

Version: 1.4

Version: 1.3

Version: 1.2

Version: 1.1

Version: 1.0

📃 Libraries Used

Let us know!

License

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages