3dicon README

The project's README from github.com/samyost1/3dicon. As one markdown file: README.md.

/3dicon

One prompt in, a looping animated 3D icon out (with real transparency) an animated WebP you can drop straight into your app UI.

eight icons looping around the /3dicon wordmark

Install

/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

One OpenRouter key covers the whole pipeline — the image model and the video model both run through it.

cd ~/.claude/skills/3dicon
pip install -r requirements.txt
cp .env.example .env

Put your key in .env:

OPENROUTER_API_KEY=sk-or-...

Get one at openrouter.ai/keys.

ffmpeg must be on PATH. The first run downloads a ~180MB matting model.

Use

Ask for it in plain words:

make an animated 3d fire icon using /3dicon

It generates one still, shows it, and waits for you to approve it before spending anything on motion. Then it proposes the motion and waits again.

How it works

flowchart LR
    P["your prompt"] --> S["still image<br/><sub>GPT Image</sub>"]
    S --> F["first frame"]
    S --> L["last frame"]
    F --> V["video model<br/><sub>Seedance</sub>"]
    L --> V
    V --> M["remove background<br/><sub>every frame</sub>"]
    M --> E["animated .webp<br/><sub>real alpha</sub>"]

The trick is in the middle: the same still is sent as both the first and the last frame, so the model returns to where it began and the loop closes with no visible seam.

The background is removed against a colour we chose ourselves, which means the original colours can be solved for exactly rather than guessed — that is what keeps soft edges soft instead of leaving a halo.

Licence

MIT. Icons you generate with it are yours, with no restrictions.

3dicon (samyost1/3dicon)

Searching Database…

562 ·GitHub
3dicon
What is this?A Claude Code skill: one plain-language prompt in, one looping animated 3D icon out — an animated WebP with real transparency you can drop straight into an app UI.
Is this a standalone app, or does it live inside Claude Code?It's a skill for Claude Code, not a separate app — you ask for an icon in plain words, like 'make an animated 3d fire icon using /3dicon', and it runs the whole pipeline for you.
How do I get it set up?Get an OpenRouter key (one key covers the whole pipeline), put it in .env, and make sure ffmpeg is on PATH — then just ask Claude for an icon.
Anything I should know before the first run?ffmpeg must be on PATH, and the first run downloads a roughly 180MB matting model. Generation runs on OpenRouter's models, so this is not a fully local tool.
Can I use the icons I generate in my own projects?Yes — the code is MIT licensed, and the README says icons you generate with it are yours, with no restrictions.
Does it need a powerful GPU, or can I run it on a laptop?Ordinary hardware is fine: the image and video models are called through OpenRouter, so locally you only need ffmpeg plus a ~180MB matting model download on the first run.
Is it free to actually generate an icon?The skill itself is MIT and free, but the image and video steps run through OpenRouter's paid models — which is why it asks for your approval before spending anything on motion.
What are similar projects?sprite-gen, artcraft, storycast, onetake, CodeVideoModel, procedural-film, godogen, scroll-world
Which topics is it in?background-removal, icon-pack, image-to-video, icons, claude-skill, openrouter, text-to-image, claude-code-skill, agent-skill, ffmpeg, video-generation, 3d
Creator
samyost1
Size
7.6 MB
Stars
562
Updated
CommitSep 23
Age
25d
Commits · 90 Days