Infinite
Infinite is a free, open-source node-based audiovisual workstation by Naman Soni (n1m21n): real-time GPU compositing, 3D, modular synths, VST3/AU hosting.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/n1m21n/Infinite with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/n1m21n/Infinite'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/n1m21n--infinite)HTML
<a href="/listings/n1m21n--infinite"><img src="/api/listings/n1m21n--infinite/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Pre-built app (macOS, Windows and Linux)
Download the latest build from [GitHub Releases](https://github.com/n1m21n/Infinite/releases): `Infinite.dmg` for macOS, `Infinite-windows-x64.zip` / `Infinite-windows-ARM64.zip` for Windows, or `Infinite-x86_64.AppImage` for Linux.
**macOS** (Infinite is not notarised by Apple, so the first launch needs one extra step)
With Homebrew: `brew install --cask n1m21n/tap/infinite` (the first-launch step below still applies).
1. Open the DMG and drag `Infinite.app` to Applications. 2. Double-click `Fix & Open Infinite.command` in the DMG and press `y`. It clears the download flag on Infinite only, then opens it. - Or by hand: try to open Infinite once, then **System Settings > Privacy & Security > Open Anyway** (macOS 15 and later), or right-click `Infinite.app` > **Open** (older macOS). - Or in Terminal: `xattr -dr com.apple.quarantine /Applications/Infinite.app`
**Windows** 1. Unzip the `x64` or `ARM64` build for your CPU. 2. Run `Infinite.exe`. The build is not code-signed, so Windows SmartScreen may say "Windows protected your PC": click **More info**, then **Run anyway**. It asks once per download.
**Linux** 1. `chmod +x Infinite-x86_64.AppImage` 2. Run `./Infinite-x86_64.AppImage`. It bundles the static AppImage runtime, so no `libfuse2` install is needed. In a container or on a system with no `/dev/fuse`, use `./Infinite-x86_64.AppImage --appimage-extract-and-run` instead.
Build from source
macOS
Requirements: **CMake 3.16+** and **Xcode Command Line Tools**.
git clone https://github.com/n1m21n/Infinite.git cd Infinite cmake -B build -DCMAKE_BUILD_TYPE=Release cmake --build build -j8 open build/Infinite.app
*To make a standalone DMG installer, run `./package.sh`.*
Windows
Requirements: **CMake 3.16+** and **Visual Studio 2022/2026** (MSVC v143+, Desktop development with C++).
git clone https://github.com/n1m21n/Infinite.git cd Infinite cmake -S . -B build -G "Visual Studio 17 2022" -A x64 cmake --build build --config Release .\build\Release\Infinite.exe
*To make a packaged portable folder, run `powershell -ExecutionPolicy Bypass -File package.ps1`.*
Linux
Requirements: **CMake 3.16+**, a C++20 compiler (Clang or GCC), Ninja, and the dev packages in `tools/linux/deps-apt.sh` (X11, GLFW, ALSA and fontconfig headers). x86_64, glibc 2.35 or newer (Ubuntu 22.04+ or equivalent) to match the published AppImage's floor.
git clone https://github.com/n1m21n/Infinite.git cd Infinite tools/linux/deps-apt.sh # installs build and runtime deps via apt tools/linux/build.sh # configures and builds build-linux/Infinite ./build-linux/Infinite
*To package a portable AppImage, run `tools/linux/package-appimage.sh build-linux artifacts-linux`.* A containerised dev environment (no local dep install needed) is available through `tools/linux/local.sh build`; see that script for details.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 418 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Infinite
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="art/brand/readme/readme-dark.png">
- <img src="art/brand/readme/readme-light.png" alt="Infinite: a DAW for you. Visuals, music and code on one canvas." width="100%">
- </picture>
- [](https://discord.gg/GMeQTyJqkH)
- [](https://www.youtube.com/watch?v=vXRjrDhSq24&t=1421s)
- [](https://github.com/n1m21n/Infinite)
- [](LICENSE)
- [<img src="https://trendshift.io/api/badge/trendshift/repositories/187223/daily?language=C%2B%2B" alt="n1m21n%2FInfinite | Trendshift" width="250" height="55"/>](https://trendshift.io/repositories/187223?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-187223)
- **Infinite is a free, open-source node-based audiovisual workstation for macOS, Windows and Linux.** Build real-time visuals, music and interactive art on one node canvas: GPU image and video compositing, procedural 3D with a path-traced renderer, a modular synth rack with VST3 and AU plugin hosting, a 2D layer editor, Session and Timeline arrangement, and MIDI, OSC, Syphon, Spout and NDI I/O. It also runs headless from the command line and exposes an MCP server for AI coding agents. Everything patches into everything through one modulation graph, in English, Spanish, German, Chinese, Japanese and Russian. **Field**, Infinite's own programming language, lets you write what a node does instead of only wiring fixed ones.
- *Use it for VJing and live visuals, generative art, music production, motion graphics, shader and creative coding, and audio-reactive 3D. A free alternative in the spirit of TouchDesigner, VCV Rack, Max/MSP, Bitwig's Grid and VVVV, with a DAW-style Timeline and Session built in.*
- 
- ---
- ## Download
- [](https://github.com/n1m21n/Infinite/releases/latest/download/Infinite.dmg) [](https://github.com/n1m21n/Infinite/releases/latest/download/Infinite-windows-x64.zip) [](https://github.com/n1m21n/Infinite/releases/latest/download/Infinite-windows-ARM64.zip) [](https://github.com/n1m21n/Infinite/releases/latest/download/Infinite-x86_64.AppImage)
- Always the newest release. All files, checksums and release notes are on the [Releases page](https://github.com/n1m21n/Infinite/releases/latest). First-launch steps for each platform are under [Installation](#installation).
- ---
- ## Start here
- New to Infinite? Watch the full walkthrough on YouTube: **[Infinite video walkthrough and tutorial](https://www.youtube.com/watch?v=vXRjrDhSq24&t=1421s)**.
- ### What's new in 2.0
- - **2D View**: a layered, non-destructive compositor with paint, vector and text layers, 28 adjustments, layer styles, Photoshop-style shortcuts and layered PSD and ORA import and export.
- - **Real-time 3D**: Render 3D moves onto a Metal engine with a path tracer, richer materials, fog, sky and more light types.
- - **Field Patcher and Spectral Field**: edit Field kernels as boxes and wires, synced with code.
- - **Mixer and Drums**: a hardware-desk Mixer and Drum Sequencer, with a Session view that follows the Timeline.
- - **Mod Matrix and Performance**: every modulation in one table, and a surface of knobs, faders and pads for playing a patch live.
- - **Headless, CLI and MCP**: a wider `infinite` command, headless rendering and 12 MCP tools.
- - **Free updates for life**: every future version is a free update.
- Full list: [v2.0 release notes](docs/release/v2.0-notes.md).
- ### Templates and the Showcase
- Start from a working patch instead of an empty canvas. 15 **Starters** each teach one idea in 3 to 6 nodes with Comment notes beside them (first sound, first image, music to image, notes, synths, effects, 3D, modulators, Field and more), and the **Showcase** is a full piece that plays on its own: sound, picture, arrangement, Session scenes and a Performance page, with its media bundled. Open the Templates window from the menu; the Showcase is listed first.
- ---
- ## Nodes
- ### The node canvas
- 
- Everything is a node, and every cable carries one kind of thing: pictures, 3D geometry, audio, notes or control signals. Patch left to right, right-click to add, and anything with a dot beside it can be modulated. Infinite has **372 node types** on macOS; the [Node library](#node-library) lists them by domain, and the [Node Reference Manual](Infinite_Node_Reference_Manual.pdf) covers most of them.
- ### Pictures and video
- 
- A GPU texture pipeline (GLSL, OpenGL 3.2 Core): images, video and camera, Syphon, Spout and NDI sources, shapes, noise and Field Pixel shaders, 32 blend modes, blur, bloom, glitch, halftone, curves, LUTs, reaction-diffusion, feedback loops and on-device background removal. The frames above are four seconds of the bundled Showcase patch, rendered headless.
- ### 3D
- Procedural meshes, imports (USD, OBJ, PLY, STL, glTF), booleans, Voronoi and Delaunay, instancing on points, particles, PBD cloth and soft bodies, metaballs, Camera and Light nodes, and PBR rendering (Cook-Torrance GGX, ACES, 32-bit HDRI). The [3D View panel](#3d-view) composes them into one scene.
- ### Sound
- 
- A sample-accurate, pull-based audio graph on the same BPM transport as the pictures. Synths and physical models (Analog, FM, Wavetable, Metallic, String, **Piano**, **Wind**, Granular, PaulStretch, Molder, Sampler, Slicer, 8-track Drum Sequencer, Looper), a full effects rack, AU and VST3 plugin hosting with native windows and modulatable parameters, and **Generate Samples**, a player whose sample is made rather than loaded: pick one of 60 music styles and a part (all, synths, pads, plucks, percussion or drums), press generate, and a loop of 1, 2, 4 or 8 bars is rendered from Infinite's own instruments. It saves as a recipe, not as audio.
- ### Notes and control
- 
- Note sequencers, arpeggiator, chorder, quantizer and MIDI in and out on one side; LFOs, envelopes, random, pattern CV, audio analysis (8-band FFT, onsets), image analysis and camera tracking on the other. Any source can drive any parameter: a shader control, a 3D transform, a synth knob or a hosted plugin's parameter.
- ### Node library
- <p align="center"><img src="docs/screenshots/v2/library.png" alt="The Library panel: modules, Field, samples, media and plugins, searchable" width="35%"></p>
- Infinite has **372 node types** on macOS (377 are registered; five internal types are hidden from the spawn menu):
- | Domain | Key nodes |
- |---|---|
- | **2D and video** | Image, folder Slideshow, Video (hardware-accelerated), Syphon In / Spout In, NDI In, Paint/Draw canvas, GLSL Formula editor, Sketch (JavaScript-drawn images, with SVG animation), Shapes (SDF), Noise and Ramp (gradient) |
- | **2D FX and grading** | Blur, Bloom, Glitch (6 modes), Twirl, Ripple, Displace, Halftone, Curves (RGB/Luma splines), Dither, Color Ramp, .cube LUTs, Gradient Map, Palette extraction |
- | **Compositing and masks** | Blend (32 modes), Layer Stack, Remove Background (on-device ML segmentation), Chroma/Luma Key, Feedback loop, Reaction Diffusion, Resynthesize |
- | **3D geometry and FX** | Primitives, USD/OBJ/PLY/STL/glTF/GLB import, 3D Text, 3D Curves, Distribute Points in Grid / on Faces, Sketch 3D (JavaScript-built meshes), Mesh to Edges / Faces / Points, Delaunay Mesh, Voronoi Cells, Decimate, Curve Ops, Armature, Smooth, Array, Instancing, Metaballs, Point Trails |
- | **3D scene and render** | 3D View, Camera (orbit/perspective/ortho), Light, 32-bit HDRI Environment, PBR Materials, ACES tonemapping, multisampled antialiasing |
- | **Synths and sound** | Wavetable, Metallic modal resonator, String, Piano, Wind, Generate Samples, Granular, PaulStretch, Molder / Grain Molder (spectral resynthesis), Sampler, Slicer (onset-detecting sample chopper), 8-track Drum Sequencer, 16-pad MPC sampler, Looper (record and overdub, tempo-synced, latency-compensated), multi-waveform Oscillator |
- | **Field language** | Field Modifier, Field Primitive, Field Effect, Field Synth, Field Pixel, Field Notes, Field Graph (see [below](#field-and-code)) |
- | **Notes and MIDI** | Piano Roll, live MIDI input and clock, Arpeggiator, Note Sequencer, Chorder, Note Strum, Bouncing Balls (physics notes), Humanizer, Quantizer, MIDI File player, MIDI Out (hardware and virtual ports, CC and clock) |
- | **Audio FX and plugins** | **AU / VST3 Plugin Host**, Filters, EQ, Dynamics, Limiter, Delay, Reverb, Drive/Saturation, Pitch and Frequency Shifters, Chorus, Phaser, Formant |
- | **Modulators and analysis** | LFO, Random, Pattern, Envelope, Math, XY Pad, Audio Analyze (8-band FFT, onset), Image Analyze (luminance, motion), Hand / Face / Pose Track (camera to modulators, via the Tracking pack) |
- | **Output and I/O** | Spatial Mixer (3D headphone mix with head tracking), PNG snapshot, H.264/MOV recording with synchronised audio, Syphon Out / Spout Out, NDI Out |
- ---
- ## Panels
- Panels dock to the edges of the node canvas and open from the rail or a key; every shortcut is listed under [Manuals and shortcuts](#manuals-and-shortcuts).
- ### 2D View
- <img src="docs/screenshots/v2/2d-view.webp" alt="2D View compositing layers, masks, tools and node outputs" width="100%">
- A non-destructive 2D layer and node compositor (Shift + 2). Stack seven layer kinds (`Node`, `Fill`, `Group`, `Paint`, `Vector`, `Text` and `Adjust`, plus After-Effects-style 3D card layers) across 39 tools (Move, Marquee, Lasso, Magic Wand, Selection Brush, Healing, Brush, Clone Stamp, Eraser, Gradient, Pen, Shape, Text and more), 32 blend modes (and four legacy modes kept for older patches), 28 adjustment layers (with `Drive A..D` modulation), 10 layer styles and a drag-to-reorder Smart Filter stack of 18 GPU node effects. Live `Node` layers keep animating from the graph, and PSD and ORA files import and export with layers intact. Free Transform (Cmd+T) moves, scales and turns the selected layers as one step. Merge Down and Merge Layers (Cmd+E), Merge Visible (Cmd+Shift+E) and Flatten Image merge layers the way Photoshop does, in one undo step. A layer's source can be a Canvas Link pick: choose a node from the list, or click it on the canvas.
- ### 3D View
- <img src="docs/screenshots/v2/3d-view.webp" alt="3D View composing node outputs into one scene" width="100%">
- The final stage of a 3D patch (Shift + 3). Right-click a 3D node, add it to the view, arrange objects, look through a camera and render a still or animation. It follows Blender's keymap (`G`/`R`/`S` with axis locks, `1`/`3`/`7` views, `0` camera, `Tab` Edit Mode, `Ctrl/Cmd+Tab` Pose and Sculpt modes) and includes 6 light types with Kelvin temperature and light linking, Principled BSDF PBR materials with 10 texture maps, HDRI world lighting, depth of field, ambient occlusion, bloom, ACES/AgX colour management and Raster, Path trace and Metal Live engines.
- ### Field Patcher
- <img src="docs/screenshots/v2/field-patcher.webp" alt="Field Patcher editing a Field Pixel kernel as boxes and wires, synced with its code and live preview" width="100%">
- A docked visual box-and-wire editor for the Field language (Shift + F, or the **Boxes** button on any Field node). Edit `Field Notes`, `Field Primitive`, `Field Modulator`, `Field Modifier`, `Field Pixel` and `Field Effect` nodes visually across 10 box families (`Sources`, `Arithmetic`, `Range`, `Waves`, `Logic`, `Time & memory`, `Random`, `Geometry`, `Music`, `Inlets / outlets`) and 20 built-in starters, with two-way sync to the `Code` tab and scratch pages saved in the patch.
- ### Mixer and Drum Sequencer
- | Mixer | Drum Sequencer |
- |---|---|
- | <img src="docs/screenshots/v2/mixer.webp" alt="Hardware-desk Mixer with graphite channel strips, knurled pots and LED meters" width="100%"> | <img src="docs/screenshots/v2/drums.webp" alt="Hardware-desk Drum Sequencer with lit step keys, trig conditions and waveform inspector" width="100%"> |
- | A hardware-desk mixer with graphite channel strips, colour caps, scribble strips, knurled trim and pan pots, M/S/phase buttons, LED meters and a Master bus with LUFS/true-peak readouts. | An 8-lane step sequencer in the same desk vocabulary: velocity-lit step keys, trig conditions, probability, nudge, FILL, per-lane length, reverse, filter, live audition and groove-matched kits from your own sample library. |
- ### Sample Studio
- <img src="docs/screenshots/v2/sample-studio.webp" alt="Sample Studio editing a take beside the Mod Matrix and Session view" width="100%">
- A self-contained sample editor (Shift + W). Open a file, drop one in, record from the audio input, or generate a take. Zoom the waveform, cut it into slices by transients, grid or equal parts, and give each slice its own gain, pan, pitch, fine tune, stretch, fades, shape, colour, mute and solo. Editing never touches the canvas. When it sounds right, Convert puts it on the canvas as a node that plays it (a generated take can also come back as the patch that made it); Export writes the whole edit or each slice to WAV, FLAC or MP3. Studio work is saved in the patch.
- ### Piano Roll
- <img src="docs/screenshots/v2/piano-roll.webp" alt="Piano Roll with notes in a scale beside an MSEG" width="100%">
- A note editor (Shift + R) for MIDI lanes on the Timeline, played by the Piano Roll node. Draw, erase, select and quantise notes, snap to the project's scale (in-scale lanes are coloured), and transform them with Humanize, Strum, Legato, Chop to Grid, Velocity Ramp, Reverse, Invert and half or double speed. Record from a MIDI input, import a `.mid` file, or press Generate (G) to write notes in the page's key. The page takes the node it plays through Canvas Link, the same pick that 2D layers and session clips use.
- ### Session and Timeline
- <img src="docs/screenshots/v2/performance-session.webp" alt="Session view of clips and scenes beside the Performance panel in Edit mode" width="100%">
- **Session.** A clip launcher for live sets (Shift + S): audio and video clips in scenes, launch quantize (1 bar by default), Trigger and Gate launch modes, follow actions and "Then Play Next Scene". Record writes your performance into the Timeline, and Render Take renders that span, audio and video, to a folder. A clip's source can be picked with Canvas Link, as on the Piano Roll and in 2D layers.
- **Timeline.** The arrangement (Shift + T): clips on tracks against the same BPM transport, a blade tool, track groups, markers, loop and snap, drag-and-drop media import, live waveforms and video thumbnails, and a render queue.
- ### Mod Matrix and Performance
- <img src="docs/screenshots/v2/mod-matrix-timeline.webp" alt="Mod Matrix rows driving parameters, with the node graph and Timeline" width="100%">
- The Mod Matrix (Shift + M) lists every modulation in the patch in one table: source, destination, range, curve and invert, with each source's live signal. The Performance panel (Shift + P) is a surface for playing a patch: pages of knobs, faders, XY pads, toggles, triggers, radio selectors and step gates, each assigned to any parameter, with MIDI learn and a response curve per control. Edit mode lays it out; Perform mode plays it.
- ### Terminal and the `infinite` command
- <img src="docs/screenshots/v2/terminal.png" alt="The Terminal panel running the infinite command" width="100%">
- A real terminal inside Infinite (Ctrl + \`), docked on any side, running your own shell and your own tools, coding agents included. No agent ships with Infinite.
- Its `infinite` command drives the open patch; see [Headless, CLI and agents](#headless-cli-and-agents).
- ---
- ## Plugins and connections
- Infinite plays with the rest of your setup:
- - **AU and VST3 plugin hosting**: Audio Unit (macOS) and VST3 (macOS, Windows, Linux), with native plugin windows and modulatable parameters. Scan controls and the list of scanned plugins live in Settings > Plugins.
- - **MIDI and OSC**: live MIDI input and clock, MIDI Out to hardware and virtual ports (notes, CC, clock), MIDI learn on every Performance control, and OSC Send and Receive nodes.
- - **Video to other apps**: Syphon (macOS) and Spout (Windows) zero-copy video in and out, and NDI in and out (needs the free NDI runtime).
- - **Files**: PNG snapshots, H.264/MOV recording with synchronised audio, WAV, FLAC and MP3 export, `.mid` import, and USD, OBJ, PLY, STL and glTF models.
- ---
- ## Field and code
- Every other node in Infinite does one fixed thing: a Blur node blurs, a Delay node delays. **Field** nodes are different. You write a short kernel, and Field works out where it runs from what the code touches.
- ```
- col = vec3(uv.x, uv.y, 0.5) // once per pixel, on the GPU: a shader
- P.y += sin(P.x * 4.0 + t) * 0.2 // once per point in a mesh: a geometry deformer
- out = in * gain // once per audio sample: a DSP effect
- ```
- That is the one idea underneath the language: a **kernel**, run once per element of a **domain**, forever. You never declare where it runs; the domain, and so the backend it compiles to, is inferred.
- | Node | Domain | What it does |
- |---|---|---|
- | **Field Modifier** | element | Per-vertex kernel over existing geometry: modifies `P`, `N`, `uv`, `Cd` and custom attributes |
- | **Field Primitive** | element | Generates point geometry from scratch (Circle, Spiral, Grid Lattice, Fibonacci Sphere, Helix, Torus Knot) |
- | **Field Effect** | sample | Per-sample audio DSP kernel; `in`/`out`, `state` for per-voice memory, `param` for knobs |
- | **Field Synth** | sample | Polyphonic note-driven synth voice on the same sample compiler, with `freq`/`gate` in place of an audio input |
- | **Field Pixel** | pixel | Per-pixel kernel compiled straight to GLSL; `state` cells with `[wrap]` support feedback and stencils |
- | **Field Notes** | sample | Per-sample note kernel: `note(pitch, vel, len)` sends notes out, and `tick(div)`, `deg(d)`, `rand()` and `beat` read the transport |
- | **Field Graph** | graph | Runs once at edit time: `emit()`/`connect()`/`set()`/`place()` mount and wire real Infinite nodes into a bundle ("Instrument Mode" collapses it to one box; "Unpack to Canvas" expands it again) |
- Any element, pixel or sample kernel can declare **dynamic pins** in its code, adding real, cable-wireable, save-safe inputs and outputs without touching C++. Finished devices (kernel, params and presets) save and share as portable `.field` files. The full reference is in the [Field Language Manual](Field_Language_Manual.pdf).
- Field is not the only way to write code in Infinite. **Sketch** draws images with JavaScript (with SVG animation), **Sketch 3D** builds meshes with JavaScript, the **GLSL Formula** node is a live shader editor, and **expressions** (`infinite expr`) drive any parameter from a formula. `infinite code new | check | watch | docs | examples` writes and checks all of them against the real compilers.
- ---
- ## Headless, CLI and agents
- Infinite also runs with no window: pictures, video and sound straight from a `.inf` text file on the command line, the same engine the `infinite` command uses. See the [Headless User Guide](docs/headless/Infinite_Headless_User_Guide.pdf) ([Markdown](docs/headless/GUIDE.md)).
- ```bash
- Infinite --validate hello.inf # check a patch
- Infinite --frame hello.inf 0,1,2 pics/ --contact-sheet sheet.png # pictures at chosen seconds
- Infinite --render hello.inf hello.mp4 --duration 4 --fps 30 # video with sound
- ```
- ### The `infinite` command
- Inside the Terminal panel (Ctrl + `), or from any shell, `infinite` drives the open patch:
- ```bash
- infinite graph # look: the nodes and cables of the open patch
- infinite add Analog # edit: add, connect, set, mod, expr, undo
- infinite connect 1 2 # wire node 1 into node 2
- infinite mod 3 2 volume # modulate node 2's volume from node 3
- infinite play # play: also tempo, seek, session, timeline
- infinite shot selected node.png # see and hear: shot, frame, render, audio
- infinite code docs field # code: new, check, watch, docs, examples for Field, Sketch, GLSL, formulas
- ```
- With no app running, every verb that takes a `.inf` file runs headless. `infinite context` prints a short brief of the open patch and `infinite guide` the full reference.
- ### Agents and MCP
- <img src="docs/screenshots/v2/chat.webp" alt="The Chat panel: asking agents about a node, with the patch on the canvas" width="100%">
- For AI coding assistants there is an MCP server, [`tools/npm/infinite-engine`](tools/npm/infinite-engine) (npm: `infinite-engine`), and a Claude plugin described in [`tools/mcp/README.md`](tools/mcp/README.md).
- ```bash
- # Add Infinite to Claude Desktop, Cursor and Windsurf:
- npx -y infinite-engine init
- ```
- | MCP tool | What it does |
- |---|---|
- | `infinite_synthesize_field_synth` | Renders WAV audio from an inline Field Synth kernel |
- | `infinite_synthesize_field_notes` | Renders algorithmic note sequences and Euclidean rhythms from a Field Notes kernel |
- | `infinite_process_field_effect` | Processes audio through an inline Field Effect kernel |
- | `infinite_render_field_pixel` | Renders a Field Pixel shader to a PNG |
- | `infinite_render_field_primitive` | Renders parametric surfaces from Field Primitive equations |
- | `infinite_render_field_modifier` | Deforms a mesh with an inline Field Modifier kernel |
- | `infinite_render_sketch3d` | Renders JavaScript-built 3D geometry to a PNG |
- | `infinite_validate_patch` | Checks a `.inf` patch against the engine |
- | `infinite_render_video` | Renders an MP4 from a `.inf` patch |
- | `infinite_compare_frames` | Compares two pictures (PNG, `.inf` or patch text) and says whether they match, in plain words |
- | `infinite_find_knob` | Finds which node and param move gives a wanted picture change, from measured renders |
- | `infinite_node_effects` | Gives the measured effect of an Effects or colour node: what adding it does, and what each param does |
- Tool schemas and prompts: [`tools/npm/infinite-engine/README.md`](tools/npm/infinite-engine/README.md) and [`AGENT.md`](AGENT.md).
- ### AI skill files
- Infinite ships reference files you can hand to any AI assistant, or drop into `~/.claude/skills/`, so it writes correct patches and code first time. Settings > Terminal installs all three at once (**Install All AI Skills**) or the patch authoring file alone; the Field Language and Expression Globals pages each have an **Install AI Skill** button for their own file. In the Terminal, `infinite guide` and `infinite code docs <language>` print the same references.
- ---
- ## Manuals and shortcuts
- | Manual | What it covers |
- |---|---|
- | [Node Reference Manual](Infinite_Node_Reference_Manual.pdf) | Every node, with its pins and parameters |
- | [Field Language Manual](Field_Language_Manual.pdf) | Syntax, domains, domain-transfer operators, reserved words, the node and file format reference |
- | [Headless User Guide](docs/headless/Infinite_Headless_User_Guide.pdf) | Rendering and checking patches from the command line |
- Every keyboard shortcut is listed in the app under **All shortcuts...** in the menu. The panels:
- | Key | Panel |
- |---|---|
- | Shift + 2 | 2D View |
- | Shift + 3 | 3D View |
- | Shift + F | Field Patcher |
- | Shift + E | Curve Editor |
- | Shift + S | Session |
- | Shift + T | Timeline |
- | Shift + L | Mixer |
- | Shift + J | Drums |
- | Shift + R | Piano Roll |
- | Shift + W | Sample Studio |
- | Shift + M | Mod Matrix |
- | Shift + P | Performance |
- | Shift + U | History |
- | Shift + K | Audio engine on or off (on the canvas) |
- | Ctrl + \` | Terminal |
- ---
- ## Installation
- ### Pre-built app (macOS, Windows and Linux)
- Download the latest build from [GitHub Releases](https://github.com/n1m21n/Infinite/releases): `Infinite.dmg` for macOS, `Infinite-windows-x64.zip` / `Infinite-windows-ARM64.zip` for Windows (or the `Infinite-Setup-windows-x64.exe` / `Infinite-Setup-windows-ARM64.exe` installer), or `Infinite-x86_64.AppImage` for Linux.
- **macOS** (Infinite is not notarised by Apple, so the first launch needs one extra step)
- With Homebrew: `brew install --cask n1m21n/tap/infinite` (the first-launch step below still applies).
- 1. Open the DMG and drag `Infinite.app` to Applications.
- 2. Double-click `Fix & Open Infinite.command` in the DMG and press `y`. It clears the download flag on Infinite only, then opens it.
- - Or by hand: try to open Infinite once, then **System Settings > Privacy & Security > Open Anyway** (macOS 15 and later), or right-click `Infinite.app` > **Open** (older macOS).
- - Or in Terminal: `xattr -dr com.apple.quarantine /Applications/Infinite.app`
- **Windows**
- 1. Unzip the `x64` or `ARM64` build for your CPU.
- 2. Run `Infinite.exe`. The build is not code-signed, so Windows SmartScreen may say "Windows protected your PC": click **More info**, then **Run anyway**. It asks once per download.
- **Linux**
- 1. `chmod +x Infinite-x86_64.AppImage`
- 2. Run `./Infinite-x86_64.AppImage`. It bundles the static AppImage runtime, so no `libfuse2` install is needed. In a container or on a system with no `/dev/fuse`, use `./Infinite-x86_64.AppImage --appimage-extract-and-run` instead.
- ### Build from source
- #### macOS
- Requirements: **CMake 3.16+** and **Xcode Command Line Tools**.
- ```bash
- git clone https://github.com/n1m21n/Infinite.git
- cd Infinite
- cmake -B build -DCMAKE_BUILD_TYPE=Release
- cmake --build build -j8
- open build/Infinite.app
- ```
- *To make a standalone DMG installer, run `./package.sh`.*
- #### Windows
- Requirements: **CMake 3.16+** and **Visual Studio 2022/2026** (MSVC v143+, Desktop development with C++).
- ```powershell
- git clone https://github.com/n1m21n/Infinite.git
- cd Infinite
- cmake -S . -B build -G "Visual Studio 17 2022" -A x64
- cmake --build build --config Release
- .\build\Release\Infinite.exe
- ```
- *To make a packaged portable folder, run `powershell -ExecutionPolicy Bypass -File package.ps1`.*
- #### Linux
- Requirements: **CMake 3.16+**, a C++20 compiler (Clang or GCC), Ninja, and the dev packages in `tools/linux/deps-apt.sh` (X11, GLFW, ALSA and fontconfig headers). x86_64, glibc 2.35 or newer (Ubuntu 22.04+ or equivalent) to match the published AppImage's floor.
- ```bash
- git clone https://github.com/n1m21n/Infinite.git
- cd Infinite
- tools/linux/deps-apt.sh # installs build and runtime deps via apt
- tools/linux/build.sh # configures and builds build-linux/Infinite
- ./build-linux/Infinite
- ```
- *To package a portable AppImage, run `tools/linux/package-appimage.sh build-linux artifacts-linux`.* A containerised dev environment (no local dep install needed) is available through `tools/linux/local.sh build`; see that script for details.
- ---
- ## Architecture
- ```
- src/
- ├── core/ # INode DAG engine, ImageCable, Transport, Modulation, GLUtil, Mesh, terminal core
- ├── nodes/ # Node implementations (2D, 3D, Audio, Synth, Notes, Modulation)
- ├── audio/ # Audio engine, DSP kernels, Wavetable core, plugin hosting (AU/VST3), slice rendering
- ├── arrange/ # Timeline, Session and Piano Roll model and scheduling
- ├── app/ # Canvas, panels, node bodies, patch I/O, headless and RPC
- └── platform/ # OS layer: macOS (CoreAudio/AU/AVFoundation) | Windows (WASAPI/WinMM/Media Foundation/GDI+) | Linux (ALSA/GLFW/X11/VST3)
- ```
- See [ARCHITECTURE.md](ARCHITECTURE.md) and [docs/CODE_STANDARDS.md](docs/CODE_STANDARDS.md) for deeper implementation guides.
- ---
- ## Limits
- The Linux build has the same node graph and file format as macOS and Windows, with these platform gaps:
- - No Syphon/Spout equivalent, so no zero-copy video I/O with other apps.
- - No Audio Unit (AU) hosting: VST3 only (same as Windows).
- - No LV2 plugin hosting.
- - No complex-script text shaping (no HarfBuzz): Latin-script text renders correctly, but right-to-left and complex scripts (Arabic, Devanagari and others) may not.
- - VST3 plugin editor windows need X11 or XWayland; a pure-Wayland session without XWayland cannot show plugin GUIs.
- - x86_64 only: no arm64 build is published.
- ---
- ## Contributing
- Contributions, bug reports and node ideas are welcome.
- - Join the discussion and share creations in the [Discord community](https://discord.gg/GMeQTyJqkH).
- - File bugs or feature requests in [GitHub Issues](https://github.com/n1m21n/Infinite/issues).
- - Submit pull requests with clean-room, MIT-compatible code following [docs/CODE_STANDARDS.md](docs/CODE_STANDARDS.md). See [CONTRIBUTING.md](CONTRIBUTING.md).
- ---
- ## Prior art and acknowledgements
- The tools and papers Infinite builds on are named in [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md), and the people who contributed are credited in [CONTRIBUTING.md](CONTRIBUTING.md#community-and-contributors).
- ---
- ## Cite and credit
- If you write about, review or build on Infinite, please credit it as: *Infinite, by Naman Soni (n1m21n), https://infinitedevices.org*. GitHub's "Cite this repository" button uses [CITATION.cff](CITATION.cff).
- ---
- ## Licence
- Infinite's source code is licensed under the [MIT License](LICENSE).
- Default builds include VST3 plugin hosting linking the [Steinberg VST3 SDK](https://github.com/steinbergmedia/vst3sdk) (MIT since 3.8). The default Linux build is GPLv3 because of its FFmpeg/x264 encoder; see `LICENSE`.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.