Portable File Dialogs
A free, single-header C++11 library for cross-platform GUI file dialogs, message boxes, and notifications.
What is Portable File Dialogs?
Portable File Dialogs is a free, single-header C++11 library that provides native graphical user interface dialogs for file operations, message boxes, and notifications. It solves the problem of cross-platform dialog consistency by abstracting Windows, macOS, and Linux system APIs into a simple, unified interface for desktop applications.
C++ developers building cross-platform desktop applications who need native file dialogs, message boxes, or notifications without external dependencies or complex setup.
Developers choose Portable File Dialogs for its zero-dependency, single-header design, support for both synchronous and asynchronous operations, and strong focus on security and maintainability compared to alternatives like Tiny File Dialogs.
Overview
💬 Portable GUI dialogs library, C++11, single-header
Use Cases
Best For
- Adding native file open/save dialogs to a C++ desktop application
- Displaying cross-platform message boxes (info, warning, error) in C++ projects
- Implementing system notifications in C++ applications on Windows, macOS, or Linux
- Creating lightweight GUI tools without external library dependencies
- Ensuring secure dialog handling immune to shell-quote vulnerabilities
- Building portable C++ applications that require folder selection dialogs
Not Ideal For
- Applications requiring advanced dialog features like custom widgets, preview panes, or network location support
- Projects targeting Linux systems without GNOME or KDE desktop environments (e.g., headless servers or minimal installations)
- Teams using programming languages other than C++ or needing multi-language bindings for cross-platform development
Pros & Cons
Pros
Just include one header file with no external dependencies, making integration trivial and build processes clean, as highlighted in the README's 'single-header' emphasis.
Abstracts Win32 API, AppleScript, and GNOME/KDE tools to provide dialogs that match the native look and feel on Windows, macOS, and Linux, ensuring consistency.
Supports non-blocking dialogs that run in the background and can be programmatically terminated, preventing UI freezes, as noted in the README's features.
Immune to shell-quote vulnerabilities and other common security issues, offering robust handling for safe user interactions in desktop applications.
Cons
Admits to being less feature-complete than alternatives like Tiny File Dialogs, lacking advanced customizations such as extensive filtering or dialog styling.
Relies on Zenity or KDialog being installed on Linux systems, which may fail on minimal setups or non-standard distributions, limiting portability.
Only available for C++ projects with no bindings for other languages, restricting use in multi-language or non-C++ environments without extra work.
Frequently Asked Questions
Related Projects
ProtoBufProtocol Buffers - Google's data interchange format
C/C++A curated list of awesome C++ (or C) frameworks, libraries, resources, and shiny things. Inspired by awesome-... stuff.
JSON for Modern C++JSON for Modern C++
BlazorASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.