# nfd-rs [![](http://meritbadge.herokuapp.com/nfd)](https://crates.io/crates/nfd) [![](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/saurvs/nfd-rs/blob/master/LICENSE.md)

`nfd-rs` is a Rust binding to the library [nativefiledialog](https://github.com/mlabbe/nativefiledialog), that provides a convenient cross-platform interface to opening file dialogs on Linux, OS X and Windows.

This crate has been tested on Mac, Window and Linux (Ubuntu 14.04) and supports single/mutliple and save dialogs, notice APIs may break with newer versions.

## Usage

* Add the dependency `nfd` in your ```Cargo.toml```
  ```toml
  [dependencies]
  nfd = { git = "https://github.com/saurvs/nfd-rs.git" }
  ```

* Open a single file dialog
  ```rust
  extern crate nfd;

  use nfd::Response

  fn main() {

    let result = nfd::open_file_dialog(None, None).unwrap_or_else(|e| {
    	panic!(e);
    });

    match result {
        Response::Okay(file_path) => println!("File path = {:?}", file_path),
        Response::Cancel => println!("User canceled"),
    }
  }
  ```

* Open a multi file dialog using builder with jpg files as filter
  ```rust
  extern crate nfd;

  use nfd::Response

  fn main() {

    let result = nfd::dialog_multiple().filter("jpg").open().unwrap_or_else(|e| {
    	panic!(e);
    });

    match result {
        Response::OkayMultiple(files) => println!("Files {:?}", files),
        Response::Cancel => println!("User canceled"),
    }
  }
  ```

## Screenshot

![Cocoa on El Capitan](screenshots/cocoa_el_capitan.png?raw=true)