GitHunt
VI

ViratiAkiraNandhanReddy/404-blurglass-max

A modern, immersive 404 error page built with a clean glassmorphism interface, dynamic background switching, and an interactive music player that supports track previews, navigation, and smooth UI transitions. Designed for developers who want a stylish, functional, and customizable not-found page for static websites and portfolios.

GitHub Pages Repo Size Visits Issues AWFUL - Passively Maintained Stars

404-blurglass-max

Advanced glassmorphism 404 page with music player and background switching.


๐Ÿ“Ž Why 404-blurglass-max?

A modern, responsive, glassmorphism-themed 404 error page featuring:

  • ๐ŸŽต Interactive hover-expand music widget (with track navigation & autoplay)
  • ๐Ÿ–ผ๏ธ Background image switcher
  • ๐ŸงŠ Smooth glassmorphism UI
  • ๐Ÿ“ฑ Fully responsive layout
  • ๐ŸŽจ Pixel-perfect typography
  • ๐Ÿชช Built-in music license link
  • ๐Ÿ’ก Logo header & return button

This project is designed for static websites (GitHub Pages, Netlify, Vercel, etc.) and supports customizable assets, tracks, and background images.


๐Ÿ“ธ Preview

Desktop View

Desktop

Mobile View

Mobile


โœจ Features

1. Glassmorphism Interface

  • Full-screen frosted glass effect
  • Blur + saturation for premium UI
  • Smooth transitions & minimalistic layout

2. Music Widget

  • Appears as a compact icon

  • Expands on hover

  • Shows:

    • Current track name
    • Previous / Next buttons
    • Play / Pause toggle
  • Audio starts from a random track

  • Multi-track playlist support

  • Autoplay next track on end

  • Fully muted by default (user gesture required)

3. Background Switcher

  • Hover-expand wallpaper control
  • Next / Previous background
  • Starts with a random background
  • Full-screen cover images
  • Smooth transitions

4. Responsive Typography

  • Dynamic vh and vmin units
  • Adapts perfectly to desktop & mobile

5. High-Quality Structure

  • Clean separation of:

    • HTML
    • CSS
    • JavaScript
    • Assets (images + audios)
  • Best suited for GitHub Pages hosting


๐Ÿ“ Project Structure

404-blurglass-max/
โ”‚
โ”œโ”€โ”€ index.html
โ”‚
โ”œโ”€โ”€ not-found/
โ”‚   โ”œโ”€โ”€ css/
โ”‚   โ”‚   โ””โ”€โ”€ 404.styles.css
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ javascript/
โ”‚   โ”‚   โ””โ”€โ”€ 404.script.js
โ”‚   โ”‚
โ”‚   โ””โ”€โ”€ assets/
โ”‚       โ”œโ”€โ”€ audios/
โ”‚       โ”‚   โ”œโ”€โ”€ Ed Sheeran - Shape of You.mp3
โ”‚       โ”‚   โ”œโ”€โ”€ Bebe Rexha - I Got You.mp3
โ”‚       โ”‚   โ””โ”€โ”€ ...
โ”‚       โ”‚
โ”‚       โ””โ”€โ”€ images/
โ”‚           โ”œโ”€โ”€ bg-01.jpg
โ”‚           โ”œโ”€โ”€ bg-02.jpg
โ”‚           โ””โ”€โ”€ bg-03.jpg
โ”‚
โ”œโ”€โ”€ preview/
โ”‚   โ”œโ”€โ”€ desktop.png
โ”‚   โ””โ”€โ”€ mobile - (iPhone 14 Pro Max).png
โ”‚
โ”œโ”€โ”€ favicon.ico
โ”œโ”€โ”€ LICENSE
โ””โ”€โ”€ README.md

๐Ÿš€ Live Demo

/404-blurglass-max/


๐Ÿ› ๏ธ Installation & Setup

1. Clone the Repository

git clone https://github.com/ViratiAkiraNandhanReddy/404-blurglass-max.git

2. Place Assets

  • Put your background images inside:
    not-found/assets/images/
  • Put your audio tracks inside:
    not-found/assets/audios/

3. Add the 404 Page to GitHub Pages

Rename the file:

index.html โ†’ 404.html

Then push to your GitHub Pages repo.

GitHub Pages automatically uses 404.html for missing pages.


๐Ÿงฉ Customization

๐Ÿ”น Change Tracks

Edit 404.script.js:

const tracks = [
  { name: "Song Name", file: "not-found/assets/audios/song.mp3" }
];

๐Ÿ”น Add More Backgrounds

const backgrounds = [
  "not-found/assets/images/bg-01.jpg",
  "not-found/assets/images/bg-02.jpg",
  "not-found/assets/images/bg-03.jpg",
  "not-found/assets/images/your-new-bg.jpg"
];

๐Ÿ”น Logo & Branding

Modify in index.html:

<img src="favicon.ico" alt="Your Name">
<span class="name">YOUR NAME</span>

๐ŸŽง Music Licensing

All music tracks used belong to their respective owners.
This project uses tracks under fair use for a non-profitable personal portfolio.

A dedicated Music License page is linked at the bottom-right of the 404 screen.

Music License: /license/


๐Ÿค Contributing

Pull requests are welcome!

To contribute:

  1. Fork the repository
  2. Create a new branch
  3. Add your changes
  4. Open a PR

โญ Support

If you like this project, consider giving it a star โญ on GitHub โ€” it helps a lot.


LinkedIn
X
Instagram
Facebook
Gist
YouTube
Website
Mail


๐Ÿ“ License

ยฉ 2025 ViratiAkiraNandhanReddy. This project is licensed under the MIT License.


๐Ÿ‘ค Author

Developed by ViratiAkiraNandhanReddy

๐Ÿ’ค - PASSIVE MAINTENANCE : Mean the project is no longer actively developed ( NO New Features And Regular Updates ), but the maintainer will respond only when an issue or PR is raised. Feel free to fork and continue development!


๐ŸŒŸ Questions, suggestions, or want to contribute? Open an issue or pull request on GitHub! ๐ŸŒŸ