{
 "slug": "hydra",
 "name": "Hydra",
 "author": "Olivia Jack and contributors",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Live-coding video synth in the browser: chain oscillators, noise, feedback and camera inputs into abstract motion visuals.",
 "category": {
  "slug": "video-backgrounds",
  "name": "Video references and motion backgrounds"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "abstract",
  "retro",
  "colorful",
  "dark"
 ],
 "logo_url": "https://agentgid.com/media/avatars/hydra-synth.png",
 "logo_letter": "H",
 "links": {
  "repo": "https://github.com/hydra-synth/hydra",
  "website": "https://hydra.ojack.xyz",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/hydra/demo.jpg",
  "alt": "A page banner with a moving pink and blue pattern behind made-up event text, and four small patterns (stripes, a kaleidoscope, noise blobs and a square), each with the line of code that made it.",
  "caption": "Made by AgentGid with hydra-synth 1.4.0 (npm). Made by AgentGid by running the unchanged hydra-synth 1.4.0. AGPL-3.0 allows running the program, and its output is covered only if the output itself is a covered work; the picture holds no Hydra code."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "AGPL-3.0",
   "quote": "You may charge any price or no price for each copy that you convey,",
   "note": "Paid use is allowed, but code you pass on (including a site that ships it) stays AGPL-3.0 with its source on offer.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": null,
   "quote": "You may convey verbatim copies of the Program's source code as you",
   "note": null,
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install hydra-synth. No key or account is needed.",
   "source": {
    "label": "github.com/hydra-synth/hydra",
    "url": "https://github.com/hydra-synth/hydra"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "AGPL-3.0",
  "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE",
  "summary": "Hydra's code is under AGPL-3.0, a strong share-alike license. Running it and using the pictures or videos it makes is fine, even in paid work. If you ship Hydra's code inside your own site or app, you must keep its license and offer the source.",
  "pages_read": 1,
  "rules": [
   "Embedding hydra-synth in a site/app brings AGPL-3.0 source-sharing obligations.",
   "Recorded video output is your own work; the license covers the software."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "With conditions",
    "status": "cond",
    "quote": "You may charge any price or no price for each copy that you convey,",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "You may convey verbatim copies of the Program's source code as you",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "With conditions",
    "status": "cond",
    "quote": "The GNU Affero General Public License is designed specifically to",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You may convey verbatim copies of the Program's source code as you",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-05",
  "commercial_use_page": "https://agentgid.com/assets/hydra/commercial-use/"
 },
 "overview": {
  "heading": "Hydra: live-coded moving visuals in the browser",
  "body": "Hydra is a free video synthesizer that runs in a web browser. You type short lines of code and get moving color patterns, which you can mix with a camera, a video or sound. Use it in its online editor, or put its engine on your own page as a moving background."
 },
 "uses": [
  {
   "title": "Moving background for a page",
   "text": "Put a slowly moving color pattern behind the headline of a landing page or event page, drawn live in the visitor's browser instead of a heavy video file.",
   "idea": false,
   "image": null
  },
  {
   "title": "Visuals for a live show",
   "text": "Make visuals for a concert, DJ set or club night that react to the music and change as you type during the show.",
   "idea": false,
   "image": null
  },
  {
   "title": "Effects on a camera picture",
   "text": "Turn a webcam or a shared screen into a mirror pattern or a glitchy picture, for a stream, a video call backdrop or an art installation.",
   "idea": false,
   "image": null
  },
  {
   "title": "A short video loop to download",
   "text": "Record a few seconds of a pattern as a video file and use it as a background clip in a video, a slide or a social post.",
   "idea": false,
   "image": null
  },
  {
   "title": "Learning how video effects work",
   "text": "Try out feedback, fractals and pixel tricks step by step in the free online editor, with no install.",
   "idea": false,
   "image": null
  },
  {
   "title": "A playful poster for an event",
   "text": "Give a club night or a meetup page an animated top banner that matches the printed poster colors.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add hydra-synth 1.4.0 (AGPL-3.0) to the hero section as a background canvas: new Hydra({ canvas, makeGlobal: false, detectAudio: false }), one slow osc().modulate(noise()) pattern, and pause it for visitors who prefer reduced motion.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Open the online editor at hydra.ojack.xyz, type a line such as osc(20, 0.1, 0.8).out() and run it with Ctrl+Enter.",
    "source": "osc(20, 0.1, 0.8).out()"
   },
   {
    "tab": "Step 2",
    "intro": "To use it on your own page, add the hydra-synth package (or its bundled script file) and start it on a canvas.",
    "source": "import Hydra from 'hydra-synth'\nconst hydra = new Hydra({ detectAudio: false })\nosc(4, 0.1, 1.2).out()"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "<script src=\"https://cdn.jsdelivr.net/npm/hydra-synth/dist/hydra-synth.js\"> as in the how-to page",
   "fix": "Pin the version (hydra-synth@1.4.0) or serve the file yourself",
   "why": "The link without a version always takes the newest release, which can change the page without warning.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "new Hydra() with the default options on a public page",
   "fix": "new Hydra({ detectAudio: false }) unless the sketch reacts to sound",
   "why": "The default turns on sound input, which makes the browser ask every visitor for the microphone.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Calling osc(), noise() and o0 as globals inside an app that has its own code",
   "fix": "new Hydra({ makeGlobal: false }).synth, then h.osc(), h.noise(), h.o1",
   "why": "The default mode adds Hydra's functions to the whole page; in non-global mode everything starts from the instance.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Importing hydra-synth in a Vite project with no extra setting",
   "fix": "Add define: { global: {} } to the Vite config, or a polyfill for global",
   "why": "A package Hydra uses expects the Node global, and Vite pages stop with an error.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Copying a changed hydra-synth into a closed-source app",
   "fix": "Keep the AGPL-3.0 license with the code and offer the source of your version, or pick a permissive library",
   "why": "AGPL-3.0 asks for the source of modified versions that people use over a network.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install hydra-synth",
  "repo": "https://github.com/hydra-synth/hydra",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "Use the editor at hydra.ojack.xyz to sketch and screen-record a loop, or npm install hydra-synth and run a sketch on a canvas.",
  "formats": [
   "js",
   "webm"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Visuals made with Hydra (hydra.ojack.xyz), AGPL-3.0",
  "rules_text": "- Hydra (Video references and motion backgrounds, Web animation examples and effects). Live-coding video synth in the browser: chain oscillators, noise, feedback and camera inputs into abstract motion visuals. Price: free; commercial use with conditions; no credit needed; ship inside your app with conditions; pass the files on to your users only with conditions. Style: abstract, retro, colorful, dark.\n  Connect: npm hydra-synth.\n  Get files: Use the editor at hydra.ojack.xyz to sketch and screen-record a loop, or npm install hydra-synth and run a sketch on a canvas (js, webm).\n  Not allowed: AGPL-3.0\n  Rule: Embedding hydra-synth in a site/app brings AGPL-3.0 source-sharing obligations.\n  Rule: Recorded video output is your own work; the license covers the software.\n  License: https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/hydra/)",
  "agent_md": "https://agentgid.com/assets/hydra/agent.md",
  "card_json": "https://agentgid.com/assets/hydra/card.json"
 },
 "popularity": {
  "gid_score": 25,
  "stars": 2753,
  "downloads_7d": 4637,
  "downloads_7d_label": "4,637",
  "downloads_change_4w_pct": 22.1,
  "eco": "npm",
  "package": "hydra-synth",
  "repo": "hydra-synth/hydra",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     1425
    ],
    [
     "2025-11-24",
     1337
    ],
    [
     "2025-12-01",
     1072
    ],
    [
     "2025-12-08",
     1136
    ],
    [
     "2025-12-15",
     1563
    ],
    [
     "2025-12-22",
     924
    ],
    [
     "2025-12-29",
     1165
    ],
    [
     "2026-01-05",
     1565
    ],
    [
     "2026-01-12",
     1360
    ],
    [
     "2026-01-19",
     1238
    ],
    [
     "2026-01-26",
     1390
    ],
    [
     "2026-02-02",
     1305
    ],
    [
     "2026-02-09",
     1313
    ],
    [
     "2026-02-16",
     1128
    ],
    [
     "2026-02-23",
     730
    ],
    [
     "2026-03-02",
     1169
    ],
    [
     "2026-03-09",
     1151
    ],
    [
     "2026-03-16",
     1169
    ],
    [
     "2026-03-23",
     1070
    ],
    [
     "2026-03-30",
     1352
    ],
    [
     "2026-04-06",
     3091
    ],
    [
     "2026-04-13",
     923
    ],
    [
     "2026-04-20",
     1136
    ],
    [
     "2026-04-27",
     1079
    ],
    [
     "2026-05-04",
     1134
    ],
    [
     "2026-05-11",
     1277
    ],
    [
     "2026-05-18",
     1705
    ],
    [
     "2026-05-25",
     1388
    ],
    [
     "2026-06-01",
     2240
    ],
    [
     "2026-06-08",
     2429
    ],
    [
     "2026-06-15",
     1639
    ],
    [
     "2026-06-22",
     1732
    ],
    [
     "2026-06-29",
     1869
    ],
    [
     "2026-07-06",
     2203
    ],
    [
     "2026-07-13",
     1637
    ],
    [
     "2026-07-20",
     1746
    ],
    [
     "2026-07-27",
     1521
    ],
    [
     "2026-08-03",
     2127
    ],
    [
     "2026-08-10",
     2142
    ],
    [
     "2026-08-17",
     2922
    ],
    [
     "2026-08-24",
     2891
    ],
    [
     "2026-08-31",
     2904
    ],
    [
     "2026-09-07",
     1613
    ],
    [
     "2026-09-14",
     1978
    ],
    [
     "2026-09-21",
     2566
    ],
    [
     "2026-09-28",
     3629
    ],
    [
     "2026-10-05",
     3299
    ],
    [
     "2026-10-12",
     2889
    ],
    [
     "2026-10-19",
     2919
    ],
    [
     "2026-10-26",
     3861
    ],
    [
     "2026-11-02",
     3697
    ],
    [
     "2026-11-09",
     4637
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     2747
    ],
    [
     "2026-11-08",
     2747
    ],
    [
     "2026-11-09",
     2751
    ],
    [
     "2026-11-10",
     2751
    ],
    [
     "2026-11-11",
     2751
    ],
    [
     "2026-11-12",
     2752
    ],
    [
     "2026-11-13",
     2752
    ],
    [
     "2026-11-14",
     2752
    ],
    [
     "2026-11-15",
     2752
    ],
    [
     "2026-11-16",
     2753
    ],
    [
     "2026-11-17",
     2753
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "hydra",
   "name": "Hydra",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "npm"
  },
  {
   "slug": "vanta-js",
   "name": "Vanta.js",
   "why": "Pick Vanta.js when you want a ready animated 3D background such as waves or fog in a few lines, without writing patterns yourself.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "motion-canvas",
   "name": "Motion Canvas",
   "why": "Pick Motion Canvas when you want to code a planned animated video, such as an explainer, and render it to frames or video.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "shadergradient",
   "name": "ShaderGradient",
   "why": "Pick ShaderGradient when you want to set up a moving 3D gradient in a visual editor and copy it into a React page.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "react-three-fiber-examples",
   "name": "React Three Fiber examples",
   "why": "Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use a video I recorded from Hydra in a paid ad or on YouTube?",
   "a": "The license covers Hydra's code, and output is covered only if the output itself is a covered work, so a recorded pattern is your own clip."
  },
  {
   "q": "Can I put Hydra on my company website?",
   "a": "Yes, but the engine is AGPL-3.0, so keep its license with the code you ship and offer the source of any changed version to visitors."
  },
  {
   "q": "How do I save a still picture?",
   "a": "Press Ctrl+Shift+S in the editor, or call screencap(); it saves the picture and the code that made it."
  },
  {
   "q": "Can I show the visuals without the code on top?",
   "a": "Yes. Press Ctrl+Shift+H in the editor to hide the code, or add showCode=false to a shared sketch link."
  }
 ],
 "at_a_glance": {
  "latest_version": "1.4.0",
  "last_commit": "2026-04-25",
  "runtime": "A browser with WebGL; the package is an ES module (import), and dist/hydra-synth.js is a ready script file for a plain page.",
  "key_needed": false,
  "formats": "js, webm"
 },
 "good_to_know": [
  "If you change Hydra's engine and run it on a public site, you must let every visitor get the source of your changed version.",
  "The project calls itself experimental, and its main readme says it works best in Chrome on computers with graphics support, so test other browsers before you rely on it.",
  "By default the engine listens to the microphone, so the browser asks visitors for it. Turn sound input off unless you need it.",
  "Sketches you upload from the online editor go to the public Hydra gallery, so do not put private text or links in them.",
  "The built-in recorder is easy but the docs warn its videos can look rough; most users record the window with OBS instead."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-12",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/"
   },
   {
    "label": "hydra.ojack.xyz/docs",
    "url": "https://hydra.ojack.xyz/docs/"
   },
   {
    "label": "hydra.ojack.xyz/docs/docs/quick-start",
    "url": "https://hydra.ojack.xyz/docs/docs/quick-start/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/getting-started/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/web-editor/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/interactivity/audio/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/hydra-in-a-webpage/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/record-hydra-output/"
   },
   {
    "label": "hydra.ojack.xyz",
    "url": "https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/use-hydra-without-showing-code/"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/hydra-synth/hydra/blob/main/README.md"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/hydra-synth/hydra-synth/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/hydra-synth/hydra-synth/blob/main/LICENSE"
   },
   {
    "label": "npm: hydra-synth/latest",
    "url": "https://registry.npmjs.org/hydra-synth/latest"
   },
   {
    "label": "npm: hydra-synth/1.4.0",
    "url": "https://registry.npmjs.org/hydra-synth/1.4.0"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/hydra/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
