# spaceporn

Wiki and Generator for space contemplators

## Generator

- The **spaceporn generator** is in early stage development and is not ready to be used.

- The **spaceporn generator** is a tool which could:
  - display animated or static procedural pixelized space content,
  - generate procedural pixelized space pictures.

### Usage

- The maintainers will update this section later

### Dependencies

- Before installing and building the **spaceporn generator**, you need to install this:
  - [Zig 0.13.0](https://ziglang.org/download/#release-0.13.0),

### Installing

- The maintainers will update this section later.

### Supported environments

OS | Building | Running
--- | --- | ---
Ubuntu 22.04 | :white_check_mark: | :white_check_mark:
Windows 2022 | :white_check_mark: | :grey_question:

- :white_check_mark: : Functional
- :grey_question: : Currently untested

## [Wiki](https://github.com/tiawl/spaceporn/blob/trunk/wiki/README.md)

The **spaceporn wiki** is a list of GLSL tutorials and online shaders about procedural pixelized space shaders.
More details [here](https://github.com/tiawl/spaceporn/blob/trunk/wiki/README.md)

## Contributing

Each component of this repository has its own contributing rules:
- [The generator contributing rules](https://github.com/tiawl/spaceporn/blob/trunk/CONTRIBUTING.md)
- [The wiki contributing rules](https://github.com/tiawl/spaceporn/blob/trunk/wiki/CONTRIBUTING.md)

## License

This project is licensed under the [MIT License](LICENSE.md).

## Credit

Thanks to all the [contributors](https://github.com/tiawl/spaceporn/contributors) who help move the project forward.

Without each one of these links and their authors, this project will never exist:
- [Github - Deep-Fold's PixelSpace][1] and [Github - Deep-Fold's PixelPlanets][2]
- [Slynyrd's blog][3]
- [Inigo Quilez's articles][4]
- [FabriceNeyret2's shaders][5] and [shadertoyunofficial website][6]
- [Ek_Vitki's star tutorial][7], [Ek_Vitki's nebula tutorial][8] and [Ek_Vitki's celestial bodies tutorial][9]
- A lot of shared Shadertoy shaders:
  - [Shadertoy - CBS' Simplicity Galaxy shader][10]
  - [nimitz's Noise animation - Electric shader][11]
  - [Shadertoy - vegardno's Pixel planet shader][12]
  - [Shadertoy - viclw17's Jupiter shader][13]
- A lot of related Github projects:
  - [lord-123's xshader][14]
  - [mmhobi7's xwinwrap][15]
  - [KEKE046's xjuliabg][16]
  - [Theldus' anipaper][17]
  - [zaranthus' Livepaper][18]
  - [zkburke's quanta][20]
- [Daniel Linssen's planetarium][19]

[1]:https://github.com/Deep-Fold/PixelSpace
[2]:https://github.com/Deep-Fold/PixelPlanets
[3]:https://www.slynyrd.com/blog
[4]:https://iquilezles.org/www/index.htm
[5]:https://www.shadertoy.com/user/FabriceNeyret2
[6]:https://shadertoyunofficial.wordpress.com/
[7]:https://www.reddit.com/r/PixelArt/comments/s3gybx/star_tutorial/
[8]:https://www.reddit.com/r/PixelArt/comments/s4y4nx/nebula_tutorial/
[9]:https://www.reddit.com/r/PixelArt/comments/s3wr11/another_quick_tutorial_for_some_other_celestial/
[10]:https://www.shadertoy.com/view/MslGWN
[11]:https://www.shadertoy.com/view/ldlXRS
[12]:https://www.shadertoy.com/view/WdSSWD
[13]:https://www.shadertoy.com/view/MdyfWw
[14]:https://github.com/lord-123/xshader
[15]:https://github.com/mmhobi7/xwinwrap
[16]:https://github.com/KEKE046/xjuliabg
[17]:https://github.com/Theldus/anipaper
[18]:https://github.com/zuranthus/LivePaper
[19]:https://managore.itch.io/planetarium
[20]:https://github.com/zkburke/quanta
