Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/analogfeelings/shadersave
A screensaver for Windows that can run Shadertoy shaders locally with little to no modification.
https://github.com/analogfeelings/shadersave
agplv3 cpp cpp20 glsl glsl-shaders open-source screensaver screensavers shaders shadertoy shadertoy-compatibility
Last synced: about 1 month ago
JSON representation
A screensaver for Windows that can run Shadertoy shaders locally with little to no modification.
- Host: GitHub
- URL: https://github.com/analogfeelings/shadersave
- Owner: AnalogFeelings
- License: agpl-3.0
- Created: 2024-06-27T23:31:52.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2024-10-07T21:25:37.000Z (about 1 month ago)
- Last Synced: 2024-10-12T16:20:54.467Z (about 1 month ago)
- Topics: agplv3, cpp, cpp20, glsl, glsl-shaders, open-source, screensaver, screensavers, shaders, shadertoy, shadertoy-compatibility
- Language: C++
- Homepage:
- Size: 524 KB
- Stars: 9
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# :rainbow: Shadersave
[](https://github.com/AnalogFeelings/shadersave/issues)
[](https://github.com/AnalogFeelings/shadersave/pulls)
[](https://github.com/AnalogFeelings/shadersave/blob/master/LICENSE.txt)
[](https://github.com/AnalogFeelings/shadersave/graphs/commit-activity)
[](https://github.com/AnalogFeelings/shadersave/stargazers)
[](https://tech.lgbt/@analog_feelings)
Shadersave is a Windows screensaver that can run Shadertoy shaders locally under OpenGL 4.3 core, without using web technologies.
This is done by replicating the uniforms shadertoy provides to shaders, and wrapping each shader in a valid GLSL shader.
You can find more information by reading the source code at [Shader.cpp](https://github.com/AnalogFeelings/Shadersave/blob/master/src/Classes/Shader.cpp).
# :warning: Limitations
- Audio and VR shaders will not be supported.
- Mouse and/or keyboard input wont be supported for obvious reasons.
- Non-image and non-buffer channel inputs won't be supported.
- Cubemap shaders will not be supported.
# :package: Installing
Due to a Windows design flaw, you must place screensavers in **C:\Windows\System32** for them to be recognized by the control panel
applet.
If you don't trust this project to be safe to place in system32, you can read through the code and build it yourself.
The program won't even have permissions to modify files in system32 unless it runs as admin.
> [!WARNING]
> Some shaders make heavy use of your system's GPU and thus can increase power usage significantly.
> Please take your power bill into consideration.
# :hammer_and_wrench: Building
To build this, you will need the following:
- Visual Studio 2022.
- The **Desktop development with C++** workload.
- The **Windows SDK**.
You must also place [GLEW](https://glew.sourceforge.net/) and [stb_image](https://github.com/nothings/stb/blob/master/stb_image.h) under the **"libs"** folder.
# :beetle: Debugging
Debugging screensavers is kind of a hassle, but it can be done.
1. Open a Win32 window, for example Control Panel.
2. Grab its window handle with Spy++ or some other software.
3. Convert the handle from hexadecimal to decimal.
4. Go into **Shadersave -> Properties -> Debugging**.
5. On **Command Arguments**, write **/p (window handle)** and hit **Apply**.
6. You can now debug the screensaver as long as you don't close the window you opened.
> [!TIP]
> **Renderdoc** can be used this way as well, if you want to debug the graphics side.
To debug the configuration dialog, do the following:
1. Do steps 1 to 4 from above.
2. On **Command Arguments**, write **/c:(window handle)** and hit **Apply**.
3. You can now debug the config dialog.
# :camera: Screenshots
[*pow(The Shining, 2.0)*](https://www.shadertoy.com/view/tlyfDV) by **dean_the_coder**
[*isovalues 3*](https://www.shadertoy.com/view/ldfczS) by **FabriceNeyret2**
[*Cook-Torrance*](https://www.shadertoy.com/view/XsXXDB) by **xbe**
[*Splitting DNA*](https://www.shadertoy.com/view/4d2cWd) by **BigWIngs**
