Skip to content
Deprecated -- Image selector for Android device. Support single choice and multi-choice.
Branch: master
Clone or download
Latest commit bed718f Jun 30, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
app add private resources support, AS1.3+ Jun 12, 2016
art resize art images Apr 8, 2015
gradle/wrapper update gradle May 18, 2016
multi-image-selector fix MemoryLeak; #74 Jun 12, 2016
.gitignore fix bugs May 19, 2016
LICENSE Initial commit Apr 8, 2015 update README Jun 30, 2016 update README Jun 30, 2016
build.gradle update gradle May 18, 2016 init Apr 8, 2015
gradlew fix some bugs Jan 19, 2016
gradlew.bat init Apr 8, 2015
settings.gradle init Apr 8, 2015


Image selector for Android device. Support single choice and multi-choice.


###ART Example1 Select1 Select2 Select3

###Run Demo

./gradlew installDebug

###Quick Start

  • Step 0 Add module multi-image-selector as your dependence. in your build.gradle :
repositories {
    maven { url "" }

dependencies {
    compile 'com.github.lovetuzitong:MultiImageSelector:1.2'
  • Step 1 Set your AndroidManifest.xml as below:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />



    <!--Image Selector Entry-->
        android:name="me.nereo.multi_image_selector.MultiImageSelectorActivity" />
  • Step 2 Call image selector simplest in your code, eg. ( From version-1.1 )
// Multi image selector form an Activity
        .start(Activity, REQUEST_IMAGE);

Detail Api.

        .showCamera(boolean) // show camera or not. true by default
        .count(int) // max select image size, 9 by default. used width #.multi()
        .single() // single mode
        .multi() // multi mode, default mode;
        .origin(ArrayList<String>) // original select data set, used width #.multi()
        .start(Activity/Fragment, REQUEST_IMAGE);

Also support traditional Intent :

Intent intent = new Intent(mContext, MultiImageSelectorActivity.class);
// whether show camera
intent.putExtra(MultiImageSelectorActivity.EXTRA_SHOW_CAMERA, true);
// max select image amount
intent.putExtra(MultiImageSelectorActivity.EXTRA_SELECT_COUNT, 9);
// select mode (MultiImageSelectorActivity.MODE_SINGLE OR MultiImageSelectorActivity.MODE_MULTI)
intent.putExtra(MultiImageSelectorActivity.EXTRA_SELECT_MODE, MultiImageSelectorActivity.MODE_MULTI);
// default select images (support array list)
intent.putStringArrayListExtra(MultiImageSelectorActivity.EXTRA_DEFAULT_SELECTED_LIST, defaultDataArray);
startActivityForResult(intent, REQUEST_IMAGE);
  • Step 3 Receive result in your onActivityResult Method. eg.
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if(requestCode == REQUEST_IMAGE){
        if(resultCode == RESULT_OK){
	        // Get the result list of select image paths
            List<String> path = data.getStringArrayListExtra(MultiImageSelectorActivity.EXTRA_RESULT);
            // do your logic ....
  • Step 4 No more steps, just enjoy. :)

###Custom Activity Style

  • Custome your own Activity
class CustomerActivity extends Activity implements MultiImageSelectorFragment.Callback{
    protected void onCreate(Bundle savedInstanceState) {
		// customer logic here...
		Bundle bundle = new Bundle();
        bundle.putInt(MultiImageSelectorFragment.EXTRA_SELECT_COUNT, mDefaultCount);
        bundle.putInt(MultiImageSelectorFragment.EXTRA_SELECT_MODE, mode);
        bundle.putBoolean(MultiImageSelectorFragment.EXTRA_SHOW_CAMERA, isShow);
        // Add fragment to your Activity
                .add(, Fragment.instantiate(this, MultiImageSelectorFragment.class.getName(), bundle))
    public void onSingleImageSelected(String path) {
        // When select mode set to MODE_SINGLE, this method will received result from fragment

    public void onImageSelected(String path) {
        // You can specify your ActionBar behavior here 

    public void onImageUnselected(String path) {
        // You can specify your ActionBar behavior here 

    public void onCameraShot(File imageFile) {
        // When user take phone by camera, this method will be called.
  • Take a glance of

###Change Log

  • 2016-5-18

    1. Added. JitPack support
    2. Added. Convenient way to call image selector. See Step 2
    3. Fixed. Some NPE.
  • 2016-1-19

    1. Fixed. cannot load some 0-size image
    2. Added. When take a new photo, notify media scanner
    3. Fixed. Can't take photo on RED-MI
    4. Fixed. Performance when show Camera-Icon
  • 2015-5-5

    1. Fixed. Can't display some images. (Issue bysd6352051, larry)
    2. Fixed. ListPopupWindow can not fill parent
    3. Added. Add checked mask.
  • 2015-4-16

    1. Fixed. Crack when rotate device. (Issue by @Leminity)
    2. Fixed. PopupListView position error. (Issue by @Slock)
    3. Change. Demo application shortcut.
    4. Change. Readme file.
  • 2015-4-9

    1. Fixed. When set EXTRA_SHOW_CAMERA to true, the first grid item onclick event were messed.
    2. Add. Support initial selected image list.


  • square-picasso A powerful image downloading and caching library for Android


The MIT License (MIT)

Copyright (c) 2015 Nereo

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

You can’t perform that action at this time.