Awesome

TedImagePicker

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

</br></br>

Demo

Image Select	Select Album	Scroller

</br></br>

Setup

Gradle

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. </br> <img src="https://phaser.io/content/news/2015/09/10000-stars.png" width="200">

</br></br>

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)

</br></br>

Customize

• You can customize what you want

Function

Common

Multi Select

</br></br>

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" />

</br></br>

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