Skip to content

Image Pipeline Playground

feat(desktop): add native open and folder picker IPC

Mohammad Rajaei4237b2c08f02
diff --git a/desktop/README.md b/desktop/README.md
index 0fd2d82..c0b5a4c 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -46,4 +46,10 @@ cd .. && npm run desktop
2. PyInstaller onedir sidecar → `desktop/resources/server/image-pipes-server(.exe)`
3. electron-builder wraps Electron + sidecar + examples
-Runtime data (cache, uploads, downloads) goes under the OS userData folder, not Program Files.
+Runtime data (cache, uploads, downloads, asset registry) goes under the OS userData folder, not Program Files.
+
+## Desktop file I/O
+
+- **Load Images** uses native open-file / open-folder dialogs and registers local paths as asset batches (no copy into `uploads/`).
+- **Save Image** can write directly to a user-picked output folder; ZIP download remains a fallback when no folder is set.
+- The preload bridge exposes `window.imagePipesDesktop` (`openImages`, `openFolder`, `pickFolder`, `revealInFolder`).
diff --git a/desktop/src/main.cjs b/desktop/src/main.cjs
index 1856ae1..b588f4d 100644
--- a/desktop/src/main.cjs
+++ b/desktop/src/main.cjs
@@ -1,10 +1,12 @@
-const { app, BrowserWindow, dialog, Menu, shell } = require('electron')
+const { app, BrowserWindow, dialog, ipcMain, Menu, shell } = require('electron')
const { spawn } = require('node:child_process')
const http = require('node:http')
const net = require('node:net')
const path = require('node:path')
const fs = require('node:fs')
+const IMAGE_EXTENSIONS = ['png', 'jpg', 'jpeg', 'bmp', 'tif', 'tiff', 'webp', 'gif']
+
const DEFAULT_BACKEND_PORT = 8000
const DEFAULT_VITE_PORT = 5173
/** Vite HMR UI — only when launched with `electron . --dev` (npm run desktop). */
@@ -208,6 +210,50 @@ function uiUrl() {
return `http://127.0.0.1:${backendPort}`
}
+function registerDesktopIpc() {
+ ipcMain.handle('desktop:openImages', async () => {
+ const result = await dialog.showOpenDialog(mainWindow ?? undefined, {
+ title: 'Choose images',
+ properties: ['openFile', 'multiSelections'],
+ filters: [
+ { name: 'Images', extensions: IMAGE_EXTENSIONS },
+ { name: 'All Files', extensions: ['*'] },
+ ],
+ })
+ if (result.canceled) return { canceled: true, paths: [] }
+ return { canceled: false, paths: result.filePaths }
+ })
+
+ ipcMain.handle('desktop:openFolder', async () => {
+ const result = await dialog.showOpenDialog(mainWindow ?? undefined, {
+ title: 'Choose image folder',
+ properties: ['openDirectory'],
+ })
+ if (result.canceled || result.filePaths.length === 0) {
+ return { canceled: true, path: null }
+ }
+ return { canceled: false, path: result.filePaths[0] }
+ })
+
+ ipcMain.handle('desktop:pickFolder', async () => {
+ const result = await dialog.showOpenDialog(mainWindow ?? undefined, {
+ title: 'Choose output folder',
+ properties: ['openDirectory', 'createDirectory'],
+ })
+ if (result.canceled || result.filePaths.length === 0) {
+ return { canceled: true, path: null }
+ }
+ return { canceled: false, path: result.filePaths[0] }
+ })
+
+ ipcMain.handle('desktop:revealInFolder', async (_event, targetPath) => {
+ if (typeof targetPath !== 'string' || !targetPath.trim()) {
+ throw new Error('Path is required')
+ }
+ shell.showItemInFolder(path.resolve(targetPath))
+ })
+}
+
async function createWindow() {
mainWindow = new BrowserWindow({
width: 1440,
@@ -258,6 +304,7 @@ async function bootstrap() {
app.whenReady().then(() => {
Menu.setApplicationMenu(null)
+ registerDesktopIpc()
void bootstrap().catch(async (error) => {
console.error(error)
stopChildren()
diff --git a/desktop/src/preload.cjs b/desktop/src/preload.cjs
index a9d7c10..4174e62 100644
--- a/desktop/src/preload.cjs
+++ b/desktop/src/preload.cjs
@@ -1,6 +1,10 @@
-const { contextBridge } = require('electron')
+const { contextBridge, ipcRenderer } = require('electron')
contextBridge.exposeInMainWorld('imagePipesDesktop', {
isDesktop: true,
platform: process.platform,
+ openImages: () => ipcRenderer.invoke('desktop:openImages'),
+ openFolder: () => ipcRenderer.invoke('desktop:openFolder'),
+ pickFolder: () => ipcRenderer.invoke('desktop:pickFolder'),
+ revealInFolder: (targetPath) => ipcRenderer.invoke('desktop:revealInFolder', targetPath),
})