mirror of
https://github.com/anirbanmu/vizl.git
synced 2026-04-19 03:50:06 +00:00
Vizl - SoundCloud® music visualizer via WebGL, WebAudio, Svelte & Typescript.
https://vizl.anirbanmu.com
- TypeScript 66.7%
- Svelte 27.5%
- CSS 3.3%
- Dockerfile 1.4%
- HTML 0.9%
- Other 0.2%
|
|
||
|---|---|---|
| .github/workflows | ||
| packages | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| .prettierignore | ||
| .tool-versions | ||
| Dockerfile | ||
| eslint.config.ts | ||
| fly.toml | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| prettier.config.js | ||
| README.md | ||
vizl
A WebGL 2 based music visualizer.
Tech Stack
- Frontend: Svelte 5, Vite, WebGL 2
- Backend: Hono, Node.js, TypeScript
Prerequisites
- Node.js: v22 or higher
- npm: (packaged with Node.js)
Environment Variables
You need to set up your environment variables for the server. Copy .env.example to .env.local and fill in your SoundCloud credentials.
cp .env.example .env.local
Required variables:
SOUNDCLOUD_CLIENT_IDSOUNDCLOUD_CLIENT_SECRET
Setup
Install dependencies from the root directory:
npm install
Development
Start both the client and server in development mode:
npm run dev
- Client: http://localhost:5173
- Server: http://localhost:8081
Build
Build both packages:
npm run build
Docker
You can also run vizl using Docker.
# Production build
docker build -t vizl .
docker run -p 3000:3000 --env-file .env.local vizl
Notes
Note
This is a complete rewrite. The legacy code is unmaintained and lives in the
legacybranch.