shadertoy-export

    0.0.1 • Public • Published

    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.

    Install

    npm i shadertoy-export

    DownloadsWeekly Downloads

    1

    Version

    0.0.1

    License

    MIT

    Last publish

    Collaborators

    • mattdesl