Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/nbsp-team/MaterialFilePicker

Picking files since 2015
https://github.com/nbsp-team/MaterialFilePicker

android android-library file-picker material picker

Last synced: 1 day ago
JSON representation

Picking files since 2015

Lists

README

        

# Material File Picker Unofficial
Material file picker library for Android by Arte al Programar

![](ss/main.png)

## What's new
- Require Android Jelly Bean 4.1.x (API 16+)
- Android 10 Compatibility
- Material Components for Android Support
- Night Mode Support
- New Icon Designs

## Add your project

Download library and add it to your project

or use `JitPack.io`

```
build.gradle (Project)

allprojects {
repositories {
jcenter()
maven { url "https://jitpack.io" }
}
}

build.gradle (Module: app)

dependencies {
...
implementation 'com.github.arteaprogramar:Android_MaterialFilePicker:version'
}

```

## Using (IMPORTANT)

- Add to Values

```
colors.xml

...
#fafafa
...

styles.xml

...
@color/colorBackground
...

```

- Open your class and add the following code

```
...
public static final int FILE_PICKER_REQUEST_CODE = 989
...

MaterialFilePicker()
// Pass a source of context. Can be:
// .withActivity(Activity activity)
// .withFragment(Fragment fragment)
// .withSupportFragment(androidx.fragment.app.Fragment fragment)
.withActivity(this)
// With cross icon on the right side of toolbar for closing picker straight away
.withCloseMenu(true)
// Entry point path (user will start from it)
.withPath(alarmsFolder.absolutePath)
// Root path (user won't be able to come higher than it)
.withRootPath(externalStorage.absolutePath)
// Showing hidden files
.withHiddenFiles(true)
// Want to choose only jpg images
.withFilter(Pattern.compile(".*\\.(jpg|jpeg)$"))
// Don't apply filter to directories names
.withFilterDirectories(false)
.withTitle("Sample title")
.withRequestCode(FILE_PICKER_REQUEST_CODE)
.start()
...

```

Override on activity result:

```java
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);

if (requestCode == FILE_PICKER_REQUEST_CODE && resultCode == RESULT_OK) {
String filePath = data.getStringExtra(FilePickerActivity.RESULT_FILE_PATH);
// Do anything with file
}
}
```

## Themes

To create a compatible (Light/Dark) theme, you can change the following colors to suit your theme.

```

?colorPrimary
?colorPrimaryDark
?colorAccent
?android:colorBackground


#212121
#4000695C


#8a000000

```

Runtime permissions:

You should handle runtime permissions in activity, from what you called Material File Picker.
Look [here](https://github.com/nbsp-team/MaterialFilePicker/blob/master/app/src/main/java/com/dimorinny/sample/MainActivity.java#L38-L69) for example code.