iblipper

name	iblipper
description	Generate kinetic typography animations for expressive agent-to-human communication. Use when you want to communicate with visual flair - animated text for announcements, alerts, greetings, dramatic reveals, or any message that deserves more than plain text. Outputs shareable URLs or can display in canvas.

iBlipper - Motion Type Synthesizer

Generate animated kinetic typography to communicate with humans in a more expressive, attention-grabbing way.

Base URL: https://andyed.github.io/iblipper2025/

Three Output Options

Option 1: PWA Protocol (fastest, if installed)

If iBlipper PWA is installed, use protocol handler.

Option 2: Local GIF File (owned, robust)

Generate a real GIF file locally using the render_gif_file tool.

• Tool: render_gif_file
• Args: message, output_path
• Result: A file path to the generated GIF.

Option 3: Hyperlink (universal, always works)

Generate a clickable link.

open "web+iblipper:MESSAGE+TEXT"

Benefits:

• Opens instantly (cached PWA, no page load)
• Standalone window (not a browser tab)
• Feels like "agent spoke" vs "agent sent link"

Requires: PWA must be installed first (visit https://andyed.github.io/iblipper2025/ and click install prompt)

Fallback: If not installed, use Option 2 (hyperlink)

Option 3: Hyperlink (universal, always works)

Generate a clickable link - recipient sees the animation in their browser.

[PLAY MESSAGE TEXT](https://andyed.github.io/iblipper2025/#text=MESSAGE+TEXT&emotion=emphatic&dark=true&share=yes)

Option 4: GIF Download (requires browser tool)

Generate an animated GIF file that can be attached to messages.

https://andyed.github.io/iblipper2025/?export=gif#text=MESSAGE+TEXT&emotion=emphatic&dark=true

URL Parameters

All parameters go in the hash fragment (#param=value&param2=value2).

Parameter	Type	Description	Default
text	string	The message to display (URL encoded, spaces as +)	-
wpm	number	Words per minute (30-2500)	300
density	number	Words per frame (0.1-500)	1
fill	boolean	Auto-scale text to fill screen	true
theme	number	Color theme index (0-3)	0
dark	boolean	Dark mode	true
emotion	string	Animation style preset (see below)	neutral
share	string	Auto-play on load (yes)	-
aspect	string	Aspect ratio (e.g., 16:9, 4:3, 1:1)	16:9
width	number	Output width in pixels	480
height	number	Output height in pixels	Auto-calculated from aspect
forceAspect	boolean	Force exact aspect; add padding if needed	false

Aspect Ratio Rules

1. If aspect is provided, height is calculated from width and the ratio.
2. If both width and height are provided, they override aspect.
3. If none are provided, defaults are 16:9 and 480px width.

Recommended Aspect Ratios for Platforms

Twitter/X:

• Supported Range: 1:1 (Square) to 3:1 (Wide)
• Recommended: 1:1 or 16:9 for best feed display
• File Size Limits:
  • Web: 15MB max
  • Mobile: 5MB max
• Example: aspect=1:1 for square posts, aspect=16:9 for landscape

General Social Media:

• Instagram: 1:1 (Square) or 4:5 (Portrait)
• TikTok/Reels: 9:16 (Vertical)
• YouTube: 16:9 (Landscape)

Emotion Presets (Production)

Emotion	Vibe	Best For
neutral	Clean, professional	Default, announcements
hurry	Fast, urgent, italic	Time-sensitive alerts
idyllic	Slow, dreamy, airy	Poetic, calm messages
question	Curious, tilting	Questions, pondering
response_required	Urgent, pulsing	Action needed
excited	Bouncy, energetic	Celebrations, enthusiasm
playful	Fun, bouncing	Jokes, casual fun
emphatic	Bold, solid, impactful	Important statements
casual	Handwritten, relaxed	Friendly chat
electric	Glitchy, RGB split	Cyber aesthetic
wobbly	Jelly physics	Silly, playful

Note: matrix emotion is pre-release - avoid for now.

Hyperlink Examples

Important announcement:

[PLAY BREAKING NEWS](https://andyed.github.io/iblipper2025/#text=BREAKING+NEWS&emotion=emphatic&dark=true&share=yes)

Friendly greeting:

[PLAY Hey there!](https://andyed.github.io/iblipper2025/#text=Hey+there!&emotion=casual&dark=false&share=yes)

Celebration:

[PLAY Congratulations!](https://andyed.github.io/iblipper2025/#text=Congratulations!&emotion=excited&share=yes)

Aspect ratio example (1:1):

[PLAY Square](https://andyed.github.io/iblipper2025/#text=Square&emotion=emphatic&aspect=1:1&share=yes)

GIF Export Workflow (Browser Required)

1. Open the export URL in browser:

   browser action=open targetUrl="https://andyed.github.io/iblipper2025/?export=gif#text=Hello&emotion=emphatic&aspect=16:9"
   

2. Wait ~15-20 seconds for render + encode

3. Find the downloaded GIF:

   ls -t ~/Downloads/iblipper_*.gif | head -1
   

4. Read/attach the file to your message

Export query parameters:

Parameter	Type	Description	Default
export	string	Format: gif, apng, png	-
width	number	Output width in pixels	480
height	number	Output height in pixels	Auto-calculated from aspect
fps	number	Frames per second (8, 15, 30)	15
aspect	string	Aspect ratio (e.g., 16:9, 4:3, 1:1)	16:9
forceAspect	boolean	Force exact aspect; add padding if needed	false

When to Use

Good for:

• Greetings and introductions
• Important announcements
• Celebrating milestones
• Dramatic reveals
• Adding personality to messages

Skip for:

• Long-form content (keep to 1-10 words)
• Urgent safety alerts (plain text is faster)

CLI Script

For quick URL generation, use the included shell script:

# Basic usage
src/iblipper/scripts/iblipper.sh "Hello World"
# https://andyed.github.io/iblipper2025/#text=Hello+World&emotion=emphatic&dark=true&share=yes

# PWA Protocol (if installed)
src/iblipper/scripts/iblipper.sh --pwa "Hello World"
# open "web+iblipper:Hello+World"

# With emotion
src/iblipper/scripts/iblipper.sh "Breaking News" hurry

# Light mode
src/iblipper/scripts/iblipper.sh "Good Morning" idyllic light

# As markdown link
src/iblipper/scripts/iblipper.sh -m "Click me!" excited
# [PLAY Click me!](https://...)

# GIF export URL
src/iblipper/scripts/iblipper.sh --gif "Export this" playful

# Aspect ratio
src/iblipper/scripts/iblipper.sh --aspect 1:1 "Square" emphatic

Smart PWA Detection (Recommended)

To provide the best experience, check if the PWA is installed on the user's system before generating a link.

1. Check for installation (macOS):

open -Ra "iBlipper"

2. React to the result:

• If exit code is 0 (Installed): Use the PWA protocol for an instant, native-feeling window.

  src/iblipper/scripts/iblipper.sh --pwa "Your Message"
  # Output: open "web+iblipper:Your+Message"
  

• If exit code is 1 (Not Installed): Use the standard hyperlink, but add a tip to install the PWA.

  src/iblipper/scripts/iblipper.sh -m "Your Message"
  

  Add to response: "Tip: Install the iBlipper PWA from the website for a better, popup-free experience."

Additional Resources

• references/examples.md - Real-world use cases by category
• references/emotions.md - Deep dive on each emotion preset with live demos

Tips

• Try PWA protocol first - if installed, fastest and most native-feeling
• Fallback to hyperlinks - universal compatibility, always works
• Keep text concise - 1-5 words have the most impact
• Use share=yes in hyperlinks - skips landing page
• Match emotion to message - excited for celebrations, emphatic for important stuff
• Dark mode looks better - dark=true is usually the way to go
• Use sparingly - if every message is animated, none are special
• Always use markdown links - [text](url) not raw URLs. Clean presentation matters.

Decision Flow

1. Check installation: `open -Ra "iBlipper"`
   
2. Result?
   - FOUND (0): Use PWA protocol -> `web+iblipper:Message`
   - NOT FOUND (1): Use Hyperlink -> `https://...` + "Install PWA" tip

3. Need inline image?
   - Yes: Use GIF export (Signal/iMessage/etc)
   - No: See step 2