JON HANLAN
Jon Hanlan
work
tools
about
Jon Hanlan
Open for commissions
Instagram
GIPHY
Bluesky
YouTube
TikTok
Installation & SetupQuick StartConnecting PlatformsExport FormatsFormat OptionsUpload WorkflowBatch ModePresetsBrowse & ImportQuality & Size ControlUpload HistorySettings ReferenceKeyboard ShortcutsTroubleshootingSupport

Wormhole User Guide

User Guide

Render. Upload. Share. From After Effects.

v1.0

Installation & Setup

Requirements

  • After Effects 2020 or later
  • macOS 10.14+ or Windows 10+
  • Internet connection for uploads
  • Account on at least one supported platform (GIPHY, Imgur, Discord, Bluesky, X/Twitter, or YouTube)

Installation

  • AOpen the aescripts + aeplugins Manager
  • BSearch for "Wormhole"
  • CClick Install
  • DRestart After Effects

  • Opening Wormhole

  • AOpen After Effects
  • BGo to Window > Extensions > Wormhole
  • CDock the panel anywhere in your workspace or keep it floating
  • Tip

    Wormhole remembers its position between sessions. Dock it next to your timeline for fastest access.

    Quick Start

    Get your first upload done in under 60 seconds.

  • AOpen Wormhole from Window > Extensions > Wormhole
  • BGo to Settings and connect at least one platform. Paste an API key, add a webhook URL, or sign in with OAuth — whatever the platform needs. Click Test to verify.
  • CSwitch to the Upload tab. Open any composition in your project.
  • DWormhole auto-detects your comp and shows its name, dimensions, and duration.
  • EClick Upload. Wormhole renders, encodes, uploads, and gives you shareable links for every platform you selected.
  • First time only

    You only need to connect platforms once. Credentials are saved and encrypted locally.

    Connecting Platforms

    Wormhole supports six platforms. Each has its own connection method — here's how to set up each one.

  • AGo to developers.giphy.com and create an account
  • BClick Create an App and choose API
  • CGive your app a name (e.g., "My Uploads") and description
  • DCopy the API Key from your app dashboard
  • EPaste it into Wormhole's Settings under GIPHY
  • FClick Test to verify the connection
  • Tip

    GIPHY's free tier allows uploads. You don't need a paid account. You can also enter your GIPHY username to browse your own uploads in the Browse tab.

    Export Formats

    Wormhole supports four export formats. Choose based on your needs.

    GIF

    Best for short loops, reactions, and stickers. Widely supported everywhere. Larger file sizes. Max recommended: 15 seconds.

    MP4

    Best for longer animations and higher quality. Smaller files than GIF. H.264 encoding via AE's native output.

    WebP

    Smallest file size with good quality. Great for web embedding and documentation. Adjustable quality slider (10–100%).

    WebM

    Best for web video with transparency support. Smaller than MP4. Ideal for Discord and web embedding.


    Scale & Output Size

    1× (Full)

    No resizing. Uses your comp's native resolution. Can create large files — check platform limits.

    0.5× (Half)

    Halves the output dimensions. Good balance of quality and file size for most uploads.

    0.25× (Quarter)

    Quarter resolution. Smallest files. Best for quick previews or platforms with tight size limits.

    Max Width

    You can also set a maximum output width (120–1920px) in Settings. This is off by default. When enabled, comps wider than the limit are scaled down proportionally.

    Format Options

    Each format has additional options accessible from a collapsible disclosure below the format selector.

    Transparency

    Toggle alpha channel on or off. When off, transparent areas are filled with the matte color.

    Matte Color

    Background color for semi-transparent edges. Choose Black, White, or Green.

    Loop Control

    How the animation loops: Infinite (default), Once, or 3 times.

    FPS Override

    Override the frame rate manually, or leave on Auto to match the comp's native frame rate.

    WebP Quality

    Quality slider from 10% to 100%. Only visible when WebP format is selected.

    GIF Dithering

    Dithering method for GIF encoding. Floyd-Steinberg (smooth gradients), None (flat colors), Ordered (retro pattern).

    Upload Workflow

    Source

    Wormhole can use your active composition or a file from disk.

    • Active Composition — Wormhole auto-detects the open comp and shows its name, dimensions, duration, and frame rate. This is the default.
    • Browse for File — Pick any GIF, MP4, WebP, MOV, AVI, PNG, or JPG from your computer to upload directly without rendering.

    The Upload Tab

    The Upload tab is your main workspace. Everything you need is in one scrollable view.

  • AComp Info — Shows the active composition's name, dimensions, duration, and frame rate. Updates automatically when you switch comps.
  • BFormat & Scale — Choose GIF, MP4, WebP, or WebM. Pick a scale (1×, 0.5×, 0.25×). Expand Format Options for transparency, matte, loop, FPS, and quality controls.
  • CPlatforms — Toggle which platforms to upload to. Only connected platforms (with valid credentials) can be enabled. You can send different formats to different platforms.
  • DSave to Disk — Optionally save to a folder on your computer. You can export multiple formats simultaneously (e.g., GIF + MP4 + WebP in one go).
  • EDetails — Title auto-fills from your comp name. Add tags, captions, and descriptions as needed. Fields shown depend on which platforms are selected.
  • FPreview — An 8-frame preview canvas shows a low-res preview of your output before you commit.
  • GSize Estimate — Shows estimated file size and output dimensions before you upload.
  • HUpload Button — Shows how many platforms are selected. Disabled if no comp is open or no platforms are enabled.

  • During Upload

    Upload has two phases:

    • Rendering — Wormhole renders your comp through After Effects' render queue and encodes to your chosen format
    • Uploading — The encoded file is uploaded to each selected platform sequentially

    A progress bar shows the current phase and percentage. You can cancel at any time.


    After Upload

    On success, you'll see:

    • Shareable links for each platform, with copy-to-clipboard buttons
    • File info — path and file size if saved to disk
    • Reveal in Finder — jump straight to the exported file
    • Start Another — go back to the upload form to send another
    Quick copy

    Use Cmd/Ctrl + Shift + C to copy the link from your most recent upload without switching tabs.

    Batch Mode

    Batch Mode lets you process multiple compositions in one go instead of uploading one at a time.

    Off

    Default. Uploads only the active composition.

    All Comps

    Processes every composition in the current AE project.

    Selected Comps

    Processes only the compositions you've selected in the Project panel.

    Configure your format, scale, platforms, and metadata once. Wormhole works through each comp sequentially, uploading or saving each one with the same settings.

    Tip

    Combine Batch Mode with Save to Disk to export an entire project's worth of comps to GIF, MP4, or WebP in one shot.

    Presets

    Save your current configuration as a named preset and load it before any upload.

    What's Saved

    • Format (GIF, MP4, WebP, WebM)
    • Scale (1×, 0.5×, 0.25×)
    • Platform toggles (which platforms are enabled)
    • Batch mode setting
    • Metadata defaults (tags, descriptions, etc.)

    Using Presets

  • AConfigure your upload settings the way you want them
  • BClick Save Preset and give it a name (e.g., "Client Delivery" or "Social GIF")
  • CNext time, select the preset from the dropdown to load all those settings at once
  • DDelete presets you no longer need from the same dropdown
  • Browse & Import

    The Browse tab lets you search the GIPHY library and import GIFs directly into your After Effects project.

  • ASwitch to the Browse tab
  • BType a search term to find GIFs, or switch to Your GIFs to see uploads from your GIPHY account
  • CToggle between GIFs and Stickers to filter results
  • DClick a GIF to import it into your AE project panel as footage
  • EShift+Click a GIF to add it directly to your active comp as a new layer
  • Requires GIPHY

    The Browse tab requires a GIPHY API key to be configured in Settings. Your GIFs view also requires your GIPHY username.

    Quality & Size Control

    Wormhole gives you control over output quality and file size.

    Scale

    Choose 1× (full resolution), 0.5× (half), or 0.25× (quarter). Lower scale = smaller files.

    Max Width

    Optional maximum output width in pixels. Off by default. When enabled, range is 120–1920px. Comps wider than this are scaled down proportionally.

    Max Duration

    Maximum duration in seconds. Longer comps are trimmed to this limit. Default: 15 seconds. Range: 1–60s.

    GIF Dithering

    Dithering method for GIF encoding. Floyd-Steinberg (smooth gradients), None (flat colors), Ordered (retro pattern).

    File size warning

    If Wormhole estimates your file will be over 100MB, it will warn you before uploading. Consider using MP4 format, lowering the scale, or enabling Max Width.

    Upload History

    The History tab logs every upload with timestamps, formats, and platform results.

    • Copy Link — Copy the shareable link from any past upload
    • Platform Badges — Green for successful, red for failed uploads
    • Search — Filter history by comp name
    • Clear — Remove all history (cannot be undone)

    History is stored locally and persists across After Effects sessions. Up to 100 entries are kept.

    Settings Reference

    Platform Credentials

    Enter your credentials for each platform. All credentials are encrypted locally and never sent anywhere except directly to the platform.

    GIPHY

    API Key from developers.giphy.com. Free tier supports uploads. Optional: GIPHY username for Browse tab.

    Imgur

    Client ID from api.imgur.com. Register for anonymous usage.

    Discord

    Webhook URL from your server's channel settings.

    Bluesky

    Your handle (e.g., name.bsky.social) and an app password from bsky.app/settings.

    X / Twitter

    Four credentials: API Key, API Key Secret, Access Token, Access Token Secret from developer.twitter.com.

    YouTube Shorts

    Google OAuth sign-in via device flow. Click Sign In and enter the code at google.com/device.

    Default Settings

    Default Format

    Pre-selected format when opening the Upload tab. GIF, MP4, WebP, or WebM.

    Default Scale

    Pre-selected scale. 1× (Full), 0.5× (Half), or 0.25× (Quarter).

    Auto-fill Title

    Automatically fills the upload title from the active comp name. On by default.

    Render Settings

    Max Width

    Optional maximum output width. Off by default. Range: 120–1920px.

    Max Duration

    Maximum duration in seconds. Default: 15s. Range: 1–60s.

    GIF Dithering

    Floyd-Steinberg (smooth gradients), None (flat colors), Ordered (retro pattern).

    Keyboard Shortcuts

    Cmd/Ctrl+UUpload to platforms
    Cmd/Ctrl+EUpload to platforms (alternate)
    Cmd/Ctrl+1Upload tab
    Cmd/Ctrl+2History tab
    Cmd/Ctrl+3Browse / Settings
    Cmd/Ctrl+Shift+CCopy last upload link
    EscCancel current upload

    Troubleshooting

    Support

    Need help? Reach out at hello@jonhanlan.me — I reply to every message.

    Email Support

    hello@jonhanlan.me

    Website

    jonhanlan.me/tools/wormhole

    Account

    account.jonhanlan.me