explaingit

choudhry18/convert-airdrop-photos

1Audience · generalComplexity · 1/5ActiveSetup · easy

TLDR

Written macOS guide that wires Automator, Folder Actions, and sips into a workflow that auto-creates a JPG copy whenever a HEIC photo lands in the Downloads folder.

Mindmap

mindmap
  root((Convert-Airdrop-Photos))
    Inputs
      AirDrop HEIC files
      Downloads folder events
    Outputs
      JPG copies
      Original HEIC kept
    Use Cases
      Auto convert AirDrop photos
      Share photos on Windows
      Avoid third party apps
    Tech Stack
      macOS
      Automator
      Folder Actions
      sips
      zsh

Things people build with this

USE CASE 1

Auto-convert AirDropped HEIC photos to JPG on a Mac

USE CASE 2

Share iPhone photos with Windows or Android users without manual conversion

USE CASE 3

Learn how Folder Actions and Automator can watch a folder

USE CASE 4

Use built-in macOS tools instead of installing a third party app

Tech stack

macOSAutomatorsipszsh

Getting it running

Difficulty · easy Time to first run · 30min

Folder Actions sometimes have to be turned on from Finder before the workflow will fire.

In plain English

This repository is not really a software project. It is a short written guide for Mac users that explains how to set up an automation so that AirDropped photos in the HEIC format automatically get a JPG copy made next to them. HEIC is the picture format iPhones use by default, and it can be awkward to open or share on non-Apple systems, while JPG works almost everywhere. The guide does not install any third-party app. It uses only tools that already come with macOS: Automator, which is Apple's built-in workflow builder; a feature called Folder Actions, which runs a workflow whenever a file appears in a specific folder; and a small command-line tool called sips that ships with macOS and can convert images. AirDrop saves received files to the Downloads folder, so the whole setup is wired to watch Downloads. The walkthrough takes you step by step through Automator. You start a new Folder Action, point it at the Downloads folder, drag in a Run Shell Script step, and paste in a short zsh script. The script looks at each new file, checks whether the extension is heic or heif, and if it is, it calls sips to write out a JPG copy in the same folder. If a JPG with the same name already exists, the script uses a different name so nothing gets overwritten. The original HEIC file is left alone. There is a short section on enabling Folder Actions, which sometimes have to be switched on from Finder by right-clicking the folder and going through the Folder Actions Setup menu. The guide also covers how to test the workflow by AirDropping a file and checking that both the HEIC and the new JPG show up. A short troubleshooting list at the end covers the common reasons it might not work, such as the file not actually being in Downloads, the wrong extension, the Automator step not being set to pass input as arguments, or Folder Actions being turned off. There is no license file mentioned in the README.

Copy-paste prompts

Prompt 1
Walk me through creating the Folder Action in Automator step by step on macOS 15
Prompt 2
Adapt the zsh script so it also converts heif files into PNG instead of JPG
Prompt 3
Help me debug why my Folder Action does not fire when I AirDrop a photo
Prompt 4
Extend the workflow so it moves the original HEIC into a subfolder after conversion
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.