Skip to content

Ambika005/Lofi-Horizon

Repository files navigation

🎵 Lofi Horizon

A beautiful Chrome extension for lofi music lovers with over 10+ beautiful scenes and tracks to choose from. Relax, focus, and vibe with curated lofi tracks and stunning animated scenes. Now featuring Cloudinary-powered media streaming for optimal performance.

Lofi Horizon Chrome Extension License

✨ Features

🎧 Curated Lofi Tracks

  • Over 10+ Premium Tracks: Hand-picked lofi beats perfect for studying, working, or relaxing
  • Cloudinary-Powered Streaming: Fast, reliable audio delivery with optimized cloud storage
  • Autoplay: Seamlessly transitions to the next track when one ends
  • Loop Mode: Repeat your favorite track endlessly with the elegant loop button
  • Background Playback: Music continues playing even when you close the popup

🎬 Stunning Animated Scenes

  • Over 10+ Beautiful Scenes: Carefully selected lofi-inspired video backgrounds
  • Cloud-Hosted Videos: Smooth playback powered by Cloudinary CDN
  • Synchronized Experience: Music and visuals create the perfect ambient atmosphere
  • Smooth Transitions: Elegant scene switching with no interruptions

🎨 Premium Design

  • Glassmorphic UI: Modern, translucent design with soft blur effects
  • Minimalist Aesthetic: Warm beige and pink color palette inspired by lofi art
  • Smooth Animations: Micro-interactions and hover effects for a premium feel
  • Compact Interface: Optimized to show 3 tracks at once for easy browsing

🎛️ Intuitive Controls

  • Simple Playback: Play, pause, and seek with elegant controls
  • Progress Tracking: Visual progress bar with time display
  • Quick Selection: Browse and switch tracks/scenes instantly
  • Persistent State: Remembers your last selection and loop preference

🚀 Installation

From Chrome Web Store

Coming soon!

Manual Installation (Developer Mode)

  1. Clone the repository

    git clone https://github.com/yourusername/lofi-horizon.git
    cd lofi-horizon
  2. Open Chrome Extensions

    • Navigate to chrome://extensions/
    • Enable Developer mode (toggle in top-right corner)
  3. Load the extension

    • Click Load unpacked
    • Select the Lofi-Horizon folder
    • The extension icon will appear in your toolbar
  4. Start vibing! 🎵

    • Click the Lofi Horizon icon
    • Select your favorite track and scene
    • Hit play and enjoy

📖 Usage Guide

Getting Started

  1. First Launch: The extension opens with "Ambient Dreams" track and "Wistful Moments" scene pre-selected
  2. Click Play: Music won't auto-start - you're in control
  3. Browse Content: Click the menu button (⋮⋮⋮) to explore all tracks and scenes

Browsing Tracks & Scenes

  • Tracks Tab: Browse 21 lofi tracks with compact, streamlined cards
  • Scenes Tab: Explore 22 beautiful animated backgrounds with video previews
  • Loop Button: Toggle loop mode (🔁) to repeat the current track
  • Selection: Click any track or scene to select it (won't auto-redirect)

Playback Controls

  • Play/Pause: Central button with pulsing animation
  • Progress Bar: Drag to seek, displays current time and total duration
  • Menu Button: Access track/scene selection page
  • Loop Button: Enable/disable loop mode (in selection page)

Loop Mode

  • Disabled (default): Automatically plays the next track when one ends
  • Enabled: Repeats the current track continuously
  • Visual Feedback: Button glows with warm beige when active

🎨 Design Philosophy

Lofi Horizon embraces the aesthetic principles of lofi culture:

  • Nostalgia: Warm beige tones evoke vintage vinyl and analog equipment
  • Minimalism: Clean, uncluttered interface for distraction-free listening
  • Softness: Gentle glows, subtle shadows, and 85% opacity for a dreamy feel
  • Harmony: Carefully curated color palette inspired by lofi album art

🛠️ Tech Stack

  • HTML5: Semantic structure
  • CSS3: Glassmorphism, animations, responsive design
  • Vanilla JavaScript: No frameworks, pure performance
  • Chrome Extension APIs: Background scripts, storage, messaging
  • Cloudinary: Cloud-based media storage and delivery for audio and video
  • SVG Icons: Scalable, theme-aware graphics

📁 Project Structure

Lofi-Horizon/
├── manifest.json           # Extension configuration
├── popup.html             # Main UI structure
├── popup.js               # UI logic and controls
├── offscreen.html         # Offscreen audio player
├── offscreen.js           # Audio playback logic
├── styles.css             # All styling and animations
├── icons/                 # Extension icons
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md             # You are here!

Note: Audio and video files are hosted on Cloudinary for optimized delivery

🎵 Track List

  1. Ambient Dreams
  2. Clouds Passing By
  3. Glass Window Tears
  4. Petals in the Wind
  5. December Embers
  6. Cozy Evening
  7. Study Session Echoes
  8. Café Corner
  9. Faded Polaroids
  10. Dusty Grooves
  11. Cat Café Lounge
  12. Chill Study Beat
  13. Laundromat Dreams
  14. Endgame Theory
  15. Fading Neon Lights
  16. Backyard Memories
  17. Focus Flow
  18. London Streets
  19. Seaside Café
  20. Velvet Sky Dreams
  21. Background Hum

🎬 Scene List

  1. Stargazing Whiskers
  2. Dawn Vigil
  3. Warm Whisker Glow
  4. Sunday Afternoon Purr
  5. Dozing in the Dark
  6. Hearthside Solace
  7. Ticket to Nowhere
  8. City Light Watcher
  9. Quiet Company
  10. Bedroom Serenade
  11. Loyal Afternoon
  12. Unfinished Deadlines
  13. Rain-Soaked Steps
  14. Tomorrow's Plans
  15. Puddle Party
  16. Storm Lullaby
  17. Paws & Daydreams
  18. Cloud Gazing Companion
  19. Feline Reverie
  20. Treehouse Twilight
  21. Wistful Moments (default)
  22. Retro Rails Companion

🤝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Ideas for Contributions

  • Add more lofi tracks and scenes
  • Implement playlist functionality
  • Add shuffle mode
  • Create keyboard shortcuts
  • Improve accessibility
  • Add dark/light theme toggle

🐛 Bug Reports

Found a bug? Please open an issue with:

  • Clear description of the problem
  • Steps to reproduce
  • Expected vs actual behavior
  • Screenshots (if applicable)
  • Browser version

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Music: All lofi tracks are royalty-free or properly licensed
  • Videos: Animated scenes from various lofi artists and creators
  • Inspiration: The global lofi hip-hop community
  • Design: Inspired by lofi album art and aesthetic principles

💖 Support

If you enjoy Lofi Horizon:

  • ⭐ Star this repository
  • 🐦 Share it with friends
  • 💬 Leave feedback
  • 🎵 Keep vibing!

Made with 💖 for lofi lovers everywhere

Relax. Focus. Vibe.

Report Bug · Request Feature

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors