NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1575 most downloaded on crates.io
Rusty File Dialog
Latest stable
0.18.0
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 2 weeks to 10 months
Most releases are documented
notes for 41 of 52 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
53 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
feat: Add set_show_hidden_files option for file dialogs by @bbopen in https://github.com/PolyMeilex/rfd/pull/306
| by @PolyMeilex in https://github.com/PolyMeilex/rfd/pull/347Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.17.2...0.18.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
gtk4 featureset_directory when set_file_name is also used.FileDialog::set_show_hidden_files and AsyncFileDialog::set_show_hidden_files to control hidden file visibility. Supported on macOS, Windows, and Linux (GTK3).FileDialog::set_directory and AsyncFileDialog::set_directory when using the zenity fallback backend on Linux.liblary typo in docstitle_el.set_text_content() rather than title_el.set_inner_html().set_text_content() rather than set_inner_html(), so rfd no longer uses innerHTML.% and could crash. The description is now shown as given, so %% is no longer shown as %."*") or an empty one ("") now uses the glob "*", not "*.*" or "*.", so a filter such as "All files" matches a name with no dot, like README.|. Also file names that start or end with a space are kept intact.Lower MSRV back to 1.88 by @PolyMeilex in https://github.com/PolyMeilex/rfd/pull/303
Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.17.1...0.17.2
Fix aarch64 compile error and add CI by @oscargus in https://github.com/PolyMeilex/rfd/pull/294
[!WARNING] Warning from the 0.17.0 releasse still stands please pay extra attention and testing to the xdg_portal backend, as it was fully rewritten.
Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.17.0...0.17.1
> Please pay extra attention to this, I want as much user testing for those changes as possible, as it is essentially a full rewrite.
[!WARNING] Please pay extra attention to this, I want as much user testing for those changes as possible, as it is essentially a full rewrite.
- xdg_portal: Drop the ridiculous dependency tree of the async ecosystem in favor of
libdbusby @PolyMeilex in https://github.com/PolyMeilex/rfd/pull/286tokioandasync-stdfeatures removed
Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.16.0...0.17.0
Nothing published for this version
fix: the pick_file() can return None when cancelled by @bioinformatist in https://github.com/PolyMeilex/rfd/pull/258
pick_file() can return None when cancelled by @bioinformatist in https://github.com/PolyMeilex/rfd/pull/258AsyncFileDialog::set_file_name documentation by @dolezvo1 in https://github.com/PolyMeilex/rfd/pull/269pick_file on Web by @kevinmehall in https://github.com/PolyMeilex/rfd/pull/273Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.15.4...0.16.0
ashpd upgrade (#255).pick_file() method of file dialog targeted WASM now can return None correctly when cancelled (#258)windows-sys to 0.60.ashpd Wayland APIs optional. These are now gated behind the wayland feature, which is enabled by default.-pub fn AsyncFileDialog::set_parent<W: HasWindowHandle + HasDisplayHandle>(self, parent: &W) -> Self
+pub fn AsyncFileDialog::set_parent<W: HasWindowHandle + HasDisplayHandle + ?Sized>(self, parent: &W) -> Self
-pub fn AsyncMessageDialog::set_parent<W: HasWindowHandle + HasDisplayHandle>(self, parent: &W) -> Self
+pub fn MessageDialog::set_parent<W: HasWindowHandle + HasDisplayHandle + ?Sized>(self, parent: &W) -> Self
-pub fn FileDialog::set_parent<W: HasWindowHandle + HasDisplayHandle>(self, parent: &W) -> Self
+pub fn rfd::FileDialog::set_parent<W: HasWindowHandle + HasDisplayHandle + ?Sized>(self, parent: &W) -> Self
-pub fn MessageDialog::set_parent<W: HasWindowHandle + HasDisplayHandle>(self, parent: &W) -> Self
+pub fn MessageDialog::set_parent<W: HasWindowHandle + HasDisplayHandle + ?Sized>(self, parent: &W) -> Self
deps: bump dispatch2 from 0.2 to 0.3 by @jqnatividad in https://github.com/PolyMeilex/rfd/pull/250
Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.15.3...0.15.4
Improve some error messages for xdg by @kristoff3r in https://github.com/PolyMeilex/rfd/pull/238
objc2 v0.6 by @madsmtm in https://github.com/PolyMeilex/rfd/pull/236Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.15.2...0.15.3
Bugfix: Fail to dismiss the Message Dialog merely in MacOS by @stuartZhang in https://github.com/PolyMeilex/rfd/pull/223
Full Changelog: https://github.com/PolyMeilex/rfd/compare/0.15.1...0.15.2
deps: Update ashpd to 0.10 by @torokati44 in https://github.com/PolyMeilex/rfd/pull/220
ashpd to 0.10.Move from objc crates to objc2 crates.
objc crates to objc2 crates.AsyncFileDialog blocking the executor on Windows (#191)TDF_SIZE_TO_CONTENT to TaskDialogIndirect config so that it can display longer text without truncating/wrapping (80 characters instead of 55) (#202)xdg-portal backend not accepting special characters in message dialogsset_parent require HasWindowHandle + HasDisplayHandleset_parent in XDG Portalsashpd to 0.9.Clone for FileHandleAvoid unnecessary heap allocation and copy
Use zenity as a fallback for XDG Portal
raw-window-handle to 0.6.winit in example to 0.29.ashpd to 0.8.FileDialog/AsyncFileDialog::set_can_create_directories, supported on macOS only.Thanks to @dtzxporter, @evilpie, @amrbashir, @bilelmoussaoui, @orowith2os, @czf0613 :tada: :rocket:
[Breaking] Users of the xdg-portal feature must now also select the tokio or async-std feature
xdg-portal feature must now also select the tokio
or async-std featureFix FileHandle::inner (under feature file-handle-inner) on wasm
FileHandle::inner (under feature file-handle-inner) on wasmAdd title support for WASM (#132 Thanks to @Easyoakland)
pick_folder on macOS (#127 Thanks to @bancek)save_file (#134 Thanks to @Easyoakland)gtk-sys to 0.18 (#143)ashpd to 0.6 (#133 Thanks to @bilelmoussaoui)windows-sys (#118 @Jake-Shadle)pick_folder on macOS (#127)save_file (#134)gtk-sys to 0.18 (#143)ashpd to 0.6 (#133)windows-sys (#118)xdg-portal: Bump to latest ASHPD and cleanup (#95) (fixes #119)
xdg-portal: Bump to latest ASHPD and cleanup (#95) (fixes #119)
Zenity message dialogs for xdg portal backend
Nothing published for this version
- Fix windows CC6 feature build
Update gtk-sys to 0.16 and windows-rs to 0.44
gtk-sys to 0.16 and windows-rs to 0.44Update gtk-sys to 0.16 and windows-rs to 0.44
gtk-sys to 0.16 and windows-rs to 0.44update raw-window-handle to 0.5 #80 (thanks to @amrbashir)
common-controls-v6 feature disabled by default as it causes problems downstream, will be re-enabled once that is resolved (1, 2)
feat: customize button text, Close #74 (Thanks to @meowtec)
XDG: decode URI before converting to PathBuf #70
- Windows-rs update 0.37
- Windows-rs update 0.35
Macos parent for sync FileDialog
parent feature was removed, it is always on now
parent feature was removed, it is always on nowxdg-portalgtk3 or xdg-portal, gtk is on by defaultwindow crate got updated to 0.32Safe Rust XDG Desktop Portal support (Thanks to @Be-ing and @bilelmoussaoui!)
gtk3 feature of the crate, if you do, dependency on GTK will be dropped and XDG portal will be used instead.- Rust edition bump - Gtk bump - windows-rs bump
Fixed #35 (Thanks for discovering and reporting goes to @lucasfernog and @OJFord)
Strip Win32 namespaces from directory paths #33 (Thanks to @parasyte!)
Nothing published for this version
Update RawWindowHandle to 0.4 (Thanks to @bwoods!)
NOTICE!
Fix duplicate msgbox title on Windows #26 (Thanks to @repi!)
New file dialog builder method set_title #23 (Thanks to @hatal175!)
set_title #23 (Thanks to @hatal175!)Fix set_directory on some windows setups #22
set_directory on some windows setups #22set_file_name on MacOS #21 (Thanks to @emilk!)set_parent support for MessageDialog on Windows #19 (Thanks to @lucasfernog!)
set_parent support for MessageDialog on Windows #19 (Thanks to @lucasfernog!)GTK save dialog now sets current_name correctly
current_name correctly (#18)- Update gtk
[Breaking] Fix misspeled OkCancel in MessageButtons #12 (Thanks to @r00ster91 :tada: )
OkCancel in MessageButtons #12 (Thanks to @r00ster91 :tada: )set_parent support for Windows #14 (Thanks to @lucasfernog :tada: )OkCancel in MessageButtons (#12)set_parent support for Windows (#14)Added set_file_name (thanks to @AngelOfSol for windows impl)
set_file_name (thanks to @AngelOfSol for windows impl)FileChooserNative (so when running in flatpak it will use xdg-portals properly)set_directory no longer takes double ref to AsPath<T>, so now you can just call set_directory("./") instead of set_directory(&"./")Nothing published for this version
Nothing published for this version
Dialogues on MacOs will now attempt to run even on threads different than main (Only if NSApp is available)
MessageDialog
AsyncMessageDialog
Dialogues on MacOs will now attempt to run even on threads different than main (Only if NSApp is available)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.