Skip to content

Commit ec89783

Browse files
committed
Initial readme update
1 parent a2d00f7 commit ec89783

1 file changed

Lines changed: 41 additions & 19 deletions

File tree

README.md

Lines changed: 41 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,72 @@
11
# THE — Audio Reactive Visualizer
22

3-
[Live Demo](https://subsussp.github.io/THE)
3+
[![Live Demo](https://img.shields.io/badge/Live%20Demo-Click%20Here-blue?style=for-the-badge&logo=vercel)](https://subsussp.github.io/THE)
44

5-
**THE** is an artwork made by me and it's also a WebGL-powered music visualizer that transforms audio tracks into dynamic. Users can upload their own music, and the site will generate a unique audiovisual display using 3D graphics, shaders, and sound analysis.
5+
**THE** is an artwork made by me ;) and it's also a WebGL-powered music visualizer that transforms audio tracks into dynamic. Users can upload their own music, and the site will generate a unique audiovisual display using 3D graphics, shaders, and sound analysis.
66

77
---
88
## GPU Required
99

1010
This project requires a **dedicated or integrated GPU** to run properly.
1111
If your system does not support **WebGL / WebGPU** or hardware acceleration,
12-
some features may not work, or performance may be severely degraded.
12+
some scenes may not work smoothly, or performance may be severely degraded.
13+
14+
---
15+
16+
# Preview
17+
18+
<p float="left">
19+
<img src="https://github.com/user-attachments/assets/0cecff4c-8b26-4332-a8a3-4e79cf70ff78" width="150" />
20+
<img width="150" alt="Screenshot 2026-02-01 034001" src="https://github.com/user-attachments/assets/32f05639-03d5-490c-b321-69c39eb50fa6" />
21+
<img src="https://github.com/user-attachments/assets/1f014d3e-b490-498e-8bb8-7fe0ecfa77ec" width="150" />
22+
<img src="https://github.com/user-attachments/assets/ebb56fb3-5edb-459d-a901-f09e127956df" width="150" />
23+
<img src="https://github.com/user-attachments/assets/6beaacbb-1840-4378-88fa-6b7164f88dbd" width="150" />
24+
<img src="https://github.com/user-attachments/assets/353bd1f3-722e-4b52-9926-d1e4fc0f9989" width="150" />
25+
</p>
26+
1327

1428
---
1529

1630
## Features
1731

18-
- **Audio Upload** — Upload local audio files (e.g., MP3, WAV)
32+
- **Audio Upload** — Upload local audio files (e.g., MP3, WAV) Or use my audio samples :).
1933
- **Real-Time Audio Analysis** — Uses Web Audio API to extract frequency & amplitude data
2034
- **3D Visual Effects** — Built with Three.js, custom shaders, and particle systems
2135
- **Customizable Scenes** — Visuals react to beat, bass, treble, and volume
2236
- **Optimized Performance** — Smooth animation loop with efficient rendering
2337
- **Future Plans** — MIDI input, preset scenes, user controls, and mobile support
2438

2539
---
26-
27-
## Tech Stack
28-
29-
| Tool | Description |
30-
|------|-------------|
31-
| <img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/javascript/javascript-original.svg" alt="JavaScript" width="24"/> **JavaScript** | Main frontend language |
32-
| <img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/html5/html5-original.svg" alt="HTML5" width="24"/> **HTML5** | Markup & UI |
33-
| <img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/css3/css3-original.svg" alt="CSS3" width="24"/> **CSS3** | Styling and layout |
34-
| <img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/threejs/threejs-original.svg" alt="Three.js" width="24"/> **Three.js** | 3D graphics & rendering |
35-
| **Web Audio API** | Audio frequency & waveform analysis |
36-
| **TSL (Three Shader Language)** | Shader logic for particle dynamics |
37-
| **GLSL** | Custom fragment & vertex shaders |
38-
39-
---
40-
40+
## <img src="https://em-content.zobj.net/thumbs/240/apple/354/hammer-and-wrench_1f6e0-fe0f.png" width="20"/> Technologies Used
41+
42+
<p align="center">
43+
<img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/javascript/javascript-original.svg" alt="JavaScript" width="60" height="60"/>
44+
<img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/html5/html5-original.svg" alt="HTML5" width="60" height="60"/>
45+
<img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/css3/css3-original.svg" alt="CSS3" width="60" height="60"/>
46+
<img
47+
src="https://raw.githubusercontent.com/mrdoob/three.js/9796ddd982480f662a73e5f16fff4c7e6f240ee1/files/icon.svg"
48+
alt="Three.js"
49+
width="55"
50+
height="55"
51+
style="background-color:white; padding:2px;"
52+
/>
53+
<img src="https://static.cdnlogo.com/logos/g/31/gsap-greensock.svg" alt="GSAP" width="60" height="60" />
54+
55+
- [**Javascript**](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
56+
- [**Three.js**
57+
](https://github.com/mrdoob/three.js/) JavaScript 3D library.
58+
- [**GSAP**](https://github.com/greensock/gsap) (GreenSock Animation Platform), a JavaScript animation library for the modern web.
59+
- [**GLSL**](https://learnopengl.com/Getting-started/Shaders) (OpenGL Shading Language) is a high-level, C-style programming language used to create custom shaders that execute directly on the GPU.
60+
</p>
4161

4262
## Credits
4363

4464
Thanks to [three.js WebGPU attractors example](https://github.com/mrdoob/three.js/blob/master/examples/webgpu_tsl_compute_attractors_particles.html) by [@mrdoob](https://github.com/mrdoob) I was able to create the great particles scene I integrated my own audio interactivity to the particles :).
4565

4666
and also for [threejs-graces](https://github.com/ektogamat/threejs-graces) because that's where i got my inspiration from and kinda mimiced his mouse interactivity
4767

68+
also thanks to [Oscilloscope Visualizer](https://github.com/TimArt/3DAudioVisualizers) because i learnt how to do the oscilloscope shader from him
69+
4870
---
4971

5072
## LICENSE

0 commit comments

Comments
 (0)