Local Project Player
Your local apps. One dashboard. Zero friction.
A free, open-source project manager for local development apps.
lp-player.sh
Features · Install · Screenshots · Getting Started · Contributing
Add your projects, hit play, and go.
AI-assisted setup — paste a GitHub URL and let AI handle the rest.
LP Player is a centralized dashboard for managing and running all your local development projects. Register any app — Python, Node.js, Go, anything — start and stop it with one click, monitor terminal output in real time, and let AI handle the boring setup.
No more juggling terminal tabs, forgetting launch commands, or re-reading READMEs. One place for everything.
One-Click Launch — Start any project instantly. Search across all your apps by name, tags, or category.
Real-Time Terminal — Live output streaming with full ANSI color support. Multiple tabs, one unified view.
AI-Assisted Setup — Point to a GitHub repo. AI reads the README, detects the stack, installs dependencies, and configures everything automatically.
Smart Detection — Auto-detects Python venv, Conda, Node.js environments and fills activation commands for you.
Port Management — Detects port conflicts before you run. Click to open running apps in your browser.
System Monitoring — CPU and memory usage at a glance in the footer. Know when your machine is struggling.
Beautiful UI — Vinyl record-inspired app cards with auto-generated colorful icons, smooth Framer Motion animations, dark/light themes, sepia filters, and hue rotation.
Sound Effects — Optional vinyl crackle and retro sound effects for a unique experience.
Cross-Platform — Works on macOS, Windows, and Linux. Available as npm package, standalone binary, DMG, or Windows installer.
The main dashboard with your projects
Add apps manually or let AI do it from a GitHub URL
npx lp-playernpm install -g lp-player
lp-playercurl -fsSL https://raw.githubusercontent.com/maverick-tr/lp-player/release/install.sh | bash| Platform | Download |
|---|---|
| macOS (Apple Silicon) | LP-Player.dmg |
| macOS (Intel) | lp-player-macos-x64 |
| Windows | LP-Player-Setup.exe |
| Linux (x64) | lp-player-linux-x64 |
All releases are hosted on GitHub Releases — fully transparent, no tracking.
macOS users: If you see "LP Player is damaged and can't be opened", run this once after installing:
xattr -c /Applications/LP\ Player.appThis removes the macOS quarantine flag applied to downloaded apps that aren't signed with an Apple Developer certificate.
LP Player's AI-assisted setup works with any provider that exposes an OpenAI-compatible API (/v1/chat/completions). Configure the API URL, key, and model in Settings → AI.
| Provider | API URL | Example Models |
|---|---|---|
| OpenAI | https://api.openai.com/v1 |
gpt-4o, gpt-4o-mini, o3-mini |
| Anthropic (via proxy) | https://api.anthropic.com/v1 |
claude-sonnet-4-20250514 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai |
gemini-2.0-flash, gemini-2.5-pro |
| Ollama (local) | http://localhost:11434/v1 |
llama3, codellama, mistral |
| LM Studio (local) | http://localhost:1234/v1 |
Any loaded model |
| Groq | https://api.groq.com/openai/v1 |
llama-3.3-70b, mixtral-8x7b |
| Together AI | https://api.together.xyz/v1 |
meta-llama/Llama-3-70b |
| OpenRouter | https://openrouter.ai/api/v1 |
Any model via OpenRouter |
| Mistral AI | https://api.mistral.ai/v1 |
mistral-large, codestral |
| DeepSeek | https://api.deepseek.com/v1 |
deepseek-chat, deepseek-coder |
| Any OpenAI-compatible | Your custom URL | Any compatible model |
No real API key needed for local providers like Ollama and LM Studio — just enter any placeholder value (e.g.
12345) as the field is required.
LP Player opens automatically when launched. If it doesn't, browse to http://localhost:4243 — this is the default port.
Go to Settings → Environment and set your default projects directory (e.g. ~/Projects). This enables autocomplete when adding apps and auto-fills paths for git cloning.
Go to Settings → AI and add your API key for AI-assisted installations. LP Player can read a project's README, detect the tech stack, install dependencies, and configure everything automatically.
If you have uv installed, enable "Prefer uv" for faster Python package installs.
Click "Add App" and either:
- Manual: Enter the project path, run command, and optional environment activation command. LP Player auto-detects Python venvs, Conda environments, and Node.js setups.
- From Git: Paste a GitHub URL. LP Player clones the repo and sets it up.
- AI Install: Paste a GitHub URL and let AI handle everything — from cloning to dependency installation.
Tip: Apps without a custom logo automatically get a colorful vinyl record icon — each one unique.
Click the power knob on any app card to start it. Terminal output streams in real time. Click the port number to open the app in your browser.
- Node.js 18+
- npm
git clone https://github.com/maverick-tr/lp-player.git
cd lp-player
npm install
./start.sh # dev mode (frontend + API)
./start.sh prod # production modeOr using npm scripts:
npm run dev:api # frontend on :4242 + API on :4243
npm run build # production build
npm run prod # build + serve on :4243| Layer | Technology |
|---|---|
| Frontend | React 18, Vite, Tailwind CSS, Framer Motion, Headless UI |
| Backend | Node.js, Express, WebSocket (ws) |
| Process Management | Child Process API with real-time streaming |
| Data | JSON file persistence with triple-fallback (cache → localStorage → API → file) |
| Font | Inconsolata (monospace) |
Contributions are welcome! See CONTRIBUTING.md for setup instructions and guidelines.
- Fork the repo
- Create a feature branch
- Make your changes
- Submit a Pull Request
MIT License — free to use, modify, and distribute © maverick-tr.