{ "markdown": "

\"GLYPHLOOP\"

\n\n# Glyphloop\n\nA browser studio and headless toolkit for creating **loop-perfect generative ASCII\nanimations**: flow fields, wave interference, morphing noise blobs, matrix\nrain, rotating 3D shapes, custom math expressions, and parametric surfaces.\nLayer effects over images, video, or text, inherit their colors, and export to\nPNG, GIF, MP4, self-contained web embeds, or terminal players.\n\nAlso usable **headless by AI agents** through the package CLI or MCP server -\nagents can even define their own animations and 3D shapes as expression\nstrings. See [AGENTS.md](AGENTS.md).\n\nGlyphloop = glyphs + seamless loops.\n\n[Try the hosted studio](https://glyphloop.art/studio/) with no account, or\n[see live examples](https://glyphloop.art/#sources).\n\n## Local Studio\n\n```sh\nnpm ci\nnpm run dev # opens on http://localhost:5199\n```\n\nNode.js 20 or newer is required. Chrome is recommended because MP4 export uses\nWebCodecs; the other workflows work in modern browsers.\n\n## CLI and MCP\n\nThe package exposes one `glyphloop` executable with two commands:\n\n```sh\nnpx glyphloop@beta render --preset flowfield-hero --out hero\nnpx glyphloop@beta mcp\n```\n\nFrom a source checkout, the equivalent development commands are:\n\n```sh\nnpm run render -- --preset flowfield-hero --out hero\nnpm run mcp\n```\n\n`render` accepts a built-in preset name, a preset JSON file, or inline JSON.\nRun `node bin/glyphloop.js --help` for the complete command summary.\n\n## Use\n\n1. Pick an effect source and tweak its parameters live - or **drag & drop\n any image/video onto the editor** to ASCII-fy your own design with its\n colors intact.\n2. Style it: character ramp (or type your own), gamma, invert, mono or\n two-color gradient.\n3. Set grid columns, cell size, aspect ratio, duration, and FPS. Imported media\n starts at its native aspect ratio, and raster exports can match its exact\n pixel dimensions.\n4. **Export**:\n - **PNG** - current frame, at 1–3× scale.\n - **GIF / MP4** - one animation pass, rendered deterministically\n frame-by-frame (never drops frames). Generated motion wraps seamlessly.\n - **Web embed (zip)** - `frames.json` (RLE-compressed character frames) +\n `player.js` (tiny dependency-free player, honors\n `prefers-reduced-motion`) + a demo `index.html`. Drop the two files into\n any site and add `
`.\n - **Terminal (zip)** - `frames.ans` + `play.sh`; run `bash play.sh` to loop\n the animation in a terminal.\n\nThe editor includes six starter presets. Presets can also be saved to\nlocalStorage or downloaded/loaded as JSON via the header bar. A shared preset\ncan be opened with `/studio/?preset=flowfield-hero`.\n\nImported media stays in the browser; Glyphloop does not upload it. For a stable\nbeta experience, images are limited to 25 MiB and 40 decoded megapixels, videos\nto 100 MiB and the first 20 seconds, and preset files to 10 MiB. Very large\nrender workloads are rejected with guidance to reduce scale, columns, FPS, or\nduration.\n\nThe hosted website and Studio send a small allowlisted set of anonymous product\nevents to a first-party Cloudflare endpoint. Creative inputs and outputs are\nnever included. Source checkouts, the CLI, and the MCP server send no analytics.\nSee the hosted [privacy notice](https://glyphloop.art/privacy.html).\n\n### Source color vs image palette\n\nThese are two different ways to color imported media:\n\n- **Color mode: source** samples the image or video at every grid cell, so each\n glyph keeps the local color beneath it. It preserves multicolor artwork and\n follows changing video colors frame by frame.\n- **Set ink & paper from image** extracts a small representative palette and\n fills the Ink, Ink 2, and Paper controls. Choose **mono** or **gradient** to\n render with those curated colors instead of retaining every source color.\n\nIn short: source mode preserves the image's color map; the palette action uses\nthe image as inspiration for a controlled Glyphloop color scheme. The Studio's\n**Undo image palette** action restores the exact ink and paper colors that were\nset before palette extraction.\n\n## Why generated loops are seamless\n\nGlyphloop's built-in sources and periodic expressions are pure functions of\ntime with no per-frame state. All noise is\nsampled along a circle in two extra noise dimensions\n(`src/core/noise.ts:loopCoords`), and all sine phases advance by integer\nmultiples of 2π per loop - so frame N wraps back to frame 0 exactly. Exports\nrender `round(fps × duration)` frames starting at t=0 and never render\nt=duration (frame 0 *is* the wrap).\n\nImported video is not made loop-perfect automatically. Glyphloop samples one\npass of the clip across the animation duration, then playback repeats from the\nstart. The composite is seamless only when the source video was already\ndesigned to loop, as in the Claude jellyfish example, or when the imported base\nis a still image.\n\n## Development\n\n```sh\nnpm test # vitest unit tests (noise periodicity, mapper, RLE, ZIP, ANSI, sources)\nnpm run build # typecheck + production build\nnpm run build:site # typecheck + production website and Studio build\n```\n\nArchitecture: `Source → FieldFrame (brightness grid) → AsciiMapper → CanvasRenderer → exporters`.\n\n## Licence, outputs, and brand\n\nGlyphloop's software, including the editor, renderer, CLI, MCP server,\nexporters, presets, and generated embed player, is available under the\n[MIT licence](LICENSE).\n\nGlyphloop claims no ownership in content you import or animations you export.\nYou may use exported animations commercially without attribution, subject to\nany rights applicable to your source materials.\n\nThe Glyphloop name and visual identity are not licensed under MIT. Demo and\nmarketing media are separately labelled. See [TRADEMARKS.md](TRADEMARKS.md) and\n[LICENSES/ASSETS.md](LICENSES/ASSETS.md).\n\nIssues and focused feedback are welcome during the beta. See\n[CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).\n", "bytes": 6037, "sha": "82c186de6425628250426a1e19efaa170d1cdfa993a2626dd77d48ee08dbc033", "repo_slug": "ideoshi/glyphloop", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_ideoshi_glyphloop_e9c2442c/readme" }