https://github.com/yawningface/lofi
A simple lofi music player
https://github.com/yawningface/lofi
lofi lofi-music player pomodoro productivity
Last synced: 7 months ago
JSON representation
A simple lofi music player
- Host: GitHub
- URL: https://github.com/yawningface/lofi
- Owner: Yawningface
- Created: 2025-02-26T19:11:48.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T19:21:09.000Z (7 months ago)
- Last Synced: 2025-02-26T20:37:20.445Z (7 months ago)
- Topics: lofi, lofi-music, player, pomodoro, productivity
- Language: JavaScript
- Homepage: https://lofi.yawningface.org/
- Size: 59.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lofi by YawningFace 🎵
**Minimalist, Distraction-Free Lofi Music Player with Pomodoro & Standard Timer**
🌐 **Live Demo:** [Lofi YawningFace](https://lofi.yawningface.org)
🔗 **Website:** [YawningFace](https://yawningface.org)
💻 **GitHub:** [YawningFace on GitHub](https://github.com/Yawningface)
Lofi by YawningFace is a lightweight, ad-free, and distraction-free **website** designed for students, office workers, and anyone who needs a peaceful ambiance for deep focus. Featuring a **lofi music player**, an **optional Pomodoro timer**, and a **built-in standard timer**, it's the perfect tool for productivity, studying, or relaxation.
## ✨ Features
### 🎶 Minimalist Lofi Music Player
- High-quality, uninterrupted lofi hip hop music
- No ads, no cookies, no popups—just music
- Simple and intuitive interface
### ⏳ Built-in Pomodoro Timer (Optional)
- Focus on tasks using the **Pomodoro technique**
- Non-intrusive, silent timer for work sessions
### ⏱️ Standard Timer
- A **basic countdown timer** for general use
- Perfect for tracking sessions that don't fit the Pomodoro method
### 🎨 Clean & Aesthetic UI
- Simple, elegant **dark mode** interface
- One-click start, no sign-ups required
### 🚀 Fast & Lightweight
- No unnecessary bloat, runs smoothly in the background
- Open-source and easy to modify
## 🛠️ Local Installation
Want to self-host or modify the project? Follow these steps:
### First-Time Setup
```sh
npm install
```
### Launch the Project
```sh
npm run dev
```
### Deploy on Vercel
To deploy on Vercel, run:
```sh
vercel --prod
```
_Note: Ensure you have the Vercel CLI installed and are logged in._
## 🤝 Contributing
We welcome contributions! If you’d like to add features or improve the project, feel free to:
- Submit an **issue** for feature requests or bugs
- Create a **pull request** with your improvements
## 📜 License
This project is licensed under the **MIT License**.
---
🚀 **Created by [YawningFace](https://yawningface.org)**
💻 **GitHub:** [YawningFace on GitHub](https://github.com/Yawningface)
🌐 **Live Demo:** [Lofi YawningFace](https://lofi.yawningface.org)