Visit q5js.org! 💫

• inspired by p5.js and Processing ⭐️
• performance optimized for interactive art 🚀
• lightning fast WebGPU renderer ⚡️
• beginner friendly documentation 📚
• compatible with popular addons, including p5.sound, ml5.js, and p5play 🎮
• no dependencies, ~140kb minified 📦
• free to use under the LGPL 🆓

q5 was designed to make creative coding fun and accessible for educators, artists, designers, and beginners. 🤝

Familiar with p5? You'll be right at home with q5. It's like getting a free computer upgrade! 🖥️

await Canvas(200);
circle(0, 0, 80);

Documentation

Browse the q5 reference pages to learn how to use q5.js.

See the wiki for extended documentation.

Use the q5.d.ts file in Visual Studio Code to get autocompletion and inline hover-over documentation. Simply add this jsconfig.json file to your project folder:

{
	"compilerOptions": {
		"target": "ESNext"
	},
	"typeAcquisition": {
		"include": ["node_modules/q5"]
	}
}

Support q5 💙

q5 is open source and anyone can use it for free under the terms of the LGPL. 🎉

We need your support though! If you enjoy using q5, please donate via GitHub Sponsors, ko-fi, or Patreon.

Contributing

Are you interested in writing code for q5.js or improving the q5 ecosystem? Contributions are welcome!

Please report issues or comment on existing issues before working on a pull request. Check out the q5 project planning board.

All contributors must agree to the code of conduct.

Licensing

q5.js was created by Quinton Ashley and contributors. It is open source licensed under the LGPLv3.

@LingDong- created the original q5xjs library which is Unlicense (public domain) licensed.

p5.js is licensed under the LGPLv2, small sections of p5' code directly copied into q5 are credited below. The rest of q5 is a new implementation of part of the p5 API. APIs are not copyrightable in the United States, as decided by the Supreme Court in the Google v Oracle case. q5 is not affiliated with The Processing Foundation.

Credits

This project aims to continue the legacy of the incredible work done by Ben Fry and Casey Reas on Java Processing, Lauren McCarthy's work on p5.js, and all contributors to these projects.

Code Excerpt Sources

WebGPU MSDF text rendering: https://webgpu.github.io/webgpu-samples/?sample=textRenderingMsdf

WebGPU blendMode: https://webgpufundamentals.org/webgpu/lessons/webgpu-transparency.html

HSLtoRGB: https://stackoverflow.com/a/64090995/3792062

HSBtoHSL: https://stackoverflow.com/a/66469632/3792062

OKLCHtoRGB: https://gist.github.com/dkaraush/65d19d61396f5f3cd8ba7d1b4b3c9432 https://github.com/color-js/color.js/blob/main/src/spaces/oklch.js

A JS Implementation of Ziggurat Algorithm: http://ziggurat.glitch.me/

p5.js Vector.slerp: https://github.com/processing/p5.js/blob/v1.10.0/src/math/p5.Vector.js#L2803

p5.js random: https://github.com/processing/p5.js/blob/1.1.9/src/math/noise.js