How systemchester/frameronin works
FrameRonin is a browser-based pixel-art and animation toolkit, with optional backend processing for video frame extraction and Seedance watermark removal. Users enter a tool from the home hub, process images or frame sequences locally, and export results; the video-job path uploads a video, queues server processing, and exposes status and downloads. The README documents additional RoninPro, AI-linked, and experimental tools represented here by their existing component paths. Backend wiring is based on the sampled API, storage, and task code; unsampled feature internals are not expanded.
Main entry points: App.tsx Tool hub · main.py Backend API · tasks.py RQ task dispatch · ParamsStep.tsx Video workflow
Components 25
App and access
- Tool hub
frontend/src/App.tsx - Mode selector
frontend/src/components/ModeSelector.tsx
Image and frames
- GIF and frames
frontend/src/components/GifFrameConverter.tsx - Sprite sheet
frontend/src/components/SpriteSheetTool.tsx - Sheet adjustment
frontend/src/components/SpriteSheetAdjust.tsx - Pixel image tools
frontend/src/components/ImagePixelate.tsx - Chroma / AI matte
frontend/src/components/ImageMatte.tsx - Image resize and crop
frontend/src/components/ImageResizeStroke.tsx - Pixel processing
frontend/src/lib/pixellise/pipeline.ts - Gemini watermark tool
frontend/src/components/ImageGeminiWatermark.tsx
Creative tools
- RoninPro suite
frontend/src/components/RoninPro.tsx - Custom workflows
frontend/src/components/RoninProCustomWorkflow.tsx - Rseprite editor
frontend/src/components/Rseprite/useRsepriteState.ts - Nanobanana tools
frontend/src/components/NanobananaFullChar.tsx
Backend jobs
- Video workflow
frontend/src/components/ParamsStep.tsx - Backend API
backend/app/main.py - Job files
backend/app/storage.py - RQ task dispatch
worker/tasks.py - Video processing
worker/processor.py - Video watermark removal
worker/watermark_remover.py
State and integrations
- Ronin auth
frontend/src/auth/context.tsx - Image stash
frontend/src/stash/context.tsx
Other components
- User
- Ronin chain RPC
- Redis
Connections 27
- User → Tool hub: selects tool
- Tool hub → Mode selector: offers modes
- Tool hub → GIF and frames: opens
- Tool hub → Sprite sheet: opens
- Tool hub → Sheet adjustment: opens
- Tool hub → Pixel image tools: opens
- Tool hub → Chroma / AI matte: opens
- Tool hub → Image resize and crop: opens
- Tool hub → Video workflow: opens
- Tool hub → RoninPro suite: opens
- Tool hub → Custom workflows: opens
- Tool hub → Rseprite editor: opens
- Tool hub → Nanobanana tools: opens
- Tool hub → Gemini watermark tool: opens
- Pixel image tools → Pixel processing: processes pixels
- User → Video workflow: uploads video
- Video workflow → Backend API: submits job
- Backend API → Job files: saves upload
- Backend API → RQ task dispatch: enqueues task
- RQ task dispatch → Redis: stores job
- RQ task dispatch → Video processing: dispatches video job
- RQ task dispatch → Video watermark removal: dispatches watermark job
- Video processing → Job files: writes results
- Backend API → Job files: reads results
- Backend API → Video workflow: returns status and files
- Ronin auth → Ronin chain RPC: checks NFT ownership
- Tool hub → Image stash: shows stash panel