https://github.com/xayahsususu/libpickyou

Android file picker module with the style of Material You.
https://github.com/xayahsususu/libpickyou

Last synced: 10 days ago
JSON representation

Android file picker module with the style of Material You.

• Host: GitHub
• URL: https://github.com/xayahsususu/libpickyou
• Owner: XayahSuSuSu
• License: gpl-3.0
• Created: 2022-02-24T10:39:45.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-16T12:00:29.000Z (3 months ago)
• Last Synced: 2024-08-17T13:10:14.947Z (3 months ago)
• Language: Kotlin
• Homepage: https://jitpack.io/#xayahsususu/libpickyou
• Size: 3.84 MB
• Stars: 40
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


	 English



# PickYou

[![JitPack](https://jitpack.io/v/xayahsususu/libpickyou.svg)](https://jitpack.io/#xayahsususu/libpickyou)  ![minSdk](https://img.shields.io/badge/minSdk-24-green) [![License](https://img.shields.io/github/license/XayahSuSuSu/AndroidModule-PickYou?color=ff69b4)](./LICENSE)

Android file picker module with the style of Material You.

Use this module to pick files/directories easily.

## Features

- Write in [**compose**](https://developer.android.com/jetpack/compose)

- Easy to import and use.

- Highly customizable.

- Support for single/multiple selection.

- Monet enabled.

## Screenshots



	

	



## Implementation

1. Enable **JitPack** in `settings.gradle`/`settings.gradle.kts`

* **Groovy**

```

repositories {

    // ......

    maven { url 'https://jitpack.io' }

}

```

* **Kotlin**

```

repositories {

    // ......

    maven("https://jitpack.io")

}

```

2. Implementation

* **Groovy**

```

implementation 'com.github.xayahsususu:libpickyou:$PickYouVersion'

```

* **Kotlin**

```

implementation("com.github.xayahsususu:libpickyou:$PickYouVersion")

```

## Usage

1. Launch anywhere

```

val launcher = PickYouLauncher()

launcher.launch(context) { path ->

    // Code here.

}

```

2. Customization

See [PickYouLauncher](./libpickyou/src/main/kotlin/com/xayah/libpickyou/ui/PickYouLauncher.kt)

## Sample

See [sample](./app/src/main/kotlin/com/xayah/pickyou/MainActivity.kt)

## Credits

- [libsu](https://github.com/topjohnwu/libsu)

- [MaterialFiles](https://github.com/zhanghai/MaterialFiles)