Livey is a stylish digital clock web app with real-time Spotify Now Playing support. Perfect for your desktop or setup dashboard.

• Real-time Spotify track display
• Background customization (supports animated GIFs)
• OAuth login with auto token refresh

• Node.js ≥ 14
• npm ≥ 6
• PM2 (for production)
• Spotify Developer account

git clone https://github.com/yasakei/livey.git
cd livey
npm install

1. Go to Spotify Developer Dashboard
2. Create a new app
3. Add http://localhost:3000/callback as the redirect URI
4. Copy your Client ID and Client Secret

SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:3000/callback
PORT=3000

Drop a .gif in the assets/ folder and update config.js:

const gifSource = '/assets/your-background.gif';

npm start

npm install -g pm2
pm2 start server.js --name "livey"
pm2 save
pm2 startup

livey/
├── assets/              # Images / GIFs
├── config.js            # Background config
├── server.js            # Main server
├── .env                 # Env vars (not committed)
├── index.html           # UI
└── package.json

MIT License