musicSlip / README.md
MattSymetry's picture
Upload 11 files
552b5b3 verified
|
Raw History Blame Contribute Delete
1.82 kB
---
title: specimg
emoji: πŸŽ™οΈ
colorFrom: indigo
colorTo: purple
sdk: static
pinned: false
---
# specimg (static)
Fully **client-side**: audio β†’ analog-waveform slip, and slips back to sound,
all in the browser. No server, no backend β€” just static files. Everything runs
on-device; nothing is uploaded.
```
index.html the "create" page (served at /)
static/ app.js, style.css, and the loopscan / scanner / player pages
```
## Deploy (all free, all give HTTPS)
### Hugging Face Space β€” Static
1. New **Space** β†’ SDK: **Static** β†’ Blank.
2. Upload this whole folder (the *Files* tab drag-and-drop, or `git push`). The
YAML header at the top of this README configures it.
3. It serves at `https://<you>-<space>.static.hf.space` with HTTPS β€” so the
camera `/scanner` page works.
### Or any other static host
- **Netlify:** drag the folder onto <https://app.netlify.com/drop>.
- **Cloudflare Pages / GitHub Pages / Vercel (static):** upload or connect the repo.
- **Local preview:** `python3 -m http.server` then open <http://localhost:8000>.
## Pages
- **`/`** β€” create: upload a song, pick a quality (standard / max-digital /
thermal), and download the waveform slip. Rendered in-browser.
- **`/static/loopscan.html`** β€” upload a slip image and loop-scroll it back to audio.
- **`/static/player.html`** β€” scroll a slip full-screen (e.g. to film it).
- **`/static/scanner.html`** β€” read a slip with the device **camera** β†’ audio
(needs HTTPS, which every host above provides).
## Notes
- Audio formats: **wav / flac / ogg / mp3 / m4a / aac** all work β€” the browser's
own decoder handles them (no server, no ffmpeg needed).
- The slip generator is pure JavaScript on a `<canvas>`; very long tracks make a
very tall image, so stick to songs (a few minutes).