# ⚡ Lightning Control Center (LCC)
**The dashboard for the Bitcoin sovereign stack.**

A beautiful, practical easy to use self-hosted Lightning node manager. Built for Bitcoin and Lightning node runners.

**Live demo:** [https://lcc.satslist.shop/dashboard](https://lioranecho-cpu.github.io/lcc-demo/index.html)

---

## 📖 Need Help?

Paste this into any AI (Claude, ChatGPT, Grok) for an interactive walkthrough:

> *"Read https://github.com/lioranecho-cpu/lightning-control-center and guide me step by step through installing LCC on my Linux server. I have LND and Bitcoin Core already running. Check the requirements.txt and install.sh for dependencies and help me troubleshoot any issues."*
>
> For a full feature walkthrough use:
> *"Read https://github.com/lioranecho-cpu/lightning-control-center/blob/main/MANUAL.md and walk me through all LCC features and how to use them."*

---

## Install Options

### Option 1 — One-command installer (bare metal Ubuntu/Debian)
```bash
curl -sSL https://raw.githubusercontent.com/lioranecho-cpu/lightning-control-center/main/install.sh | bash
```

### Option 2 — Docker
```bash
git clone https://github.com/lioranecho-cpu/lightning-control-center.git
cd lightning-control-center
docker compose up -d
```

### Option 3 — Docker (mock mode for testing)
```bash
docker run -e LCC_MOCK=true -p 8765:8765 lcc:latest
```

---

## Requirements

- Linux (Ubuntu/Debian recommended)
- LND node with `lncli` access
- Bitcoin Core running and synced
- Python 3.9+ (bare metal) or Docker

---

## Features

### 🟠 Community (Free)
- 📊 Real-time dashboard — node health, block height, sync status
- ⚡ Channel management — view, open, close channels with inbound/outbound labels
- 👥 Peer management — connect, disconnect peers
- 💳 Wallet — on-chain & Lightning send/receive with QR codes
- 🔀 Routing — forwarding history with pagination, sorting, peer aliases
- 📈 Analytics — fees earned, routed volume, daily charts, top routing pairs
- 📓 Node journal — personal notes and logs
- 🔔 Alerts — custom notifications
- ⛏️ Mining dashboard — hashrate, pool stats
- 🖥️ System monitor — LND, Bitcoin Core, RTL, LNbits status
- 🔗 Integrations overview
- 🎨 4 themes — Midnight, Obsidian, Amber, Forest

### ⚡ Personal (20,000 sats one-time)
- Everything in Community, plus:
- ⌨️ Command Palette (Ctrl+Space)
- 📁 Collapsing sidebar
- 📊 Per-channel fee updates
- 🔓 Channel opening UI
- ❤️ Health score
- 📥 CSV export

### 🔥 Pro (9,000 sats/month or 90,000 sats/year)
- Everything in Personal, plus:
- 🟣 **NWC (Nostr Wallet Connect)** — connect Zeus, Alby, Damus and any NWC app
- 💡 **Fee Recommendations** — data-driven PPM suggestions with current channel fees
- 🌊 **Drain & Trap** — automated fee strategy per channel (drain PPM, trap PPM, floor %)
- ⚖️ **Auto-rebalance scheduler** — set interval and amount
- 🔁 **Per-channel auto-rebalance** — individual amount, interval, fee cap per channel with journal logging and auto-disable after 3 consecutive failures

[https://github.com/lioranecho-cpu/lightning-control-center/raw/main/channel-autorebalance.mp4](https://github.com/user-attachments/assets/c1c02202-0eef-48a0-b219-6e7342839a1f
)
- 🔀 **Manual rebalance** — per-channel with fee estimate
- 📡 **Live HTLC Stream** — real-time routing event monitor (companion app)
- 🔐 **Nostr login** — NIP-07 (Alby, nos2x) or nsec
- 💰 **Treasury + NWC wallet** — connect any NWC wallet
- 👤 **Peer Policy viewer** — see your fees vs peer fees per channel
- 📊 **Node P&L card** — routing fees earned vs costs (rebalancing, opens, closes) with 30 Cal-Days / 1 Year / All Time view
- 📥 **CSV export** — wallet and routing data
- 🔌 **Auto-reconnect** — automatically reconnects dropped peers every 30 minutes
- 📊 **Tax Accounting CSV** — full export with routing income, rebalance fees, channel open/close costs, and energy expenses
- 🎯 **Targeted Rebalance** — pick source AND destination channels, set amount and max fee
- 📋 **Channel Strategy page** — auto-assessed health with color-coded actions (Keep/Drain/Monitor/Close)
- 🔀 **Named rebalance pairs** — wallet shows "Rebalance: Unwetter to LNBiG [Hub-3]" instead of generic text

---

## 💎 Coming Soon
- 🖥️ Hardware node connectivity — Start9, RaspiBlitz, myNode (Umbrel App Store submission pending ✅)
- 🔌 Plugin architecture — extend LCC
- 💰 Multi-wallet Treasury — unified balance across multiple wallets
- 📦 One-click installer

---

## Tiers

| Tier | Price | Highlights |
|------|-------|------------|
| 🟠 Community | FREE | Full dashboard, 4 themes |
| ⚡ Personal | 20,000 sats (~$13) | Command Palette, CSV, Health Score |
| 🔥 Pro | 9,000 sats/month | NWC, Drain & Trap, Live Stream, Fee Recs |

Get a license at **satslist.shop** — pay with Bitcoin Lightning ⚡

---

## Screenshots

### Dashboard
![Dashboard](screenshots/dashboard.png)

### Channels — Inbound/Outbound Labels & Sorting
![Channels](screenshots/channels.png)

### Analytics — Fee Recommendations
![Analytics](screenshots/analytics.png)

### Routing — Forwarding History
![Routing](screenshots/routing.png)

### Nostr Login
![Nostr Login](screenshots/nostr-login.jpg)

---

**Sparkie Labs** — *Ignite. Control. Build.*

Made with ⚡ and ₿ for the Bitcoin community

MIT License