{
 "slug": "zzfx",
 "name": "ZzFX",
 "author": "Frank Force (KilledByAPixel)",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Tiny JavaScript sound effects generator (under 1 KB compressed) for games; one zzfx(...) call plays a sound, with a web designer to make new ones and save them as WAV.",
 "category": {
  "slug": "sound-effects",
  "name": "Sound effects"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/killedbyapixel.png",
 "logo_letter": "Z",
 "links": {
  "repo": "https://github.com/KilledByAPixel/ZzFX",
  "website": null,
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/zzfx/demo.jpg",
  "alt": "Six sound effects built by ZzFX in the browser and drawn as waveforms with their length; four are the sample sounds from the README, coin and jump are our own number lists.",
  "caption": "Made by AgentGid with zzfx 1.4.0 (npm tarball, sha1 9d9c64c2c57497f5cfa2bff5fb83a4cb35874ef6). MIT license; the waveforms are drawn by our page from samples ZzFX generated, no sound files from the project are shown."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Free and open source (MIT).",
   "source": {
    "label": "github.com/KilledByAPixel/ZzFX",
    "url": "https://github.com/KilledByAPixel/ZzFX"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "Open Source: MIT licensed, use it anywhere!",
   "note": "MIT allows paid games and apps; keep the notice with the code.",
   "source": {
    "label": "github.com/KilledByAPixel/ZzFX",
    "url": "https://github.com/KilledByAPixel/ZzFX"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": null,
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/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 zzfx. No key or account is needed.",
   "source": {
    "label": "github.com/KilledByAPixel/ZzFX",
    "url": "https://github.com/KilledByAPixel/ZzFX"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/LICENSE",
  "summary": "Free in personal and paid games, apps and sites, no visible credit needed. Keep the short copyright and license notice with copies of the code.",
  "pages_read": 2,
  "rules": [
   "Keep the MIT copyright and permission notice with the ZzFX code you ship."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "Open Source: MIT licensed, use it anywhere!",
    "source": {
     "label": "github.com/KilledByAPixel/ZzFX",
     "url": "https://github.com/KilledByAPixel/ZzFX"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/LICENSE"
    },
    "note": null
   },
   {
    "label": "Monetized YouTube",
    "value": "Allowed",
    "status": "yes",
    "quote": null,
    "source": null,
    "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-07",
  "commercial_use_page": "https://agentgid.com/assets/zzfx/commercial-use/"
 },
 "overview": {
  "heading": "ZzFX: game sound effects from one line of code",
  "body": "ZzFX is a very small free code library that makes sound effects, such as a coin, a jump or a hit, while the page runs. Each sound is a short list of numbers instead of an audio file, so your game or site needs no sound files to download. A free web designer lets you shape new sounds and save them as WAV files."
 },
 "uses": [
  {
   "title": "Sounds for a browser game",
   "text": "Give jumps, coins, hits and game-over moments their own sound in a small web game, without hunting for audio files.",
   "idea": false,
   "image": "https://agentgid.com/assets/zzfx/demo.jpg"
  },
  {
   "title": "Game jams with a size limit",
   "text": "Keep sound in a game for a contest that caps the whole game at a few kilobytes, such as js13k.",
   "idea": false,
   "image": null
  },
  {
   "title": "Placeholder sounds while prototyping",
   "text": "Try sound in an early game or app version in minutes, then swap in recorded sounds later if you want.",
   "idea": false,
   "image": null
  },
  {
   "title": "Clicks and chimes on a website",
   "text": "Add a soft click to a button or a chime when a task is done on an ordinary website, not only in games.",
   "idea": false,
   "image": null
  },
  {
   "title": "Sound files for other engines",
   "text": "Shape a sound in the free designer, download it as a WAV file and use it in an engine or app that cannot run JavaScript.",
   "idea": false,
   "image": null
  },
  {
   "title": "Sound that changes with the action",
   "text": "Raise the pitch of a coin sound as the combo grows, or pan an explosion to the side where it happens.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add zzfx 1.4.0 to the game, define coin, jump, hit and game-over sounds as ZzFX number lists in one sfx file, and play them only after the first click or key press.",
  "install": "npm install zzfx",
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Import it and play a sound with one call; the list of numbers describes the sound.",
    "source": "import {ZZFX, zzfx} from './ZzFX.js'\nzzfx(...[,,,,.1,,,,9])"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Importing zzfx at the top of a server-rendered file (Next.js page, Nuxt server code, Node script)",
   "fix": "Import it only in browser code, for example inside useEffect, onMounted or a dynamic import",
   "why": "ZzFX.js creates an AudioContext when the module loads, and there is no AudioContext on the server.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "zzfx([,,925,.04,.3]) with the array passed as one argument",
   "fix": "zzfx(...[,,925,.04,.3]) with the spread operator, so each number is its own argument",
   "why": "zzfx takes the numbers as separate parameters; the README always spreads the list.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Calling zzfx(...) again on every frame for a sound used very often",
   "fix": "Build it once with new ZZFXSound([...]) and call .play() when needed",
   "why": "The sound object stores the generated samples, so later plays start at once.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Writing sound parameters by guesswork",
   "fix": "Shape the sound in the ZzFX Sound Designer and paste the code it shows",
   "why": "The 20 numbers interact; the designer plays and draws each change.",
   "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 zzfx",
  "repo": "https://github.com/KilledByAPixel/ZzFX",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install zzfx, then import {zzfx} from 'zzfx' and call zzfx(...params); or copy ZzFX.js from the repository.",
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Sound effects: ZzFX (MIT)",
  "rules_text": "- ZzFX (Sound effects). Tiny JavaScript sound effects generator (under 1 KB compressed) for games; one zzfx(..) call plays a sound, with a web designer to make new ones and save them as WAV. Price: free; commercial use OK; no credit needed.\n  Connect: npm zzfx.\n  Get files: npm install zzfx, then import {zzfx} from 'zzfx' and call zzfx(..params); or copy ZzFX.js from the repository.\n  Not allowed: Keep the MIT notice with the code\n  Rule: Keep the MIT copyright and permission notice with the ZzFX code you ship.\n  License: https://github.com/KilledByAPixel/ZzFX/blob/master/LICENSE (checked 2026-11-07; details: https://agentgid.com/assets/zzfx/)",
  "agent_md": "https://agentgid.com/assets/zzfx/agent.md",
  "card_json": "https://agentgid.com/assets/zzfx/card.json"
 },
 "popularity": {
  "gid_score": 27,
  "stars": 816,
  "downloads_7d": 11795,
  "downloads_7d_label": "11.8K",
  "downloads_change_4w_pct": 72.1,
  "eco": "npm",
  "package": "zzfx",
  "repo": "KilledByAPixel/ZzFX",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     323
    ],
    [
     "2025-11-24",
     188
    ],
    [
     "2025-12-01",
     76
    ],
    [
     "2025-12-08",
     294
    ],
    [
     "2025-12-15",
     211
    ],
    [
     "2025-12-22",
     421
    ],
    [
     "2025-12-29",
     227
    ],
    [
     "2026-01-05",
     203
    ],
    [
     "2026-01-12",
     237
    ],
    [
     "2026-01-19",
     180
    ],
    [
     "2026-01-26",
     273
    ],
    [
     "2026-02-02",
     266
    ],
    [
     "2026-02-09",
     279
    ],
    [
     "2026-02-16",
     342
    ],
    [
     "2026-02-23",
     195
    ],
    [
     "2026-03-02",
     1374
    ],
    [
     "2026-03-09",
     11693
    ],
    [
     "2026-03-16",
     5535
    ],
    [
     "2026-03-23",
     11125
    ],
    [
     "2026-03-30",
     9862
    ],
    [
     "2026-04-06",
     7746
    ],
    [
     "2026-04-13",
     7566
    ],
    [
     "2026-04-20",
     11689
    ],
    [
     "2026-04-27",
     10601
    ],
    [
     "2026-05-04",
     13496
    ],
    [
     "2026-05-11",
     12105
    ],
    [
     "2026-05-18",
     13367
    ],
    [
     "2026-05-25",
     12223
    ],
    [
     "2026-06-01",
     16716
    ],
    [
     "2026-06-08",
     8452
    ],
    [
     "2026-06-15",
     7943
    ],
    [
     "2026-06-22",
     7285
    ],
    [
     "2026-06-29",
     4947
    ],
    [
     "2026-07-06",
     4284
    ],
    [
     "2026-07-13",
     5403
    ],
    [
     "2026-07-20",
     5228
    ],
    [
     "2026-07-27",
     4489
    ],
    [
     "2026-08-03",
     3942
    ],
    [
     "2026-08-10",
     4175
    ],
    [
     "2026-08-17",
     3169
    ],
    [
     "2026-08-24",
     4770
    ],
    [
     "2026-08-31",
     4696
    ],
    [
     "2026-09-07",
     6093
    ],
    [
     "2026-09-14",
     3051
    ],
    [
     "2026-09-21",
     5278
    ],
    [
     "2026-09-28",
     9468
    ],
    [
     "2026-10-05",
     7623
    ],
    [
     "2026-10-12",
     6340
    ],
    [
     "2026-10-19",
     10116
    ],
    [
     "2026-10-26",
     12822
    ],
    [
     "2026-11-02",
     13319
    ],
    [
     "2026-11-09",
     13142
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     810
    ],
    [
     "2026-11-08",
     810
    ],
    [
     "2026-11-09",
     810
    ],
    [
     "2026-11-10",
     812
    ],
    [
     "2026-11-11",
     812
    ],
    [
     "2026-11-12",
     812
    ],
    [
     "2026-11-13",
     813
    ],
    [
     "2026-11-14",
     814
    ],
    [
     "2026-11-15",
     815
    ],
    [
     "2026-11-16",
     815
    ],
    [
     "2026-11-17",
     816
    ],
    [
     "2026-11-18",
     816
    ],
    [
     "2026-11-19",
     816
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "zzfx",
   "name": "ZzFX",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "jsfxr",
   "name": "jsfxr (sfxr.me)",
   "why": "Pick jsfxr for classic 8-bit style sounds from the older sfxr generator, with its own web app and WAV export.",
   "current": false,
   "price": "Free tier",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "uisfx",
   "name": "UI SFX",
   "why": "Pick UISFX when you want ready recorded interface sounds as MP3 and Ogg files instead of making your own.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "freesound",
   "name": "Freesound",
   "why": "Pick Freesound for real recorded sounds such as doors, rain or voices, checking each sound's own license.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "API"
  },
  {
   "slug": "cuelume",
   "name": "Cuelume",
   "why": "Fourteen interaction sound cues for web interfaces, synthesized live with Web Audio and bound to elements through data attributes.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tiks",
   "name": "Tiks",
   "why": "Open-source JavaScript library that synthesizes UI sound effects at runtime with the Web Audio API, with no audio files.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Do I need sound files?",
   "a": "No. Each sound is a list of numbers that ZzFX turns into sound while the page runs."
  },
  {
   "q": "How do I make a new sound?",
   "a": "Open the free ZzFX Sound Designer, shape or pick a random sound, and copy its zzfx code into your game."
  },
  {
   "q": "Can I use it in a paid game?",
   "a": "Yes. It is MIT licensed; keep the copyright and license notice with the code."
  },
  {
   "q": "Can I get a WAV file for another engine?",
   "a": "Yes. The designer can save each sound as a .wav file."
  },
  {
   "q": "Does it need other libraries?",
   "a": "No. It runs on its own with no other libraries."
  }
 ],
 "at_a_glance": {
  "latest_version": "1.4.0",
  "last_release": "2024-07-01",
  "last_commit": "2026-11-03",
  "runtime": "A browser with the Web Audio API; the file is an ES module (import), and loading it creates an AudioContext, so import it only in client-side code.",
  "key_needed": false
 },
 "good_to_know": [
  "Sounds are made while the page runs, so there are no sound files to host or download.",
  "Each sound gets a small random change in pitch when played. Set the second number to 0 if you want it exactly the same every time.",
  "The library opens the browser's audio system as soon as it is loaded, so it runs only in a browser, not on a server.",
  "For music rather than single effects, the README points to a separate small player called ZzFXM."
 ],
 "stack_snippets": [],
 "claims": [
  "Less than 1 kilobyte when compressed",
  "20 controllable parameters"
 ],
 "checked": {
  "license_read": "2026-11-07",
  "overview_checked": "2026-11-12",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "github.com/KilledByAPixel/ZzFX",
    "url": "https://github.com/KilledByAPixel/ZzFX"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/LICENSE"
   },
   {
    "label": "github.com/KilledByAPixel/ZzFX/blob/master/ZzFX.js",
    "url": "https://github.com/KilledByAPixel/ZzFX/blob/master/ZzFX.js"
   },
   {
    "label": "npm: zzfx",
    "url": "https://registry.npmjs.org/zzfx"
   },
   {
    "label": "killedbyapixel.github.io/ZzFX",
    "url": "https://killedbyapixel.github.io/ZzFX/"
   },
   {
    "label": "npm: zzfx/latest",
    "url": "https://registry.npmjs.org/zzfx/latest"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/zzfx/",
 "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."
}
