Skip to content

ParkSangGwon/TedImagePicker

Repository files navigation

TedImagePicker Android Arsenal

TedImagePicker is simple/beautiful/smart image picker

  • Support Image/Video/Image&Video
  • Support Single/Multi select
  • Support more configuration option
Image Select Select Album Scroller



Demo

Image Select Select Album Scroller



Setup

Gradle

Maven Central

repositories {
  google()
  mavenCentral()
}

dependencies {
    implementation 'io.github.ParkSangGwon:tedimagepicker:x.y.z'
    //implementation 'io.github.ParkSangGwon:tedimagepicker:1.6.1'
}

If you think this library is useful, please press star button at upside.



How to use

1.Enable databinding

  • TedImagePicker use databinding
  • Set enable databinding in your app build.gradle
dataBinding {
    enabled = true
}

or

buildFeatures {
    dataBinding = true
}

2.Start TedImagePicker/TedRxImagePicker

  • TedImagePicker support Listener and RxJavastyle

Listener

Single image
  • Kotlin
TedImagePicker.with(this)
    .start { uri -> showSingleImage(uri) }
  • Java
TedImagePicker.with(this)
        .start(new OnSelectedListener() {
            @Override
            public void onSelected(@NotNull Uri uri) {
                showSingleImage(uri);
            }
        });
TedImagePicker.with(this)
        .start(uri -> {
            showSingleImage(uri);
        });
Multi image
  • Kotlin
TedImagePicker.with(this)
    .startMultiImage { uriList -> showMultiImage(uriList) }
  • Java
TedImagePicker.with(this)
        .startMultiImage(new OnMultiSelectedListener() {
            @Override
            public void onSelected(@NotNull List<? extends Uri> uriList) {
                showMultiImage(uriList);
            }
        });
TedImagePicker.with(this)
        .startMultiImage(uriList -> {
            showMultiImage(uriList);
        });

RxJava

Single image
TedRxImagePicker.with(this)
    .start()
    .subscribe({ uri ->
    }, Throwable::printStackTrace)
Multi image
TedRxImagePicker.with(this)
    .startMultiImage()
    .subscribe({ uriList ->
    }, Throwable::printStackTrace)



Customize

  • You can customize what you want

Function

Common

Function Description
mediaType(MediaType) MediaType.IMAGE / MediaType.VIDEO / MediaType.IMAGE_AND_VIDEO
cameraTileBackground(R.color.xxx) camera Tile Background Color
cameraTileImage(R.drawable.xxx) camera tile image
showCameraTile(Boolean) default true show camera tile
scrollIndicatorDateFormat(String) (default: YYYY.MM) Format of date on scroll indicator
showTitle(Boolean)(default: true) Show title
title(String or R.string.xxx) (default: 'Select Image','사진 선택') title
backButton(R.drawable.xxx) back button
zoomIndicator(Boolean) (default: true) zoom indicator
image() image
video() video
imageAndVideo() image and video
imageCountTextFormat(String) (default: %s): %s장, Count: %s image count text format
savedDirectoryName(String) saved directory name from take picture using camera
startAnimation(Int, Int) start animation
finishAnimation(Int, Int) finish animation
errorListener() error listener for error
cancelListener() cancel listener

Multi Select

Method Description
selectedUri(List<Uri>) selected uri
buttonGravity(ButtonGravity) You can change done button location top or bottom
buttonText(String or R.string.xxx) (default: 'Done','완료') you can change done button text
buttonBackground(R.drawable.xxx) (default: Blue Background) you can change done button background color
buttonTextColor(R.color.xxx) (default: white) done button text color
buttonDrawableOnly(R.drawable.xxx) (default: false) If you want show drawable button without text, use this method
max(Int, String or R.string.xxx) max content should picked from user device
min(Int, String or R.string.xxx) min content should picked from user device
drawerAlbum() / dropDownAlbum() (default: Drawer) You can choice Drawer or DropDown album style



UI

  • Change picker primary color : override color name in your colors.xml
<color name="ted_image_picker_primary">#your_color_code</color>
<color name="ted_image_picker_primary_pressed">#your_color_code</color>
  • Change textAppearance style : override text style in your styles.xml

style list

  • TextAppearance.TedImagePicker.Subhead
  • TextAppearance.TedImagePicker.Body1
  • TextAppearance.TedImagePicker.Caption
<style name="TextAppearance.MyApp.Body1" parent="@style/TextAppearance.AppCompat.Body1">
    <item name="android:textSize">...</item>
    <item name="android:fontFamily">...</item>
</style>
<style name="TextAppearance.TedImagePicker.Body1" parent="@style/TextAppearance.MyApp.Body1" />

FAQ

- Do not need to check permissions?

  • Yes, TedImagePicker automatically check permission. : TedImagePicker use TedPermission
  • But If you need You can check permission before start TedImagePicker.

- java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/databinding/DataBinderMapperImpl;

  • You have to enable databinding
  • Read this

- Duplicate class android.support.v4.xxx: Execution failed for task ':app:checkDebugDuplicateClasses'

  • Add android.enableJetifier=true in your gradle.properties file

- I'm using targetSdkVersion less than 33 and it doesn't work

  • You have to use targetSdkVersion 33
  • If you use targetSdkVersion 32, you can not support SDK 33(Android OS 13) device.
  • these day, there are so many android os 13 device.
  • So you have to use targetSdkVersion 33

- I'm using targetSdkVersion less than 34 and it doesn't work

  • Starting with targetSdkVersion 34, you need to control the permission READ_MEDIA_VISUAL_USER_SELECTED. : Grant partial access to photos and videos
  • If you still keep targetSdkVersion set to 33 to not control the READ_MEDIA_VISUAL_USER_SELECTED permission, you need to add the code below to your Manifest file.
<uses-permission
    android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"
    tools:node="remove" />



License

Copyright 2019 Ted Park

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.```