Metadata-Version: 2.4
Name: bluelobster
Version: 0.1.2
Summary: A lazy-ass BLE bridge for vibe coding with Moltbot (formerly Clawdbot) from your couch.
Project-URL: Homepage, https://github.com/kaandemirel93/bluelobster
Project-URL: Documentation, https://github.com/kaandemirel93/bluelobster#readme
Project-URL: Repository, https://github.com/kaandemirel93/bluelobster
Project-URL: Issues, https://github.com/kaandemirel93/bluelobster/issues
Author-email: Kaan Demirel <kaandemirel@yahoo.com>
License-Expression: MIT
Keywords: ble,bluetooth,clawd,clawdbot,couch,lazy,molt,moltbot,vibe-coding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: click>=8.1.0
Requires-Dist: pygame>=2.5.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Provides-Extra: macos
Requires-Dist: pyobjc-framework-corebluetooth>=10.0; extra == 'macos'
Description-Content-Type: text/markdown

# BlueLobster

> *1 in 2 million chance of finding this repo useful*

**A lazy-ass BLE bridge for [Moltbot (Clawdbot)](https://github.com/kaandemirel93/bluelobster).** Vibe code from your couch, bed, or kitchen without touching your keyboard. Optimized for horizontal development.
---

## What Is This?

BlueLobster turns your phone into a wireless keyboard for your AI coding assistant. Send prompts via Bluetooth, hear the **Blue Lobster jumpscare** (Bach's Toccata and Fugue in D minor), and watch your code materialize. No cloud, no Zuck, just vibes and Bach.

**Productivity is a jumpscare.**

---

## Couch-to-Code Efficiency Matrix

| Metric | Standing Desk | Couch + BlueLobster |
|--------|--------------|---------------------|
| Posture | "Ergonomic" | Horizontal |
| Typing Speed | 80 WPM | 15 WPM (but relaxed) |
| Coffee Proximity | 3ft | 0ft (on chest) |
| Blanket Coverage | 0% | 100% |
| Productivity Guilt | Maximum | None |
| Jumpscare Factor | 0 | **Bach** |

---

## Installation

```bash
# The lazy way (recommended)
pip install bluelobster

# macOS users (for real BLE support)
pip install 'bluelobster[macos]'

# Linux users
pip install 'bluelobster[linux]'
```

---

## Usage

### Start the Bridge

```bash
# Start with authentication token and BLE password (recommended)
bluelobster start --token your_moltbot_token --ble-password your_ble_password

# With custom Moltbot URL
bluelobster start --ws-url ws://192.168.1.100:18789

# For the faint of heart
bluelobster start --no-audio
```

### Other Commands

```bash
# Show mobile app setup instructions
bluelobster setup

# Test the jumpscare audio (speakers ready?)
bluelobster test-audio

# Send a test message directly
bluelobster send "hello from the couch"
```

---

## Mobile Setup

### BlueLobster iOS App (Recommended)

Build the companion app for the best experience:

```bash
cd ios
open BlueLobster.xcodeproj
```

See [ios/README.md](ios/README.md) for build instructions.

---

## The Audio

Place your `jumpscare.mp3` in one of these locations:

```
./assets/jumpscare.mp3
~/.bluelobster/jumpscare.mp3
```

**Recommended**: Bach's Toccata and Fugue in D minor (the Blue Lobster meme song, provided)

*If the music is too loud, you're too productive.*

---

## Architecture

```
┌─────────────────┐     BLE      ┌──────────────┐     WS      ┌──────────┐
│   Your Phone    │ ──────────▶ │  BlueLobster │ ──────────▶ │ Moltbot  │
│  (in your hand) │              │  (your PC)   │              │ (AI bot) │
└─────────────────┘              └──────────────┘              └──────────┘
                                       │
                                       ▼
                                   🎵 BACH
```

---

## Philosophy

> "Molt your responsibilities, keep the gains."

> "Don't let your desk stop your doomscroll."

> "The best code is written lying down."

---

## Development

```bash
# Clone the rare lobster
git clone https://github.com/kaandemirel93/bluelobster.git
cd bluelobster

# Install in development mode
pip install -e ".[dev,macos]"

```

---

## License

MIT - Do whatever. We're too lazy to enforce anything.

---

## Contributing

Found a bug? That's a feature. But if you insist:

1. Fork it
2. Fix it (from your couch)
3. PR it
4. Go back to lying down

---

<p align="center">
  <strong>Made with 🦞 by developers who refuse to stand</strong>
</p>

<p align="center">
  <em>If you're reading this standing up, you're doing it wrong.</em>
</p>
