Skip to content

nannou-org/nannou

Repository files navigation

nannou Actions Status Backers on Open Collective Sponsors on Open Collective

nannou_logo

An open-source creative-coding toolkit for Rust.

nannou is a collection of code aimed at making it easy for artists to express themselves with simple, fast, reliable, portable code. Whether working on a 12-month installation or a 5 minute sketch, this framework aims to give artists easy access to the tools they need.

The project was started out of a desire for a creative coding framework inspired by Processing, OpenFrameworks and Cinder, but for Rust. Named after this.

1 2 3

A Quick Note

It is still early days and there is a lot of work to be done. Feel free to help out!

The Guide

Examples

The following collection of examples are a great way to get familiar with nannou.

Directory Description
examples/ A collection of examples demonstrating how to use nannou!
generative_design/ Examples from Generative Gestaltung, ported from p5.js to nannou.
nature_of_code/ Examples from Nature of Code, ported from Processing to nannou.

If you spot an example that interests you, you may run it with the following:

cargo run --release --example <example_name>

where <example_name> is the example's file name without the .rs. Note that the first run might take a while in order to build nannou first, but consecutive runs should be much quicker.

Libraries

The following nannou libraries are included within this repository.

Library Links Description
nannou Crates.io docs.rs App, sketching, graphics, windowing and UI.
nannou_audio Crates.io docs.rs Audio hosts, devices and streams.
nannou_core Crates.io docs.rs Just-the-core for headless, embedded and libraries.
nannou_egui Crates.io docs.rs For creating egui UIs in nannou apps.
nannou_isf Crates.io docs.rs An Interactive Shader Format pipeline.
nannou_laser Crates.io docs.rs LASER devices, streams and path optimisation.
nannou_mesh Crates.io docs.rs API for composing meshes from channels.
nannou_osc Crates.io docs.rs Simple OSC sender and receiver.
nannou_wgpu Crates.io docs.rs WGPU helpers and extensions.

Tools

A couple of tools are also included, though there some issues we would like to address before we can recommend using them just yet!

Tool Links Description
nannou_new Crates.io A nannou project generator.
nannou_package Crates.io For packaging nannou apps for distribution.

Links