{"id":13643345,"url":"https://github.com/jrvansuita/PickImage","last_synced_at":"2025-04-21T01:32:22.642Z","repository":{"id":41094986,"uuid":"72556002","full_name":"jrvansuita/PickImage","owner":"jrvansuita","description":"📸 🖼️ Shows a DialogFragment with camera and gallery options. User can choose which provider wants to pick images from. ","archived":false,"fork":false,"pushed_at":"2023-04-03T12:44:20.000Z","size":5739,"stargazers_count":469,"open_issues_count":6,"forks_count":106,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-04T18:11:10.440Z","etag":null,"topics":["android","android-library","android-ui","camera","dialog","dialogfragment","gallery","gallery-options","java","listener","material-design","pickimage","ui"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jrvansuita.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-11-01T16:43:11.000Z","updated_at":"2024-06-27T09:28:20.000Z","dependencies_parsed_at":"2024-01-14T11:10:28.397Z","dependency_job_id":"4686ee1e-813e-4407-beec-f8fd89dcb3e4","html_url":"https://github.com/jrvansuita/PickImage","commit_stats":null,"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrvansuita%2FPickImage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrvansuita%2FPickImage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrvansuita%2FPickImage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrvansuita%2FPickImage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jrvansuita","download_url":"https://codeload.github.com/jrvansuita/PickImage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249982608,"owners_count":21355732,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-library","android-ui","camera","dialog","dialogfragment","gallery","gallery-options","java","listener","material-design","pickimage","ui"],"created_at":"2024-08-02T01:01:46.181Z","updated_at":"2025-04-21T01:32:20.596Z","avatar_url":"https://github.com/jrvansuita.png","language":"Java","funding_links":["https://ko-fi.com/A406JCM'"],"categories":["选择器(Picker)"],"sub_categories":[],"readme":"\u003c!-- Library Logo --\u003e\n\u003cimg src=\"https://github.com/jrvansuita/PickImage/blob/master/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png?raw=true\" align=\"left\" hspace=\"1\" vspace=\"1\"\u003e\n\n\u003c!-- Buy me a cup of coffee --\u003e\n\u003ca href='https://ko-fi.com/A406JCM' style='margin:13px;' target='_blank' align=\"right\"\u003e\u003cimg align=\"right\" height='36' src='https://az743702.vo.msecnd.net/cdn/kofi4.png?v=f' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\u003ca href='https://play.google.com/store/apps/details?id=com.vansuita.pickimage.sample\u0026pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1' target='_blank' align=\"right\"  style='margin:13px;'\u003e\u003cimg align=\"right\" height='45' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' alt='Get it on Google Play' /\u003e\u003c/a\u003e\n# PickImage\n\n\nThis is an [**Android**](https://developer.android.com) project. It shows a [DialogFragment](https://developer.android.com/reference/android/app/DialogFragment.html) with Camera or Gallery options. The user can choose from which provider wants to pick an image.\n\n\u003c/br\u003e \n\u003c/br\u003e \n\u003c/br\u003e \n\n\u003c!-- JitPack integration --\u003e\n[![JitPack](https://jitpack.io/v/jrvansuita/PickImage.svg)](https://jitpack.io/#jrvansuita/PickImage)\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-PickImage-green.svg?)](https://android-arsenal.com/details/1/4614) [![MaterialUp](https://img.shields.io/badge/MaterialUp-PickImage-6ad0d9.svg?)](https://www.uplabs.com/posts/pickimage) [![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fjrvansuita%2FPickImage\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=VIEWS\u0026edge_flat=false)](https://hits.seeyoufarm.com)\n\n# Dialog screenshots\n\n#### Default icons.\n\u003cimg src=\"images/dialogs/light_vertical_left_simple.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/light_horizontal_top_simple.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/light_horizontal_left_simple.png\" height='auto' width='250'/\u003e\n\n#### Colored icons.\n\u003cimg src=\"images/dialogs/light_vertical_left_colored.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/light_horizontal_top_colored.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/light_horizontal_left_colored.png\" height='auto' width='250'/\u003e\n\n#### Custom dialog.\n\u003cimg src=\"images/dialogs/dark_vertical_left.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/dark_horizontal_top.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/dark_horizontal_left.png\" height='auto' width='250'/\u003e\n\n#### System dialog.\n\u003cimg src=\"images/dialogs/all_system_dialog.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/camera_system_dialog.png\" height='auto' width='250'/\u003e\u003cimg src=\"images/dialogs/images_system_dialog.png\" height='auto' width='250'/\u003e\n\n[![Appetize.io](https://img.shields.io/badge/Apptize.io-Run%20Now-brightgreen.svg?)](https://appetize.io/embed/91gknbry9vrtz281b7jy244e0m?device=nexus7\u0026maxSize=50\u0026autoplay=true\u0026orientation=portrait\u0026deviceColor=black) [![Demo](https://img.shields.io/badge/Demo-Download-blue.svg)](http://apk-dl.com/dl/com.vansuita.pickimage.sample)\n [![Codacy Badge](https://api.codacy.com/project/badge/Grade/118bb89e3bed43e2b462201654224a60)](https://www.codacy.com/app/jrvansuita/PickImage?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=jrvansuita/PickImage\u0026amp;utm_campaign=Badge_Grade) \u003ca target=\"_blank\" href=\"https://developer.android.com/reference/android/os/Build.VERSION_CODES.html#GINGERBREAD\"\u003e\u003cimg src=\"https://img.shields.io/badge/API-9%2B-blue.svg?style=flat\" alt=\"API\" /\u003e\u003c/a\u003e\n \n \n# Setup\n\n#### Step #1. Add the JitPack repository to your build.gradle file:\n```gradle\nallprojects {\n    repositories {\n\tmaven { url \"https://jitpack.io\" }\n    }\n}\n```\n#### Step #1.1 Or add the JitPack repository to the settings.gradle file:\n\n```gradle\ndependencyResolutionManagement {\n    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)\n    repositories {\n       maven { url 'https://jitpack.io' }\n    }\n}\n```\n     \n#### Step #2. Add the dependency ([See latest release](https://jitpack.io/#jrvansuita/PickImage)).\n```groovy\ndependencies {\n    implementation 'com.github.jrvansuita:PickImage:+'\n}\n```\n# Implementation\n\n#### Step #1. Overriding the library file provider authority to avoid installation conflicts.\nThe use of this library can cause [INSTALL_FAILED_CONFLICTING_PROVIDER](https://developer.android.com/guide/topics/manifest/provider-element.html#auth) if you skip this step. Update your AndroidManifest.xml with this exact provider declaration below.\n```xml\n\u003cmanifest ...\u003e\n    \u003capplication ...\u003e\n        \u003cprovider\n            android:name=\"com.vansuita.pickimage.provider.PickImageFileProvider\"\n            android:authorities=\"${applicationId}.com.vansuita.pickimage.provider\"\n            android:exported=\"false\"\n            android:grantUriPermissions=\"true\"\n            tools:replace=\"android:authorities\"\u003e\n            \u003cmeta-data\n                android:name=\"android.support.FILE_PROVIDER_PATHS\"\n                android:resource=\"@xml/picker_provider_paths\" /\u003e\n        \u003c/provider\u003e\n    \u003c/application\u003e\t\n\u003c/manifest\u003e \n```\n\n#### Step #2 - Showing the dialog.\n```java\nPickImageDialog.build(new PickSetup()).show(this);\n``` \n#### Step #3 - Applying the listeners.\n##### Method #3.1 - Make your AppCompatActivity implements IPickResult.\n```java\n@Override\npublic void onPickResult(PickResult r) {\n    if (r.getError() == null) {\n        //If you want the Uri.\n        //Mandatory to refresh image from Uri.\n        //getImageView().setImageURI(null);\n\n        //Setting the real returned image.\n        //getImageView().setImageURI(r.getUri());\n\n        //If you want the Bitmap.\n        getImageView().setImageBitmap(r.getBitmap());\n\n        //Image path\n        //r.getPath();\n    } else {\n        //Handle possible errors\n        //TODO: do what you have to do with r.getError();\n        Toast.makeText(this, r.getError().getMessage(), Toast.LENGTH_LONG).show();\n    }\n}\n```\n\n##### Method #3.2 - Set the listener using the public method (Good for Fragments).\n\n```java\nPickImageDialog.build(new PickSetup())\n               .setOnPickResult(new IPickResult() {\n                  @Override\n                  public void onPickResult(PickResult r) {\n                     //TODO: do what you have to...\n                  }\n               })\n\t       .setOnPickCancel(new IPickCancel() {\n\t\t  @Override\n\t\t  public void onCancelClick() {\n\t\t\t//TODO: do what you have to if user clicked cancel\n\t\t   }\n\t\t}).show(getSupportFragmentManager());\n```\n\n#### Step #4 - Customize you Dialog using PickSetup.\n\n```java\nPickSetup setup = new PickSetup()\n            .setTitle(yourText)\n            .setTitleColor(yourColor)\n            .setBackgroundColor(yourColor)\n            .setProgressText(yourText)\n            .setProgressTextColor(yourColor)\n            .setCancelText(yourText)\n            .setCancelTextColor(yourColor)\n            .setButtonTextColor(yourColor)\n            .setDimAmount(yourFloat)\n            .setFlip(true)\n            .setMaxSize\n            .setPickTypes(EPickType.GALLERY, EPickType.CAMERA)\n            .setCameraButtonText(yourText)\n            .setGalleryButtonText(yourText)\n            .setIconGravity(Gravity.LEFT)\n            .setButtonOrientation(LinearLayoutCompat.VERTICAL)\n            .setSystemDialog(false)\n            .setGalleryIcon(yourIcon)\n            .setCameraIcon(yourIcon)\n            .setGalleryChooserTitle(yourText)\n            .setCameraChooserTitle(yourText);\n/*... and more to come. */\n```\n\n# Additionals\n\n#### Own click implementations.\nIf you want to write your own button click event, just use [IPickClick](library/src/main/java/com/vansuita/pickimage/listeners/IPickClick.java) listener like in the example below. You may want to take a look at the sample app.\n \n ```java\n PickImageDialog.build(setup)\n         .setOnClick(new IPickClick() {\n             @Override\n             public void onGalleryClick() {\n                 Toast.makeText(SampleActivity.this, \"Gallery Click!\", Toast.LENGTH_LONG).show();\n             }\n\n             @Override\n             public void onCameraClick() {\n                 Toast.makeText(SampleActivity.this, \"Camera Click!\", Toast.LENGTH_LONG).show();\n             }\n          }).show(this);\n``` \n\n#### For dismissing the dialog.\n\n```java\nPickImageDialog dialog = PickImageDialog.build(...);\ndialog.dismiss();\n```\n\n#### Force a specific width and height.\n```java\nnew PickSetup().setWidth(600).setHeight(800);\n```\n\n#### Not just an ImagePicker anymore! You can pick video too.\nYou can tell the setup to pick video instead of photo! (default option if you don't mention is to pick Image)\n```java\nnew PickSetup().setVideo(true);\n```\n  \n# Sample app code.\n You can take a look at the sample app [located on this project](/app/).\n \n# \n\n\u003ca href=\"https://www.instagram.com/jnrvans/\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://camo.githubusercontent.com/c9dacf0f25a1489fdbc6c0d2b41cda58b77fa210a13a886d6f99e027adfbd358/68747470733a2f2f6564656e742e6769746875622e696f2f537570657254696e7949636f6e732f696d616765732f7376672f696e7374616772616d2e737667\" alt=\"Instagram\" witdh=\"44\" height=\"44\" hspace=\"10\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/jrvansuita\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://camo.githubusercontent.com/b079fe922f00c4b86f1b724fbc2e8141c468794ce8adbc9b7456e5e1ad09c622/68747470733a2f2f6564656e742e6769746875622e696f2f537570657254696e7949636f6e732f696d616765732f7376672f6769746875622e737667\" alt=\"Github\" witdh=\"44\" height=\"44\" hspace=\"10\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://play.google.com/store/apps/dev?id=8002078663318221363\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://camo.githubusercontent.com/8ce12185c778e13eed2073e7a6aba042ce5092d4d41744e7052e0fc16363c386/68747470733a2f2f6564656e742e6769746875622e696f2f537570657254696e7949636f6e732f696d616765732f7376672f676f6f676c655f706c61792e737667\" alt=\"Google Play Store\" witdh=\"44\" height=\"44\" hspace=\"10\"\u003e\n\u003c/a\u003e\n\u003ca href=\"mailto:vansuita.jr@gmail.com\" target=\"_blank\" \u003e\n  \u003cimg src=\"https://camo.githubusercontent.com/4a3dd8d10a27c272fd04b2ce8ed1a130606f95ea6a76b5e19ce8b642faa18c27/68747470733a2f2f6564656e742e6769746875622e696f2f537570657254696e7949636f6e732f696d616765732f7376672f676d61696c2e737667\" alt=\"E-mail\" witdh=\"44\" height=\"44\" hspace=\"10\"\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrvansuita%2FPickImage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjrvansuita%2FPickImage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrvansuita%2FPickImage/lists"}