Getting Started
1. Install IMG Flow
Visit imgflow.app and click Download for Mac. After purchase, you'll get a link to download the .dmg file, open it, and drag IMG Flow into your Applications folder. That's the whole install.
The app runs natively on both Intel and Apple Silicon Macs — there's a separate build for each architecture, and you get the one that matches your Mac. Minimum requirement: macOS 12 Monterey.
2. First launch
Open IMG Flow from your Applications folder. The first time you launch, you'll see a brief splash and then the main window with an empty canvas. On the left is the Tools sidebar. On the right is the Pipelines sidebar. The big dark area in the middle is the canvas where you build your pipelines. At the bottom is the image queue.
On a blank canvas you'll see a Start Plumbing panel with a few starter pipelines you can click to try. Pick any of them to build a pre-wired pipeline on the canvas, or dismiss it and build your own from scratch.
3. Set your default output folder
Click the gear icon in the top-right corner of the window to open Settings. Under General → Output Folder, click Browse and pick a folder where you want processed images to land by default. This folder becomes the default for every new Local Folder destination you add. You can override it per-pipeline.
Building Pipelines
4. The six processing tools
IMG Flow ships with six processing tools, listed in the recommended pipeline order. The app will warn you if your pipeline runs them out of order — and one click on Auto Build reorders them optimally.
- 1. Rotate — Rotate images 90°, 180°, or flip horizontally/vertically. Useful for batches of sideways phone photos. Runs first because rotation doesn't affect quality.
- 2. Crop — Sets the shape of your image. Three modes: Aspect ratio (1:1, 4:3, 16:9, 3:2, 2:3, 9:16, or a free W:H), Exact dimensions (Instagram Square 1080×1080, 1080p 1920×1080, Print 4×6 / 5×7 / 8×10, etc.), or Adjust each image (opens a visual editor for every image at run time so you can position the crop individually).
- 3. Resize — Scales the size while preserving aspect ratio. Pick Width, Height, Longest Edge, or Percentage. Resize never crops or stretches — it always preserves aspect. (Need exact W×H dimensions? Add a Crop node before Resize.)
- 4. Convert — Change the file format. Supports JPEG, PNG, WebP, AVIF, HEIC, GIF, TIFF, and PDF output. Transparent pixels going to JPEG are flattened to white (not black) so screenshots and logos come out looking right.
- 5. Compress — Shrink file size automatically using smart per-format compression (mozjpeg for JPEG, palette PNG, smart subsampling for WebP). No quality slider — IMG Flow picks the best setting per format.
- 6. Watermark — Overlay text or an image at any combination of nine anchor positions (corners, edges, center). Select multiple anchors for repeated placement, or pick "All 9 positions" for full coverage. Runs last so the overlay isn't scaled, cropped, re-encoded, or compressed.
5. Build your first pipeline
Drag a tool from the left sidebar onto the canvas. As soon as you drop your first tool, IMG Flow auto-creates a matching Destination node to the right. Double-click the tool to open its config panel, pick your settings, and click Save.
Need more steps? Drag another tool onto the canvas between the first tool and the destination (literally drop it on the line between them). IMG Flow will splice it in — the existing edges get rewired automatically, even if the source has fan-out to multiple destinations.
6. Destination nodes
Every pipeline needs at least one destination. Drag a destination from the bottom of the left sidebar onto the canvas and connect it to the last tool in your chain (or let Auto Build do it for you). Available destinations:
- Local Folder — Save to any folder on your Mac.
- Google Drive — Upload directly to a Drive folder. Sign in via OAuth the first time you configure one.
- Dropbox — Same idea: OAuth once, pick a folder.
- Send to App — Open the processed images in another macOS app (Photoshop, Lightroom, Preview, etc.).
- Webhook (Pro) — POST each image to any HTTP endpoint. Great for Zapier, n8n, Make, or custom APIs.
- FTP / SFTP (Pro) — Upload to any FTP or SFTP server.
- Email (Pro) — Send a branded download link to any recipient. The email contains no attachments — recipients download from a custom page that expires after 3 days.
7. Multi-destination fan-out
A single tool can feed into as many destinations as you want. Drag a second destination onto the canvas and connect the same tool's output to it. When you run the pipeline, the tool processes each image once and the result flows to every connected destination in parallel.
There's no limit on how many destinations you can fan out to. A single pipeline could send to a local folder, Dropbox, Google Drive, and three FTP servers simultaneously.
8. Mid-chain taps
You can also connect destinations to tools in the middle of the chain, not just the end. This "taps" the pipeline state at that point and saves a copy — useful when you want, say, the after-rotate-before-compress version AND the fully-processed version from the same run.
Drag a destination onto the canvas and drag its input handle to any tool's output. The tap captures the state of the image after that tool runs.
9. Auto Build
Built a messy pipeline with orphan nodes or weird wiring? Click the Auto Build button in the bottom-right of the canvas. IMG Flow will reorder your nodes into the optimal tool sequence (Rotate → Crop → Resize → Convert → Compress → Watermark), fix the layout, and connect everything to your destination(s).
The optimal sequence comes from quality + correctness rules: Rotate first because it's lossless; Crop before Resize so the shape change works on the larger source pixels; Convert before Compress so the compression settings match the target format; Watermark last so the overlay isn't scaled, re-encoded, or compressed.
10. Save a pipeline as a preset
Once you have a pipeline you like, click + Save Pipeline in the right sidebar. Give it a name and it's saved forever. The active pipeline auto-saves whenever you make changes, so you don't lose work.
To load a saved pipeline, click it in the right sidebar. To delete one, double-click its name to rename or click the × button. To run a completely different pipeline, click New in the top-right of the canvas.
Running Pipelines
11. Add images to the queue
There are six ways to get images into the queue:
- Drag and drop from Finder onto the queue bar at the bottom.
- Click the + button in the queue to browse files.
- Import Folder to add everything in a folder recursively.
- Paste from Clipboard (⌘V) — handy for screenshots you just took.
- Right-click → Open With → IMG Flow in Finder — Mac sends the selected files straight into the queue.
- Cloud import from Dropbox via the cloud browser popover.
12. Run a pipeline
With at least one image in the queue and a valid pipeline on the canvas, click the big Run Pipeline button in the right sidebar. Processing happens in parallel across CPU cores — a 100-image batch on a typical M-series Mac finishes in seconds.
You'll see a progress indicator fill across the canvas as each image completes. Nodes glow while processing and flash green when done. When the whole run finishes, a summary appears showing how many files were processed and where they went.
13. Understanding results
After a successful run, IMG Flow shows a banner with the total bytes saved (for compression pipelines), the number of files produced, and links to reveal the output folder in Finder. Any per-image errors are listed so you can fix and retry.
Lifetime stats — total images processed, total runs, total bytes saved — are tracked in the Stats modal (click the chart icon in the top-right corner of the window).
Your Account
14. Create an account
An IMG Flow account is optional but unlocks Inbox, Cloud Sync, and (after upgrade) the Pro destinations. Open Settings → Account and click Sign Up. Enter your email, a password, and pick a username — that username becomes your inbox address (e.g., chucknorris@imgflow.app) and your public upload page URL (e.g., upload.imgflow.app/chucknorris).
15. Cloud Sync
When you're signed in, Cloud Sync automatically keeps your saved pipelines, app settings (the safe, non-device-specific subset), and lifetime stats synced to your account. Sign in on another Mac and everything comes back. You can toggle Cloud Sync off entirely in Settings → Cloud Sync.
What syncs: pipelines, settings (theme, file-naming rules, sort preferences), processing stats. What does not sync: your local output folder, Dropbox/Google Drive OAuth tokens, FTP passwords, your image queue. Those stay on the device where you configured them.
16. Inbox — receive images by email
The Inbox lets other people send you images. Anyone can email your inbox address (e.g., chucknorris@imgflow.app) with image attachments, and the images land in the Inbox panel inside your desktop app. You review them, approve the sender, and import into your queue with one click.
First-time senders are held for manual review. Once you approve a sender, future emails from that address skip the review step and land directly in the Pending tab.
17. Your public upload page
You also get a branded upload page at upload.imgflow.app/chucknorris. Share the link with anyone — a client, a collaborator, a vendor — and they can drag-and-drop images into your inbox without needing an email client or an account of their own. The upload page shows your username and email address so the sender knows where the images are going.
18. Managing senders
Open Settings → Inbox → Approved Senders to see and manage everyone who's sent you images. You can mark senders as approved (future uploads auto-land), blocked (future uploads are discarded silently), or delete them entirely. Held senders — the ones waiting for review — appear in a separate tab in the Inbox panel.
Pro Features
19. Upgrading to Pro
The Pro upgrade is a one-time purchase that unlocks three additional destination types: Webhook, FTP/SFTP, and Email. Open Settings → Account → Upgrade to Pro and you'll be taken to a secure checkout. After payment, sign out and back in (or just quit and reopen the app) — your account tier updates and the Pro destinations unlock automatically.
The Pro upgrade is tied to your IMG Flow account, so it works on every Mac you sign in on. Pipeline building is never gated — even on the base app you can build as many nodes, fan-outs, and taps as you want. Pro only gates which destination types you can use.
20. Webhook destination
Drag a Webhook destination onto the canvas and double-click to configure. Paste the target URL. Optionally add custom HTTP headers as JSON (for Authorization, API keys, etc.).
When the pipeline runs, each processed image is POSTed to that URL as multipart/form-data with a field named file. Works out of the box with Zapier, n8n, Make, Integromat, or any custom API that accepts file uploads.
21. FTP / SFTP destination
Drag an FTP / SFTP destination onto the canvas and double-click to configure. Enter host, port, username, password, and the remote path where files should land. The Secure toggle enables FTPS/SFTP with TLS (recommended — leave it on unless your server specifically requires plain FTP).
Passwords are stored encrypted in the macOS Keychain and never sent to our servers.
22. Email delivery destination
The Email destination is the prettiest one. Drag it onto the canvas and double-click to configure. Enter a recipient email (or multiple, comma-separated), an optional subject and message, and a "from name" that will appear in the sender line.
When the pipeline runs, processed images are uploaded to our servers (temporarily — 3 day expiry) and one branded email per recipient is sent via Resend. The email contains NO attachments — just a big "View & Download" button linking to a custom download page where the recipient can pick which files to download. Links auto-expire after 3 days and the files are deleted.
This destination is the preferred way to deliver batches of images to clients: it bypasses the 40MB attachment limits that block most email providers, keeps the sender's sent folder tidy, and lets the recipient come back to the download page for up to 3 days.
Advanced
23. Keyboard shortcuts
- ⌘O — Browse for images
- ⌘V — Paste image from clipboard
- ⌘Enter — Run pipeline
- ⌘N — New pipeline (clears canvas)
- ⌘⌫ — Clear canvas
- ⌘L — Auto Build
- ⌘Z / ⌘⇧Z — Undo / Redo
26. Troubleshooting
A destination shows a Pro lock badge even though I purchased Pro. Sign out of Settings → Account and sign back in. Your local cached tier needs to refresh from the server.
A HEIC file won't process. IMG Flow uses macOS's sips utility to pre-convert HEIC/HEIF files. Make sure your macOS version supports the specific HEIC variant.
My Inbox isn't receiving emails. Check Settings → Inbox to confirm your inbox address is active. Check your sender's spam folder for auto-reply bounces. First-time senders are held for review — check the Held tab.
An Email destination batch never arrived. Check the recipient's spam folder — the branded link email comes from noreply@imgflow.app and may be flagged on the first send from a new sender/recipient pair. Add noreply@imgflow.app to the recipient's safe senders list for future reliability.
Still stuck? Email support@imgflow.app with a description of the issue and I'll help.