Skip to content

bentatum/tenk

Repository files navigation

Statements Branches Functions Lines

tenk

Generative art projects made simple.

Setup

tenk cli uses node-canvas to render pngs. If you encounter errors upon installation, check if you have the required packages. https://github.com/Automattic/node-canvas#installation.

Get Started

Create a directory with a folder called layers. Each layer needs to be a folder with image files. cd to your project folder in your terminal and type npx tenk. Images are rendered to the .tenk folder next to layers.

Layer Ordering

Since layers are stacked in alphabetical order, you can control the order in which they appear by prefixing them with a number and an underscore. If tenk sees a number with an underscore as the first characters in your layer's directory name, it will remove it for you in the generated metadata.

layers/
  01_Background
  02_Body
  03_Eyes
  04_Hair

Rarity

Layers have a property called odds that determines the likelyhood that it will be rendered or not. A lower number means rare, a higher number means common. You can define a layer's odds of appearing by appending a #{percent value} to the end of your file. If nothing is defined, it will always render.

For example, in the following directory structure Hair will appear 85% of the time and Jewlery will only appear 10% of the time.

layers/
  01_Background
  02_Body
  03_Eyes
  04_Hair#85
  05_Jewlery#10

About

A framework for 10k pfp art projects

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published