se

shadertoy-export

render ShaderToy demos to PNG

Showing:

Popularity

Downloads/wk

1

GitHub Stars

57

Maintenance

Last Commit

6yrs ago

Contributors

0

Package

Dependencies

21

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

shadertoy-export

stable

A small utility for exporting ShaderToy demos to large (print-ready) PNG images. On my MacBookPro, this can export up to 10,000x10,000 px images.

It only features a small set of shaders (those set to Public + API) and doesn't support cube maps, video inputs, etc.

This tool is experimental and not complete. If you want to help maintain it, let me know.

Some examples:

image

A 2880x1800 wallpaper from this shader.

two

Install

Install the tool globally with npm.

npm install shadertoy-export -g

Command-Line Usage

More docs to follow.

Basic usage, writes the first frame to process.stdout as PNG.

shadertoy-export shader.frag [opts] > image.png

You can use --api or -a to grab from the ShaderToy API, which loads demos that are saved as Public + API. For this, you need to specify a demo ID like XslGRr, or a URL like https://www.shadertoy.com/view/XslGRr. Example:

shadertoy-export XslGRr --api > image.png

You can use --output or -o instead of writing to stdout, and --size to render a different resolution. You can use --wait to wait N milliseconds before rendering a frame.

shadertoy-export XslGRr --api --output output/1.png --size 1080,768 --wait 1500

interactive mode

You can also enter interactive (GUI) mode with the --frame or -f option. This opens a window which accepts mouse input, and you can hit Cmd + S or Ctrl + S at any point to save the image to your output path.

shadertoy-export -f --api --size=512,256 -o images/1.png XslGRr

gui

You can also specify a --scale or -S option to reduce the interactive resolution (does not affect output). For example, --scale=0.5 will draw the scene at half resolution.

License

MIT, see LICENSE.md for details.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial