REPOSITORY OVERVIEW

Live repository statistics

★ 1.6KStars

⑂ 880Forks

◯ 42Open issues

◉ 1.6KWatchers

README preview

fluter_file_picker

File Picker

A package that allows you to use the native file explorer to pick single or multiple files, with extensions filtering support.

Currently supported features

Uses OS default native pickers
Supports multiple platforms (Mobile, Web, Desktop)
Supports WebAssembly (Wasm) compilation
Pick files using custom format filtering — you can provide a list of file extensions (pdf, svg, zip, etc.)
Pick files from cloud files (GDrive, Dropbox, iCloud)
Single or multiple file picks
Supports retrieving as XFile (cross_file) for easy manipulation with other libraries
Different default type filtering (media, image, video, audio or any)
Picking directories
Picking both files and directories simultaneously
Load file data immediately into memory (Uint8List) if needed;
Open a save-file / save-as dialog (a dialog that lets the user specify the drive, directory, and name of a file to save)

If you have any feature that you want to see in this package, please feel free to issue a suggestion. 🎉

Compatibility Chart

API	Android	iOS	Linux	macOS	Windows	Web
`clearTemporaryFiles()`	:white_check_mark:	:white_check_mark:	:x:	:x:	:x:	:x:
`getDirectoryPath()`	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:x:
`pickFileAndDirectoryPaths()`	:x:	:x:	:x:	:white_check_mark:	:x:	:x:
`pickFile()`	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
`pickFiles()`	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
`saveFile()`	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:

See the API section of the File Picker Wiki or the official API reference on pub.dev for further details.

Darwin implementation notes

The iOS and macOS native implementations now live under the shared Darwin source tree. The iOS implementation requires iOS 14.0 or newer because it uses PHPickerViewController and PHPickerResult.

The old iOS compile-time flags (PICKER_MEDIA, PICKER_AUDIO, PICKER_DOCUMENT) were part of the legacy Objective-C implementation and are no longer used in the Darwin source path.

Documentation

See the File Picker Wiki for every detail on about how to install, setup and use it.

File Picker Wiki

Usage

Quick simple usage example:

Memory usage recommendation

When picking multiple or large files on mobile/desktop, avoid loading all bytes in memory (withData: true) as it can cause out of memory errors.

Prefer withReadStream: true and keep withData: false:

FilePickerResult? result = await FilePicker.pickFiles(
  allowMultiple: true,
  withData: false,
  withReadStream: true,
);

You can still use withData: true for small files or single selections when immediate byte access is required.

Single file

PlatformFile? file = await FilePicker.pickFile();

if (file != null) {
  print(file.name);
  print(file.size);
} else {
  // User canceled the picker
}

Multiple files

FilePickerResult? result = await FilePicker.pickFiles(allowMultiple: true);

if (result != null) {
  List<File> files = result.paths.map((path) => File(path!)).toList();
} else {
  // User canceled the picker
}

Multiple files with extension filter

FilePickerResult? result = await FilePicker.pickFiles(
  allowMultiple: true,
  type: FileType.custom,
  allowedExtensions: ['jpg', 'pdf', 'doc'],
);

Pick a directory

String? selectedDirectory = await FilePicker.getDirectoryPath();

if (selectedDirectory == null) {
  // User canceled the picker
}

Save-file / save-as dialog

String? outputFile = await FilePicker.saveFile(
  dialogTitle: 'Please select an output file:',
  fileName: 'output-file.pdf',
);

if (outputFile == null) {
  // User canceled the picker
}

Load result and file details

FilePickerResult? result = await FilePicker.pickFiles();

if (result != null) {
  PlatformFile file = result.files.first;

  print(file.name);
  print(file.bytes);
  print(file.size);
  print(file.extension);
  print(file.path);
} else {
  // User canceled the picker
}

Retrieve all files as XFiles or individually

FilePickerResult? result = await FilePicker.pickFiles();

if (result != null) {
  // All files
  List<XFile> xFiles = result.xFiles;

  // Individually
  XFile xFile = result.files.first.xFile;
} else {
  // User canceled the picker
}

Pick and upload a file to Firebase Storage with Flutter Web

FilePickerResult? result = await FilePicker.pickFiles();

if (result != null) {
  Uint8List fileBytes = result.files.first.bytes;
  String fileName = result.files.first.name;
  
  // Upload file
  await FirebaseStorage.instance.ref('uploads/$fileName').putData(fileBytes);
}

For full usage details refer to the Wiki above.

Example App

Android

DemoAndroid

iOS

DemoMultiFilters

macOS

DemoMacOS

Linux

DemoLinux

Windows

DemoWindows

Getting Started

For help getting started with Flutter, view our online documentation.

For help on editing plugin code, view the documentation.

ALGORITHMICALLY RELATED

Similar Open-Source Projects

Selected from shared topics, language and repository description—not editorial ratings.

hpoul /

file_picker_writable

★ 18

Flutter plugin to choose files which can be read, referenced and written back at a later time.

Active repositoryHas homepage

DartMIT#android#dart#filepicker#flutter

⑂ 15 forks◯ 32 issuesUpdated Jun 9, 2026

Project homepage ↗

View details View on GitHub ↗