A native macOS Mail extension to search and insert GIFs from Giphy directly into your emails.

Gif Mail adds a Giphy search panel to Apple Mail's compose window. Search for any GIF, then drag and drop it directly into your email — no copy-pasting URLs or downloading files.

• Search the entire Giphy library from within Mail's compose window
• Trending GIFs load automatically when the panel opens
• Preview GIF results in a scrollable 3-column grid
• Drag and drop GIFs directly into your email
• Double-click a GIF to insert it instantly
• Debounced search to keep things responsive
• Sandboxed and privacy-respecting — only makes network requests to the Giphy API

• macOS 14.0 (Sonoma) or later

1. Go to the Releases page.
2. Download the latest .dmg file.
3. Open the DMG and drag Gif Mail into your Applications folder.
4. Launch Gif Mail once to register the extension.
5. Open System Settings → General → Login Items & Extensions → Mail Extensions.
6. Enable Gif Mail Extension.

Note: Since this app is not from the App Store, you may need to right-click the app and select Open on the first launch. If that doesn't work, go to System Settings > Privacy & Security > Open Anyway.

1. Open Apple Mail and compose a new message.
2. Click the Giphy icon in the compose toolbar.
3. Browse trending GIFs, or type a search query.
4. Drag a GIF into the email body, or double-click to insert.

1. Clone the repository:

   git clone https://github.com/marctuinier/GiphyMailExtension.git

2. Open GIFMailSix.xcodeproj in Xcode.
3. Build and run (Cmd + R).

GIFMailSix/                     # Host application (SwiftUI)
├── GIFMailSixApp.swift
└── ContentView.swift

GIFMailSixExtension/            # Mail extension (AppKit + MailKit)
├── MailExtension.swift         # MEExtension entry point
├── ComposeSessionHandler.swift # MEComposeSessionHandler
├── ComposeSessionViewController.swift  # Programmatic UI layout
├── APIClient.swift             # Giphy API client (search + trending)
├── YourGifCollectionViewItem.swift     # GIF cell with drag & double-click
└── Info.plist

This project is licensed under the MIT License.