#file-dialog #message #native #macos #boxes #bsd #display

native-dialog

A library to display dialogs. Supports GNU/Linux, BSD Unix, macOS and Windows.

27 releases

0.7.0 Oct 31, 2023
0.6.4 Jun 10, 2023
0.6.3 Jan 22, 2022
0.6.1 Dec 3, 2021
0.4.1 Jul 29, 2020

#56 in GUI

Download history 10889/week @ 2024-08-02 11053/week @ 2024-08-09 11947/week @ 2024-08-16 14580/week @ 2024-08-23 13825/week @ 2024-08-30 10361/week @ 2024-09-06 7626/week @ 2024-09-13 5563/week @ 2024-09-20 7450/week @ 2024-09-27 7114/week @ 2024-10-04 7907/week @ 2024-10-11 6704/week @ 2024-10-18 5336/week @ 2024-10-25 6824/week @ 2024-11-01 5745/week @ 2024-11-08 4844/week @ 2024-11-15

24,431 downloads per month
Used in 41 crates (36 directly)

MIT license

70KB
2K SLoC

native-dialog

Crates.io Docs.rs License

A library to display file choosers and message boxes. Supports GNU/Linux, BSD Unix, macOS and Windows.

Installation

cargo add native-dialog

Usage

use native_dialog::{FileDialog, MessageDialog, MessageType};

fn main() {
    let path = FileDialog::new()
        .set_location("~/Desktop")
        .add_filter("PNG Image", &["png"])
        .add_filter("JPEG Image", &["jpg", "jpeg"])
        .show_open_single_file()
        .unwrap();

    let path = match path {
        Some(path) => path,
        None => return,
    };

    let yes = MessageDialog::new()
        .set_type(MessageType::Info)
        .set_title("Do you want to open the file?")
        .set_text(&format!("{:#?}", path))
        .show_confirm()
        .unwrap();

    if yes {
        do_something(path);
    }
}

Misc

Why the dialogs look ugly/blurry on Windows?

Turn on crate features or embed manifests into the .exe to enable visual styling and dpi awareness for your program. Check out examples/windows_manifest and examples/windows_features for example.

Why the program crashed when opening a dialog on macOS?

The UI framework of macOS (Cocoa) has a limitation that all UI operations must be performed on the main thread.

Linux dependencies

The Linux implementation of native-dialog requires either Zenity or Kdialog to be installed. Otherwise you'll get a No Implementation error.

Dependencies

~0.4–9.5MB
~106K SLoC