Awesome Open Source
Awesome Open Source


Lassi is simplest way to pick media (either image, video, audio or doc)

Lassi Media picker

image       image

Key features

  • Android 11 support
  • Simple implementation
  • Set your own custom styles
  • Filter by particular media type
  • Filter videos by min and max time
  • Enable/disable camera from LassiOption



  • Step 1. Add the JitPack repository in your project build.gradle:

        allprojects {
    	    repositories {
    		    maven { url '' }


    If Android studio version is Arctic Fox then add it in your settings.gradle:

       dependencyResolutionManagement {
    		repositories {
        		maven { url '' }
  • Step 2. Add the dependency in your app module build.gradle:

        dependencies {
            implementation 'com.github.Mindinventory:Lassi:0.2.2'


  • Step 1. Add Lassi in to your activity class:

            val intent = Lassi(this)
                .with(LassiOption.CAMERA_AND_GALLERY) // choose Option CAMERA, GALLERY or CAMERA_AND_GALLERY
                .setMediaType(MediaType.VIDEO) // MediaType : VIDEO IMAGE, AUDIO OR DOC
                .setCompressionRation(10) // compress image for single item selection (can be 0 to 100)
                .setMinTime(15) // for MediaType.VIDEO only
                .setMaxTime(30) // for MediaType.VIDEO only
                .setSupportedFileTypes("mp4", "mkv", "webm", "avi", "flv", "3gp") // Filter by limited media format (Optional)
                .setMinFileSize(100) // Restrict by minimum file size 
                .setMaxFileSize(1024) //  Restrict by maximum file size
                .disableCrop() // to remove crop from the single image selection (crop is enabled by default for single image)
                 * Configuration for  UI
                .setCropType(CropImageView.CropShape.RECTANGLE) // choose shape for cropping after capturing an image from camera (for MediaType.IMAGE only)
                .setCropAspectRatio(1, 1) // define crop aspect ratio for cropping after capturing an image from camera (for MediaType.IMAGE only)
                .enableFlip() // Enable flip image option while image cropping (for MediaType.IMAGE only)
                .enableRotate() // Enable rotate image option while image cropping (for MediaType.IMAGE only)
                .enableActualCircleCrop() // Enable actual circular crop (only for MediaType.Image and CropImageView.CropShape.OVAL)
  • Step 2. Get Lassi result in ActivityResultCallback lambda function.

        private val receiveData =
                registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {
                    if (it.resultCode == Activity.RESULT_OK) {
                        val selectedMedia =
                   as ArrayList<MiMedia>
                        if (!selectedMedia.isNullOrEmpty()) {
                            ivEmpty.isVisible = selectedMedia.isEmpty()

Document access permission note

If Android device SDK is >= 30 and wants to access document (only for choose the non media file) then add android.permission.MANAGE_EXTERNAL_STORAGE permission in your app otherwise library won't allow to access documents. Kindly check sample app for more detail.

Guideline for contributors

Contribution towards our repository is always welcome, we request contributors to create a pull request to the develop branch only.

Guideline to report an issue/feature request

It would be great for us if the reporter can share the below things to understand the root cause of the issue.

  • Library version
  • Code snippet
  • Logs if applicable
  • Device specification like (Manufacturer, OS version, etc)
  • Screenshot/video with steps to reproduce the issue


  • minSdkVersion >= 17
  • Androidx

Library used

ProGaurd rules

-dontwarn com.bumptech.glide.**


Lassi is MIT-licensed.

Let us know!

We’d be really happy if you send 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 our work.

app development

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (688,816
Kotlin (59,374
Android (40,818
Image (4,744
Video (4,505
Audio (4,020
Android Library (3,299
Camera (1,703
Easy To Use (842
Document (772
Picker (583
Photo (413
Videos (411
Crop (304
Related Projects