Skip to content

ArthurTent/ShaderAmp

Repository files navigation

ShaderAmp

is a free browser plugin for visualizing music on any website. It works with YouTube, Spotify, Soundcloud and so on.

It started as a proof of concept project but with the help of Philipp and Eamon, we were able to create a reactified version of the original project.

Note: We are not related to shadertoy.com and we're not the original authors of the shaders. We simply adapted them to run with THREE.js and made some of them more aware of the music input. (The authors of the shaders might say that we've screwd them up 😅)

Example Visualization

Example on YouTube

Installation

If you don't know how to install an unpacked browser extension then you might find this link usefull

After installation, you will find a new extension icon which you can click to open ShaderAmp.

The latest version is now available on Chrome Web Store!

Usage hints

  • Use it at your own risk. We are not responsible for any damage to your hardware or data in the event of a browser crash.

  • Some shaders require a powerful GPU in order to run smooth. If you don't have a powerful GPU, then you shouldn't run the extension in fullscreen. We recommend a 720p or max. 1080p resolution for fullscreen.

  • If you have multiple graphics cards, Windows/Linux/macOS always starts the browser by default on the integrated graphics card. We recommend configuring the browser to always render with the dedicated graphics card in the operating system settings.

Keys

Use 'alt' + L to open ShaderAmp

Use 'alt' + O to open ShaderAmp options

Development

Prerequisites

  • npm
  • node

Installing ShaderAmp dependencies

npm install

Compiling ShaderAmp

npm run build

Running the ShaderAmp in dev mode

npm run dev

Shader Credits

You will find the original shader authors in the shaders and in the dist/shaders/README.md file.

How to change ShaderAmp Shortcuts

ShaderAmp binds per default the following shortcuts:

  • ALT + L: Open ShaderAmp
  • ALT + O: Open ShaderAmp Options
  • ALT + K: Activate the extension

If you want to change these shortcuts you can do so by opening

chrome://extensions/shortcuts

in your browser and change the shortcuts for ShaderAmp.

Need help or got questions?

Join our Discord: https://discord.gg/yWdddj9Z5V

Like what you get?

Give this project a ⭐ and consider becoming a ShaderToy Patreon

Thanks

  • Philipp and Eamon for the help with the reactification of the PoC project
  • react-three/fiber for the easy to use react-three-fiber library
  • Ricardo Cabello aka mrdoob for creating the amazing three.js library and glsl-sandbox platform
  • Inigo Quilez and Pol Jeremias for creating the amazing shadertoy platform
  • The shadertoy community
  • To the original authors of the shaders <3
  • To the creators of the two default videos included in the project
  • @nyancat (X/Twitter) for the permission to use NyanCat in the project (www.nyan.cat)
  • DemoScene for many years of visual inspiration
  • Nullsoft for creating Winamp
  • And last but not least to MilkDrop for the first visualizer that really whipped the llama's ass.

License

This project is licensed under the MIT License - see the LICENSE file for details. However, the shaders are licensed under different licenses. Most of them are licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Some are using Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License or MIT License. You can find more information about the license in the shaders folder. Each Shader file has a link to the original shader and the license. DO NOT REMOVE THIS INFORMATION.

ShaderAmp All your BASS are belong to us!