rfd

Rusty file dialogs for Windows, Linux (GTK), MacOS And WASM32.

Why RFD?

• It uses 100% native API on all platforms, it does not spawn any processes in the background.
• It supports async/await syntax
• And if one day you decide to port your program to browser, WASM support is there for you!

Example

```rust // Sync Dialog let files = FileDialog::new() .addfilter("text", &["txt", "rs"]) .addfilter("rust", &["rs", "toml"]) .setdirectory(&"/") .pickfiles();

// Async Dialog let file = AsyncFileDialog::new() .addfilter("text", &["txt", "rs"]) .addfilter("rust", &["rs", "toml"]) .setdirectory(&"/") .pickfile() .await;

let data = file.read().await; ```

State

| API Stability | | ------------- | | 🚧 |

| Feature | Linux | Windows | MacOS [1] | Wasm32 | | ------------ | ----- | ------- | --------- | ------ | | SingleFile | ✔ | ✔ | ✔ | ✔ | | MultipleFile | ✔ | ✔ | ✔ | ✔ | | PickFolder | ✔ | ✔ | ✔ | ✖ | | SaveFile | ✔ | ✔ | ✔ | ✖ | | | | | | | | Filters | ✔ | ✔ | ✔ | ✔ | | StartingPath | ✔ | ✔ | ✔ | ✖ | | Async | ✔ | ✔ | ✔ | ✔ |

[1] Macos Sync dialog freezes when used with winit (same way as nfd) Caused by winit #1779

Diference bettwen MacOS Windowed App and MacOS NonWindowed App

• Macos async dialog requires an started NSApplication instance, so dialog is truly async only when opened in windowed env like winit,SDL2, etc. otherwise it will fallback to sync dialog.
• It is also recomended to spawn dialogs on main thread, RFD can run dialogs from any thread but it is only posible in windowed app and it adds a lite bit of overhead. So it is recomended to: spawn on main and await in other thread
• NonWindowed apps will never be able to spawn dialogs from threads diferent than main
• NonWindowed apps will never be able to spawn async dialogs

rfd-extras

AKA features that are not file related

| Feature | Linux | Windows | MacOS | Wasm32 | | ------------- | ----- | ------- | ----- | ------ | | MessageDialog | ✔ | ✔ | ✔ | ✔ | | PromptDialog | | | | | | ColorPicker | | | | |