https://github.com/samhocevar/portable-file-dialogs

💬 Portable GUI dialogs library, C++11, single-header
https://github.com/samhocevar/portable-file-dialogs

Last synced: 7 days ago
JSON representation

💬 Portable GUI dialogs library, C++11, single-header

• Host: GitHub
• URL: https://github.com/samhocevar/portable-file-dialogs
• Owner: samhocevar
• License: wtfpl
• Created: 2018-10-12T11:04:17.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-03-21T13:56:06.000Z (25 days ago)
• Last Synced: 2025-04-01T14:17:17.014Z (14 days ago)
• Language: C++
• Homepage:
• Size: 166 KB
• Stars: 1,071
• Watchers: 25
• Forks: 102
• Open Issues: 31
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

• awesome-game-engine-dev - Portable File Dialogs - Single-header C++11 native dialogs on Windows, macOS, and Linux. (Libraries / C++)
• awesome-audio-plugin-framework - Portable File Dialogs
• AwesomeCppGameDev - portable-file-dialogs - header (C++)

README

        
# Portable File Dialogs

A free C++11 file dialog library.

-   works on Windows, Mac OS X, Linux

-   **single-header**, no extra library dependencies

-   **synchronous *or* asynchronous** (does not block the rest of your program!)

-   **cancelable** (kill asynchronous dialogues without user interaction)

-   **secure** (immune to shell-quote vulnerabilities)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a25d3fd6959a4333871f630ac70b6e09)](https://www.codacy.com/manual/samhocevar/portable-file-dialogs?utm_source=github.com&utm_medium=referral&utm_content=samhocevar/portable-file-dialogs&utm_campaign=Badge_Grade)

## Status

The library is now pretty robust. It is not as feature-complete as

[Tiny File Dialogs](https://sourceforge.net/projects/tinyfiledialogs/),

but has asynchonous dialogs, more maintainable code, and fewer potential

security issues.

The currently available backends are:

-   Win32 API (all known versions of Windows)

-   Mac OS X (using AppleScript)

-   GNOME desktop (using [Zenity](https://en.wikipedia.org/wiki/Zenity) or its clones Matedialog and Qarma)

-   KDE desktop (using [KDialog](https://github.com/KDE/kdialog))

Experimental support for Emscripten is on its way.

## Documentation

-   [`pfd`](doc/pfd.md) general documentation

-   [`pfd::message`](doc/message.md) message box

-   [`pfd::notify`](doc/notify.md) notification

-   [`pfd::open_file`](doc/open_file.md) file open

-   [`pfd::save_file`](doc/save_file.md) file save

-   [`pfd::select_folder`](doc/select_folder.md) folder selection

## History

-   0.1.0 (July 16, 2020): first public release

## Screenshots (Windows 10)

![warning-win32](https://user-images.githubusercontent.com/245089/47136607-76919a00-d2b4-11e8-8f42-e2d62c4f9570.png)

![notify-win32](https://user-images.githubusercontent.com/245089/47142453-2ff76c00-d2c3-11e8-871a-1a110ac91eb2.png)

![open-win32](https://user-images.githubusercontent.com/245089/47155865-0f8cd900-d2e6-11e8-8041-1e20b6f77dee.png)

## Screenshots (Mac OS X, dark theme)

![warning-osxdark](https://user-images.githubusercontent.com/245089/56053001-22dba700-5d53-11e9-8233-ca7a2c58188d.png)

![notify-osxdark](https://user-images.githubusercontent.com/245089/56053188-bc0abd80-5d53-11e9-8298-68aa96315c6c.png)

![open-osxdark](https://user-images.githubusercontent.com/245089/56053378-39363280-5d54-11e9-9583-9f1c978fa0db.png)

## Screenshots (Linux, GNOME desktop)

![warning-gnome](https://user-images.githubusercontent.com/245089/47136608-772a3080-d2b4-11e8-9e1d-60a7e743e908.png)

![notify-gnome](https://user-images.githubusercontent.com/245089/47142455-30900280-d2c3-11e8-8b76-ea16c7e502d4.png)

![open-gnome](https://user-images.githubusercontent.com/245089/47155867-0f8cd900-d2e6-11e8-93af-275636491ec4.png)

## Screenshots (Linux, KDE Plasma desktop)

![warning-kde](https://user-images.githubusercontent.com/245089/47149255-4dcccd00-d2d3-11e8-84c9-f85612784680.png)

![notify-kde](https://user-images.githubusercontent.com/245089/47149206-27a72d00-d2d3-11e8-8f1b-96e462f08c2b.png)

![open-kde](https://user-images.githubusercontent.com/245089/47155866-0f8cd900-d2e6-11e8-8006-f14b948afc55.png)