gitwtfhub

wtf is xsxb-frame-tuner?

sparklecatta-lang/xsxb-frame-tuner — explained in plain English

Analysis updated 2026-05-18

44JavaScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A local tool that lets an AI agent and a person together fine-tune frame by frame animations for Godot game characters and Codex pets.

Mindmap

mindmap
  root((XSXB Frame Tuner))
    What it does
      Tunes Godot animations
      Edits Codex pets
      Agent plus human workflow
    Tech stack
      JavaScript
      Node.js
      Godot
    Use cases
      Import PNG sequences
      Adjust collision boxes
      Sync to Godot project
      Attach sound effects
    Audience
      Godot developers
      Codex agent users
    Frame Tuner Lite
      No game binding
      Sprite sheet export
      CLI import tools

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Import a PNG animation sequence for a game character and fine-tune its collision boxes visually.

REASON 2

Convert a folder of sprite frames into a clean, transparent sprite sheet with Frame Tuner Lite.

REASON 3

Sync tuned animation timing and hit boxes back into a Godot game project.

REASON 4

Attach sound effects to specific animation frames and preview them in the browser.

What's in the stack?

JavaScriptNode.jsGodot

How it stacks up

sparklecatta-lang/xsxb-frame-tunerricar66/omnistack-agentyyx990803/qr.js
Stars444444
LanguageJavaScriptJavaScriptJavaScript
Last pushed2013-03-04
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity3/51/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Node.js and, for the full version, an existing Godot project to sync into.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

XSXB Frame Tuner is a local workbench for adjusting frame by frame animations for Godot game characters and for Codex pets. It ships with a matching Codex or Agent skill, so an AI agent handles importing, syncing, and checking the art files, while a person uses a web page to look at individual frames, drag the character around, and adjust hit boxes and hurt boxes by hand. Finished Godot animations get saved back into the game project, and custom Codex pets get saved back into their pet sprite sheets. The repo also includes a fully separate tool called Frame Tuner Lite. Lite is not tied to any specific game. Instead, it takes a folder of PNG image sequences, or a sprite sheet with a matching JSON file, and turns them into a consistent set of transparent, layered frame sequences and a new sprite sheet. The full version supports several features: keeping separate projects isolated from each other, collecting both built in and custom Codex pets, importing new pets from WebP images, batch importing several animation sets from one message, previewing frames with play and pause controls, adjusting scale, offset, and rotation at the character, animation group, and single frame level, editing collision boxes directly on the canvas, attaching sound effects or extra images to specific frames, and an attack trail mode that draws a continuous motion path across frames using adjustable sticks, colors, and textures. It also syncs the tuned data back into the matching Godot project folder. Both the full Tuner and Frame Tuner Lite run as local web apps started from included Windows batch files, and Lite has its own command line import tools for PNG sequences and sprite sheets. The project stores no character art, audio, or private Godot project data in the repository itself. Setup only requires Node.js, and the maintainers describe running included check and test scripts, plus a validation script for confirming a Godot project is wired up correctly. The tool also checks for and can apply updates from the official GitHub repository. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me install and enable the xsxb-frame-tuner skill from this repository for my Codex agent.
Prompt 2
Use xsxb-frame-tuner to import a PNG idle animation sequence at 12fps into my Godot project and open the tuner.
Prompt 3
Check whether my Godot project's XSXB runtime data still matches what is saved in the tuner.
Prompt 4
Explain how Frame Tuner Lite's transparent sequence export decides the shared canvas size for a character.

Frequently asked questions

wtf is xsxb-frame-tuner?

A local tool that lets an AI agent and a person together fine-tune frame by frame animations for Godot game characters and Codex pets.

What language is xsxb-frame-tuner written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Godot.

What license does xsxb-frame-tuner use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is xsxb-frame-tuner to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is xsxb-frame-tuner for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.