Docs / File dialogs

File dialogs

Native Windows file/folder picker prompts. All return nil if the user cancels.

Library#03 of 23 Functions4
openfiledialog(filter: string?, title: string?) → string? yields
Prompt to select a single file.
lua
local path = openfiledialog("Lua files\0*.lua\0All\0*.*\0", "Pick a script")
if path then print(path) end
openfilesdialog(filter: string?, title: string?) → {string}? yields
Multi-select variant. Returns an array of paths.
lua
local paths = openfilesdialog(nil, "Pick logs")
for _, p in ipairs(paths or {}) do print(p) end
savefiledialog(filter: string?, defaultName: string?, title: string?) → string? yields
"Save as…" prompt. Returns the chosen destination path.
lua
local dest = savefiledialog("Text\0*.txt\0", "dump.txt", "Save dump")
if dest then writefile(dest, "hello") end
openfolderdialog(title: string?) → string? yields
Prompt to select a directory.
lua
local dir = openfolderdialog("Pick dump target")
print(dir)