Official plugin repository for Lunacy - the fast and powerful graphic design software
Build powerful extensions for Lunacy using any programming language. Automate workflows, add AI features, integrate external tools, and customize your design experience.
Lunacy plugins are external programs that interact with Lunacy via HTTP Automation API. They can:
- Modify layers and properties
- Add AI-powered design automation
- Export to custom formats
- Sync with external services
- Build custom tools and utilities
- Monitor design events in real-time
- Open Lunacy
- Go to AI → Model Context Protocol → MCP server enabled
- Enable the checkbox
Download any plugin from this repository and place it in:
- Linux:
~/.local/share/Icons8/Lunacy/Plugins/ - Windows:
%APPDATA%\Icons8\Lunacy\Plugins\ - macOS:
~/Library/Application Support/Icons8/Lunacy/Plugins/
Try the Hello World example:
cd ~/.local/share/Icons8/Lunacy/Plugins/hello-world-python
python3 hello.pySee the Quick Start Guide for detailed instructions.
- Quick Start Guide - Your first plugin in 5 minutes
- Quick Start UI Guide - Complete UI plugin tutorial
- Development Guide - Complete API reference
- API Reference - All endpoints and data types
- Plugin UI Guide - Building interactive interfaces
- Best Practices - Patterns and recommendations
- Troubleshooting - Common issues and solutions
AI-powered Auto Layout configuration. Analyzes your design visually and sets up responsive layouts automatically.
Features:
- Vision-based design analysis
- Smart grouping and spacing
- Semantic layer naming
- Works with Anthropic or OpenAI
Convert raster images to scalable vector graphics with interactive UI and smart presets.
Features:
- Interactive parameter tuning
- Photo, Poster, B&W presets
- Background service mode
- Auto-downloads VTracer tool
Start with basic examples to learn plugin development:
- Hello World (Node.js) - Simple JavaScript plugin
- Hello World (Python) - Simple Python plugin
- Hello World (C#) - Simple C# plugin with dev/prod workflows
For production-ready examples, see Featured Plugins.
- Utility Mode - Run on-demand when user triggers commands
- Service Mode - Continuous background operation from Lunacy startup
Write plugins in any language:
- Node.js - Fast prototyping, rich ecosystem
- Python - AI/ML libraries, data processing
- C#/.NET - High performance, native feel
- Go - Concurrency, system tools
- PowerShell - Windows automation
- Layer operations (create, update, delete, duplicate)
- Selection management
- Multi-format export (PNG, SVG, PDF, JPG, WEBP, TIFF, ICO)
- Screenshots and viewport access
- Undo/redo support
- Toast notifications
- Interactive UI system
- Real-time WebSocket events
Looking for more? Check out community-created plugins.
Want to submit your plugin? See CONTRIBUTING.md.
- AI & Automation - Auto-layout, content generation, smart naming
- Export & Conversion - Custom formats, batch processing
- Integration - Design systems, version control, CMS sync
- Utilities - Color tools, measurement, cleanup
- Analytics - Usage tracking, design metrics
- Background Services - Auto-save, real-time collaboration
Lunacy plugins communicate via HTTP REST API on localhost:31415:
// Get current selection
const response = await fetch('http://localhost:31415/getselected');
const selection = await response.json();
// Show notification
await fetch('http://localhost:31415/showtoast', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
text: 'Plugin completed!',
iconType: 1 // Success
})
});~/.local/share/Icons8/Lunacy/Plugins/your-plugin-name/%APPDATA%\Icons8\Lunacy\Plugins\your-plugin-name\~/Library/Application Support/Icons8/Lunacy/Plugins/your-plugin-name/This repository is licensed under MIT License. See LICENSE for details.
Individual plugins may have different licenses - check each plugin's LICENSE file.
We welcome contributions! See CONTRIBUTING.md for guidelines.
Made by the Lunacy Team