Skip to content

Latest commit

Β 

History

52 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐱 MeowLOCK

Image

A retro-futuristic focus workspace that makes productivity feel like an aesthetic experience.


AI Powered React 19 TypeScript Web Audio Zero Tracking


Pomodoro timer. Ambient soundscapes. AI study assistant. iPod music player. Virtual cat companion. News feed. Google Calendar sync.

All in one glassmorphic desktop that makes you want to focus.




🌌 What is this?

MeowLOCK (codename: Flocus) is a fully customizable cognitive workspace that combines:

  • A retro OS desktop with draggable glassmorphic windows
  • Procedurally generated ambient sounds (rain, fire, cafe, forest β€” zero bandwidth)
  • An iPod Classic simulator with real click-wheel navigation
  • A Gemini AI assistant for notes, flashcards, and study help
  • A virtual cat that roams your workspace and reacts to your clicks
  • Generative AI wallpapers β€” describe a mood, get a 4K backdrop
  • News aggregator and Google Calendar integration
  • Weather widget and SpaceX launch tracker

It's what happens when you combine lofi hip hop radio with a Linux rice and an AI tutor.


✨ Feature Map

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                     MeowLOCK WORKSPACE                              β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                                                                     β”‚
β”‚  πŸ–₯️ RETRO OS INTERFACE                                              β”‚
β”‚  β”œβ”€β”€ Glassmorphic draggable windows (Tasks.exe, Notepad.exe...)    β”‚
β”‚  β”œβ”€β”€ Dynamic blur & overlay controls                                β”‚
β”‚  β”œβ”€β”€ Hot-swappable profiles (Study / Coding / Relax)               β”‚
β”‚  └── Custom layout builder                                          β”‚
β”‚                                                                     β”‚
β”‚  🎡 SYNTHESIZED AUDIO MIXER (0% bandwidth)                          β”‚
β”‚  β”œβ”€β”€ 🌧️ Rainstorms (procedural noise synthesis)                     β”‚
β”‚  β”œβ”€β”€ πŸ”₯ Crackling fire (oscillator-based)                           β”‚
β”‚  β”œβ”€β”€ β˜• Cafe chatter (generated, not sampled)                       β”‚
β”‚  β”œβ”€β”€ πŸƒ Forest whispers                                             β”‚
β”‚  β”œβ”€β”€ 🌫️ White / Pink / Brown noise                                  β”‚
β”‚  └── πŸ”” Tibetan bowl chimes (harmonic synthesis)                    β”‚
β”‚                                                                     β”‚
β”‚  🎢 iPOD CLASSIC & NANO PLAYER                                      β”‚
β”‚  β”œβ”€β”€ Functional click-wheel simulator                               β”‚
β”‚  β”œβ”€β”€ Lofi / Ambient / Classical presets                             β”‚
β”‚  β”œβ”€β”€ Live Radio Paradise & SomaFM streams                          β”‚
β”‚  └── Internet Archive concert search + YouTube playback             β”‚
β”‚                                                                     β”‚
β”‚  🐱 VIRTUAL CAT COMPANION                                           β”‚
β”‚  β”œβ”€β”€ Physics-based movement & dragging                              β”‚
β”‚  β”œβ”€β”€ Mood reactions & contextual responses                          β”‚
β”‚  β”œβ”€β”€ Sits on your active workspace cards                            β”‚
β”‚  └── Click-to-pet with dynamic text feedback                        β”‚
β”‚                                                                     β”‚
β”‚  🧠 GEMINI AI HUB                                                   β”‚
β”‚  β”œβ”€β”€ Search-grounded study advice (with citations)                  β”‚
β”‚  β”œβ”€β”€ AI notes assistant (summarize, expand, flashcards)             β”‚
β”‚  └── Generative wallpapers (describe mood β†’ 4K image)              β”‚
β”‚                                                                     β”‚
β”‚  πŸ“° NEWS & CALENDAR                                                 β”‚
β”‚  β”œβ”€β”€ News aggregator with curated feeds                             β”‚
β”‚  β”œβ”€β”€ Google Calendar sync                                           β”‚
β”‚  β”œβ”€β”€ Persian/Jalaali calendar support                               β”‚
β”‚  └── Occasions & holidays tracker                                   β”‚
β”‚                                                                     β”‚
β”‚  πŸ“Š ANALYTICS & TRACKING                                            β”‚
β”‚  β”œβ”€β”€ Focus session statistics & streak tracking                     β”‚
β”‚  β”œβ”€β”€ SVG trend charts (Recharts)                                    β”‚
β”‚  β”œβ”€β”€ Pomodoro / Stopwatch / Custom timers                           β”‚
β”‚  β”œβ”€β”€ Weather widget                                                 β”‚
β”‚  └── SpaceX launch dashboard                                        β”‚
β”‚                                                                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🎧 The Audio Engine

Most focus apps ship 50MB of audio files. MeowLOCK ships zero.

Every sound is synthesized in real-time using the Web Audio API β€” oscillators, noise buffers, biquad filters, and dynamics compressors. The result? Infinite, non-looping ambient soundscapes that never repeat and never buffer.

// This is how rain sounds are made here:
// Not: <audio src="rain.mp3">
// But: BrownianNoise β†’ BiquadFilter β†’ DynamicsCompressor β†’ GainNode β†’ πŸ”Š

πŸ› οΈ Tech Stack

Layer Technology
Framework React 19 + TypeScript
AI Engine Google Gemini 3.1 Pro + Flash
Image Gen Gemini Flash Image / Imagen 3
Audio Web Audio API (pure synthesis)
Styling Tailwind CSS 4
Animations Motion (Framer Motion)
Charts Recharts
Backend Express.js (secure API proxy)
Build Vite + esbuild
Calendar Jalaali.js (Persian calendar support)
Integrations Google Calendar, YouTube, Spotify

πŸš€ Quick Start

git clone https://github.com/MahanKenway/MeowLOCK.git
cd MeowLOCK
npm install

Create a .env file (see .env.example):

GEMINI_API_KEY=your_key_here
SPOTIFY_CLIENT_ID=optional
SPOTIFY_CLIENT_SECRET=optional

Run:

npm run dev

Open http://localhost:3000 β€” your retro-futuristic workspace awaits.


πŸ›‘οΈ Privacy

  • All API calls proxied server-side β€” no keys exposed to client
  • Notes, tasks, and preferences stored in localStorage only
  • Zero tracking. Zero analytics. Zero telemetry.
  • Your focus data stays on your machine. Period.

🎨 The Philosophy

Productivity tools shouldn't feel like spreadsheets. They should feel like spaces β€” places you want to inhabit while doing deep work.

MeowLOCK is built on the belief that aesthetics and function are not opposites. That a virtual cat walking across your task list makes you more productive, not less. That the sound of rain should be synthesized, not streamed. That your workspace should look like it belongs in a cyberpunk anime, because why not.


πŸ“œ License

MIT β€” Focus freely.


Built with 🐱 by Mahan Tavakoli

Lock in. Focus up. Pet the cat.


Star this repo

About

🐱 Retro-futuristic focus workspace Pomodoro, synthesized ambient sounds, iPod Classic player, AI study assistant, virtual cat companion. Zero tracking. Pure aesthetics.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages