Skip to content

Dev-Akshay-Patel/Lyrics-Player-Visualizer

Repository files navigation

🎵 Simple Lyrics Player + Visualizer + Aesthetic Background

A lightweight, vibe-forward lyrics player with a smooth audio visualizer and immersive backgrounds. Drop in time-stamped lyrics (LRC or plain text with timestamps), choose a background (video / GIF / WEBP / animated image), and enjoy. Double‑click the lyrics to enter full‑screen for peak vibes.


✨ Highlights

  • Time‑stamped lyrics playback (LRC or timestamped text)
  • Backgrounds: video, GIF, WEBP, and animated images supported
  • Visualizer tied to the playing audio
  • Full‑screen lyrics: double‑click the lyrics container
  • No account, no cloud—pure local play
  • Responsive: works on desktop and mobile

⚠️ Sync behavior: This script does not auto‑sync or generate timestamps. It plays your already time‑stamped lyrics.


📸 Screenshots

Default view

image

Full‑screen mode (double‑click the lyrics container)

image

🚀 Quick Start

  1. Open the player in your browser.

  2. Load your audio file (MP3/MP4/M4A/WAV/etc.).

  3. Add lyrics:

    • Preferred: .lrc file
    • Also works: .txt with lines like [mm:ss.xx] lyric line
  4. Pick a background (optional): video, GIF, WEBP, or animated image.

  5. Double‑click lyrics to toggle full‑screen.


🧾 Supported Lyrics Format (Examples)

[00:00.00]
[00:02.50](Oh, oh, oh, oh, oh, oh, oh)
[00:04.70](Oh, oh, oh, oh, oh, oh, oh)
[00:06.95](Oh, oh, oh)
[00:08.70]
[00:08.75]Sa sa sa save me, I don't need you to confess
[00:14.20]Got some feelings in your chest
...

Any standard LRC is fine. Timestamps like [mm:ss] or [mm:ss.xx] are supported.


🎛️ Controls & Tips

  • Space / Click Play: toggle play/pause
  • Double‑click lyrics: full‑screen on/off
  • Seek bar / Scrub: jump to any part of the track
  • Background: choose any supported media for instant ambiance

💡 Performance Notes

  • Rendering quality depends on your device specs and browser.
  • Mid‑tier PCs: close heavy apps for smoother visuals.
  • Mobile devices often handle this smoothly with minimal lag.

🧰 Features at a Glance

  • ✅ Time‑stamped lyric playback
  • ✅ Clean, readable lyric container
  • ✅ Audio‑reactive visualizer
  • ✅ Customizable background aesthetics
  • ✅ Full‑screen mode for immersion
  • ✅ Desktop & mobile support

🧠 Known Limitations

  • ❌ The player cannot create or fix lyric timestamps.
  • ❌ No cloud sync—files run locally in your browser.

📝 FAQ

Q: Can I use plain text lyrics without timestamps? A: Yes, they will display, but won’t auto‑sync without timestamps.

Q: Does it support .lrc with offset tags? A: Standard [mm:ss] and [mm:ss.xx] timestamps work great. Offsets may be ignored depending on implementation.

Q: What media can I use for backgrounds? A: Video (e.g., MP4/WebM), GIF, WEBP, and animated images.


🙌 Credits

Built for music lovers who enjoy visual vibes with their lyrics.


About

A Minimalistic yet simple lyrics player with your fav background for best vibes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published