A simple file/ directory picker dialog for android
Switch branches/tags
Clone or download
Latest commit 4534911 Mar 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
FilesLister android_target_update Feb 4, 2018
raw Screenshots added Jul 22, 2017
.gitignore gitignore updates Jan 23, 2018
LICENSE Create LICENSE Jul 22, 2017
README.md Update README.md Mar 29, 2018
build.gradle dependencies_version_updates Feb 4, 2018
deploy.properties deploy.properties Feb 4, 2018
gradle.properties Minor Fixes Aug 1, 2017
gradlew File/Directory lister and picker Jul 22, 2017
gradlew.bat File/Directory lister and picker Jul 22, 2017
settings.gradle File/Directory lister and picker Jul 22, 2017

README.md

FileListerDialog

FileListerDialog helps you to list and pick file/directory. Library is built for Android

Getting Started

Installing

To use this library simply import it by placing the following line under dependencies in your app module's build.gradle file

This library is posted in jCenter

   dependencies {
      implementation 'yogesh.firzen:FilesLister:1.0.1.g'
   }

If any problem occured while importing please add this line to your app module's build. gradle file

   repositories {
      maven {url "https://dl.bintray.com/firzenyogesh/maven"}
   }

This library has dependencies

   dependencies {
      implementation 'com.android.support:appcompat-v7:26.0.0'
      implementation 'com.android.support:design:26.0.0'
      implementation 'com.android.support:recyclerview-v7:26.0.0'
      implementation 'yogesh.firzen:MukkiyaSevaigal:1.0.6'
      implementation 'org.apache.commons:commons-io:1.3.2'
   }

Usage

After importing the library you can use FileListerDialog to list the files and pick one among them. Simply follow the steps

  1. Create an instance of FileListerDialog by using the static method createFileListerDialog()

    Default Instance:

       FileListerDialog fileListerDialog = FileListerDialog.createFileListerDialog(context);
    

    Instance with a theme for Dialog:

       FileListerDialog fileListerDialog = FileListerDialog.createFileListerDialog(context, themeId);
    
  2. Set OnFileSelectedListener so that you get what file/ directory has been selected

       filelister.setOnFileSelectedListener(new OnFileSelectedListener() {
             @Override
             public void onFileSelected(File file, String path) {
                   //your code here
             }
       });
    
  3. Set the default directory to load when showing the dialog:

    Using a file

       fileListerDialog.setDefaultDir(file);
    

    Using a file path

       fileListerDialog.setDefaultDir(path);
    
  4. Set the File Filter type to filter the type of files to be listed:

       fileListerDialog.setFileFilter(FileListerDialog.FILE_FILTER.ALL_FILES);
    

    Possible values are:

       FileListerDialog.FILE_FILTER.ALL_FILES
       FileListerDialog.FILE_FILTER.DIRECTORY_ONLY
       FileListerDialog.FILE_FILTER.IMAGE_ONLY
       FileListerDialog.FILE_FILTER.VIDEO_ONLY
       FileListerDialog.FILE_FILTER.AUDIO_ONLY
    
  5. Finally call show() to open the dialog.

       fileListerDialog.show();
    

Screenshots

FileListerDialog

Create a new folder

When a Directory is picked

When a file is picked

Authors

License

Copyright 2017 Yogesh Sundaresan

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.