bbqr

Name	bbqr JSON
Version	0.1.1 JSON
	download
home_page	https://github.com/foglomon/bbqr
Summary	🔥 BBQR - The hottest terminal-based QR code generator that grills your data to perfection!
upload_time	2025-07-26 18:04:24
maintainer	None
docs_url	None
author	Ishman Singh
requires_python	>=3.7
license	None
keywords	qr qrcode generator terminal cli bbq barcode wifi upload
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # 🔥 BBQR (Barbequer) - QR Code Generator 🔥

Welcome to **BBQR** (pronounced "barbequer"), the hottest terminal-based QR code generator that grills your data to perfection!

## 🍖 Features

BBQR can handle all your QR code grilling needs:

### Core QR Generation

- 🌐 **URLs** - Grill web links into scannable codes
- 📝 **Text** - Smoke any text into QR perfection
- 🖼️ **Images** - Convert images to base64 QR codes
- 📋 **Clipboard** - Automatically grab clipboard content
- 🔄 **Piped Input** - Accept data from pipes and redirects

### WiFi QR Codes (Cross-Platform)

- 📶 **Saved WiFi Profiles**:
  - Windows: Uses `netsh` commands
  - macOS: Reads from keychain
  - Linux: Uses NetworkManager
- 🥩 **Manual WiFi Entry**: Enter SSID, password, security type
- Supports WPA/WPA2, WEP, and Open networks

### File Operations

- ⬆️ **File Upload**: Upload files to 0x0.st with QR download codes
- 📦 **Large File Support**: Automatic chunking for files >512MB
- 🔗 **Parallel Processing**: Multi-threaded uploads/downloads
- ⏰ **Auto-Expiration**: Files removed after 30 days

### Advanced Features

- 👀 **File Watching**: Auto-generate QR codes when files change
- 📂 **Multi QR Generation**: Process multiple lines from files
- 🔍 **QR Code Reader**: Decode and handle various QR content types
- 🎨 **BBQ Theme**: Colorful, fun interface with ASCII art

## 🔧 Installation

### Installation

```bash
pip install bbqr
```

Then start grilling:
```bash
bbqr --help
```

### Development Setup

If you want to contribute or run from source:

1. **Clone the repository**:

   ```bash
   git clone https://github.com/foglomon/bbqr
   cd bbqr
   ```

2. **Install dependencies**:

   ```bash
   pip install -r requirements.txt
   ```

3. **Start grilling**:
   ```bash
   python bbqr.py
   ```

## 🚀 Usage

### Command Line Options

```bash
# Basic QR generation
bbqr --url "https://github.com"
bbqr --text "Hello, World!"
bbqr --image photo.jpg
bbqr --clipboard
bbqr --wifi

# File operations
bbqr --file document.pdf
bbqr --read qrcode.png

# Advanced features
bbqr --watch notes.txt
bbqr --multi urls.txt
bbqr --watch journal.md --output qr_codes/

# Options
bbqr --text "Hello" --size 15 --save --copy
bbqr --url "https://github.com" --save

# Piped input
echo "Secret message" | bbqr
date | bbqr --save
curl -s https://api.github.com/users/octocat | bbqr
```

### Interactive Mode

Run without arguments for the BBQ-themed menu:

```bash
bbqr
```

You'll see a beautiful interface:

```
🔥 Welcome to BBQR - The Barbequer! 🔥
Time to grill your data into delicious QR codes!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🍖 Interactive Mode - What would you like to grill?
1. 🌐 URL
2. 📝 Text
3. 🖼️  Image
4. 📋 Clipboard
5. 🛜  WiFi
6. ⬆️  Upload File
7. 👀 Watch File
8. 📂 Multi QR from File
9. 🔍 Read QR Code
```

## 💾 Output Options

### 🖥️ Terminal Display (Always)

- **Dark/Light Mode Compatible**: Uses ASCII blocks optimized for both themes
- **Instant Preview**: See your QR code immediately without files
- **Beautiful ASCII Art**: Clean, scannable terminal QR codes

### 💾 File Saving (Optional)

- **Auto-generated filenames**: `bbqr_[type]_[YYYYMMDD_HHMMSS].png`
- **Safe naming**: No overwriting, proper extensions
- **Multiple formats supported**: PNG output for all QR types

## 📶 WiFi QR Codes

### Cross-Platform Profile Support

**Windows**:

- Uses `netsh wlan show profiles` to list saved networks
- Retrieves passwords with `netsh wlan show profile key=clear`

**macOS**:

- Reads from system keychain using `security` command
- Falls back to `networksetup` for profile listing

**Linux**:

- Uses NetworkManager (`nmcli`) for profile management
- Falls back to `/etc/wpa_supplicant/wpa_supplicant.conf`

### Manual WiFi Setup

For new networks or when automatic retrieval fails:

1. Enter SSID (network name)
2. Select security type (WPA/WPA2, WEP, Open)
3. Enter password if required

Generated QR codes work with all modern smartphones!

## 📁 File Upload & Sharing

BBQR integrates with 0x0.st for easy file sharing:

### Features

- **Large File Support**: Automatic chunking for files >512MB
- **Parallel Processing**: Multi-threaded uploads/downloads
- **Progress Tracking**: Real-time progress bars
- **Integrity Checking**: SHA256 hash verification
- **Auto-Cleanup**: Temporary files automatically removed

### How It Works

1. Upload file to 0x0.st (30-day expiration)
2. Generate QR code containing download information
3. Scan QR code to download and reassemble file
4. Automatic integrity verification

## 🔍 QR Code Reading

BBQR can decode various QR code types:

### WiFi QR Codes

- Displays network name, security type, password
- Can automatically connect on Windows
- Supports standard WiFi QR format

### File Upload QR Codes

- Shows file info (name, size, chunks)
- Downloads and reassembles automatically
- Verifies file integrity

### Image QR Codes

- Extracts base64-encoded images
- Saves to Pictures directory
- Supports multiple image formats

### Text/URL QR Codes

- Displays content with formatting
- Opens URLs in browser
- Copies content to clipboard

## 👀 File Watching

Monitor files for changes and auto-generate QR codes:

```bash
# Watch file with default output
python bbqr.py --watch notes.txt

# Custom output location
python bbqr.py --watch journal.md --output qr_codes/journal_qr.png

# Custom QR size
python bbqr.py --watch data.txt --size 15
```

Uses cross-platform file watching (falls back to polling if needed).

## 📂 Multi QR Generation

Generate QR codes from multiple lines in a file:

```bash
python bbqr.py --multi urls.txt
python bbqr.py --multi contact_list.txt --size 12
```

Creates numbered QR code files in a `qrcodes/` directory.

## � Technical Details

### Dependencies

- `qrcode[pil]`: QR code generation
- `Pillow`: Image processing
- `pyperclip`: Clipboard operations
- `colorama`: Cross-platform colored output
- `watchdog`: File monitoring
- `pyzbar`: QR code decoding
- `requests`: HTTP operations for file upload

### File Structure

```
bbqr.py              # Main script
requirements.txt     # Dependencies
README.md           # This file
QUICKSTART.md       # Quick start guide
LICENSE             # MIT License
```

### Performance

- Multi-threaded file operations
- Efficient chunking algorithm
- Memory-conscious processing
- Progress tracking for long operations

## 🎨 BBQ Theme

BBQR uses a fun BBQ theme throughout:

- 🔥 Fire emojis for active operations
- 🥩 Meat emojis for success messages
- 💨 Smoke emojis for info messages
- 💥 Explosion emojis for errors
- BBQ-themed terminology ("grilling", "smoking", "cooking")

## 🔥 Examples

### Basic Usage

```bash
# Quick URL QR
python bbqr.py -u "https://example.com"

# Text with custom size
python bbqr.py -t "Meeting at 3PM" -s 12

# Clipboard content
python bbqr.py -c
```

### Advanced Usage

```bash
# File upload with save
python bbqr.py --file presentation.pdf --save

# Watch file with custom output
python bbqr.py --watch todo.txt --output ~/Desktop/todo_qr.png

# Multi QR generation
python bbqr.py --multi contact_list.txt

# Read and handle QR code
python bbqr.py --read wifi_qr.png
```

### Piped Usage

```bash
# From file
cat secret.txt | python bbqr.py

# From command output
date | python bbqr.py --save

# Chain commands
curl -s https://api.github.com/users/octocat | python bbqr.py --copy
```

## 💡 Tips

- QR codes display directly in terminal using ASCII art
- Use `--save` to create PNG files with auto-generated names
- Larger `--size` values create more detailed QR codes
- WiFi QR codes work with most modern smartphones
- File watching supports both real-time monitoring and polling fallback
- Multi QR generation creates organized numbered files
- QR reading handles multiple content types intelligently

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add your BBQ-themed improvements
4. Test thoroughly across platforms
5. Submit a pull request

## 📄 License

MIT License - Feel free to grill this code however you like!

---

**Happy Grilling!** 🔥🍖🔥

_"Where data meets the grill, and QR codes are always perfectly cooked!"_

## 🔧 Installation

### Prerequisites

- Python 3.7 or higher
- Windows OS (for WiFi profile management)

### Quick Setup

1. **Clone or download** this repository:

   ```bash
   git clone <repository-url>
   cd bbqr
   ```

2. **Install dependencies**:

   ```bash
   pip install -r requirements.txt
   ```

3. **Make it executable** (optional):

   ```bash
   pip install -e .
   ```

## 🚀 Usage

### Command Line Options

```bash
# Generate QR from URL
python bbqr.py --url https://github.com

# Generate QR from text
python bbqr.py --text "Hello, World!"

# Generate QR from image
python bbqr.py --image photo.jpg

# Generate QR from clipboard
python bbqr.py --clipboard

# Generate WiFi QR code
python bbqr.py --wifi

# Piped input
echo "Secret message" | python bbqr.py

# Custom size and auto-save with timestamp
python bbqr.py --text "Hello" --size 15 --save

# Save any QR code with auto-generated filename (works with all input types)
python bbqr.py --url "https://github.com" --save
python bbqr.py --wifi --save
```

## 💾 Output Functionality

BBQR has a **safe dual output system**:

### 🖥️ **Terminal Display (Always)**

- **Dark Mode Compatible**: Uses white blocks that show clearly on dark backgrounds
- **Light Mode Compatible**: Uses proper spacing for light backgrounds
- **ASCII Art**: Beautiful terminal-based QR code display
- **Instant View**: See your QR code immediately without opening files

### Interactive Mode

Run without arguments for interactive mode:

```bash
python bbqr.py
```

You'll see a beautiful BBQ-themed menu:

```
🔥 Welcome to BBQR - The Barbequer! 🔥
Time to grill your data into delicious QR codes!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🍖 Interactive Mode - What would you like to grill?
1. 🌐 URL
2. 📝 Text
3. 🖼️  Image
4. 📋 Clipboard
5. 📶 WiFi
```

### WiFi QR Codes

The WiFi feature offers two grilling methods:

#### 🔥 **Saved WiFi Profiles**

- Automatically discovers all saved Windows WiFi profiles
- Retrieves stored passwords using Windows netsh
- One-click QR generation for known networks

#### 🥩 **Manual WiFi Entry**

- Enter SSID, security type, and password manually
- Supports WPA/WPA2, WEP, and Open networks
- Perfect for sharing guest networks

## 📱 WiFi QR Code Format

Generated WiFi QR codes use the standard format:

```
WIFI:T:WPA;S:NetworkName;P:password;;
```

When scanned, devices will automatically prompt to join the network!

## 🎨 BBQ Theme

BBQR brings the heat with:

- 🔥 Fire emojis for emphasis
- 🥩 Meat-themed progress indicators
- 🍖 Grill terminology throughout
- 💨 Smoke effects for processing

## 🔧 Technical Details

### Dependencies

- **qrcode[pil]** - QR code generation with PIL imaging
- **Pillow** - Image processing
- **pyperclip** - Clipboard access
- **click** - Command-line interface enhancements
- **colorama** - Cross-platform colored terminal text

### Windows WiFi Integration

Uses Windows `netsh` command for:

- Listing saved WiFi profiles
- Retrieving stored passwords
- No additional dependencies required

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add your BBQ-themed improvements
4. Test thoroughly
5. Submit a pull request

## 📄 License

GNU GPLv3

## 🔥 Examples

### Basic Usage

```bash
# Quick URL QR
python bbqr.py -u "https://example.com"

# Text with custom size
python bbqr.py -t "Meeting at 3PM" -s 12

# Clipboard content
python bbqr.py -c
```

### Piped Usage

```bash
# From file
cat secret.txt | python bbqr.py

# From command output
date | python bbqr.py

# Chain commands
curl -s https://api.github.com/users/octocat | python bbqr.py
```

### WiFi Sharing

```bash
# Interactive WiFi setup
python bbqr.py --wifi

# This will show:
# 1. 🔥 Use saved WiFi profile
# 2. 🥩 Add new WiFi credentials
```

## 💡 Tips

- QR codes are displayed directly in the terminal using ASCII art
- Use `--output` to save QR codes as image files
- Larger `--size` values create more detailed QR codes
- WiFi QR codes work with most modern smartphones
- Pipe any command output to instantly create QR codes

---

**Happy Grilling!** 🔥🍖🔥

_"Where data meets the grill, and QR codes are always perfectly cooked!"_

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/foglomon/bbqr",
    "name": "bbqr",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "qr qrcode generator terminal cli bbq barcode wifi upload",
    "author": "Ishman Singh",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/8e/6d/9e68d644de15fc6406619c2b385c5fd7e7f95b351cd33a689e46a52711a0/bbqr-0.1.1.tar.gz",
    "platform": null,
    "description": "# \ud83d\udd25 BBQR (Barbequer) - QR Code Generator \ud83d\udd25\n\nWelcome to **BBQR** (pronounced \"barbequer\"), the hottest terminal-based QR code generator that grills your data to perfection!\n\n## \ud83c\udf56 Features\n\nBBQR can handle all your QR code grilling needs:\n\n### Core QR Generation\n\n- \ud83c\udf10 **URLs** - Grill web links into scannable codes\n- \ud83d\udcdd **Text** - Smoke any text into QR perfection\n- \ud83d\uddbc\ufe0f **Images** - Convert images to base64 QR codes\n- \ud83d\udccb **Clipboard** - Automatically grab clipboard content\n- \ud83d\udd04 **Piped Input** - Accept data from pipes and redirects\n\n### WiFi QR Codes (Cross-Platform)\n\n- \ud83d\udcf6 **Saved WiFi Profiles**:\n  - Windows: Uses `netsh` commands\n  - macOS: Reads from keychain\n  - Linux: Uses NetworkManager\n- \ud83e\udd69 **Manual WiFi Entry**: Enter SSID, password, security type\n- Supports WPA/WPA2, WEP, and Open networks\n\n### File Operations\n\n- \u2b06\ufe0f **File Upload**: Upload files to 0x0.st with QR download codes\n- \ud83d\udce6 **Large File Support**: Automatic chunking for files >512MB\n- \ud83d\udd17 **Parallel Processing**: Multi-threaded uploads/downloads\n- \u23f0 **Auto-Expiration**: Files removed after 30 days\n\n### Advanced Features\n\n- \ud83d\udc40 **File Watching**: Auto-generate QR codes when files change\n- \ud83d\udcc2 **Multi QR Generation**: Process multiple lines from files\n- \ud83d\udd0d **QR Code Reader**: Decode and handle various QR content types\n- \ud83c\udfa8 **BBQ Theme**: Colorful, fun interface with ASCII art\n\n## \ud83d\udd27 Installation\n\n### Installation\n\n```bash\npip install bbqr\n```\n\nThen start grilling:\n```bash\nbbqr --help\n```\n\n### Development Setup\n\nIf you want to contribute or run from source:\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone https://github.com/foglomon/bbqr\n   cd bbqr\n   ```\n\n2. **Install dependencies**:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Start grilling**:\n   ```bash\n   python bbqr.py\n   ```\n\n## \ud83d\ude80 Usage\n\n### Command Line Options\n\n```bash\n# Basic QR generation\nbbqr --url \"https://github.com\"\nbbqr --text \"Hello, World!\"\nbbqr --image photo.jpg\nbbqr --clipboard\nbbqr --wifi\n\n# File operations\nbbqr --file document.pdf\nbbqr --read qrcode.png\n\n# Advanced features\nbbqr --watch notes.txt\nbbqr --multi urls.txt\nbbqr --watch journal.md --output qr_codes/\n\n# Options\nbbqr --text \"Hello\" --size 15 --save --copy\nbbqr --url \"https://github.com\" --save\n\n# Piped input\necho \"Secret message\" | bbqr\ndate | bbqr --save\ncurl -s https://api.github.com/users/octocat | bbqr\n```\n\n### Interactive Mode\n\nRun without arguments for the BBQ-themed menu:\n\n```bash\nbbqr\n```\n\nYou'll see a beautiful interface:\n\n```\n\ud83d\udd25 Welcome to BBQR - The Barbequer! \ud83d\udd25\nTime to grill your data into delicious QR codes!\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n\ud83c\udf56 Interactive Mode - What would you like to grill?\n1. \ud83c\udf10 URL\n2. \ud83d\udcdd Text\n3. \ud83d\uddbc\ufe0f  Image\n4. \ud83d\udccb Clipboard\n5. \ud83d\udedc  WiFi\n6. \u2b06\ufe0f  Upload File\n7. \ud83d\udc40 Watch File\n8. \ud83d\udcc2 Multi QR from File\n9. \ud83d\udd0d Read QR Code\n```\n\n## \ud83d\udcbe Output Options\n\n### \ud83d\udda5\ufe0f Terminal Display (Always)\n\n- **Dark/Light Mode Compatible**: Uses ASCII blocks optimized for both themes\n- **Instant Preview**: See your QR code immediately without files\n- **Beautiful ASCII Art**: Clean, scannable terminal QR codes\n\n### \ud83d\udcbe File Saving (Optional)\n\n- **Auto-generated filenames**: `bbqr_[type]_[YYYYMMDD_HHMMSS].png`\n- **Safe naming**: No overwriting, proper extensions\n- **Multiple formats supported**: PNG output for all QR types\n\n## \ud83d\udcf6 WiFi QR Codes\n\n### Cross-Platform Profile Support\n\n**Windows**:\n\n- Uses `netsh wlan show profiles` to list saved networks\n- Retrieves passwords with `netsh wlan show profile key=clear`\n\n**macOS**:\n\n- Reads from system keychain using `security` command\n- Falls back to `networksetup` for profile listing\n\n**Linux**:\n\n- Uses NetworkManager (`nmcli`) for profile management\n- Falls back to `/etc/wpa_supplicant/wpa_supplicant.conf`\n\n### Manual WiFi Setup\n\nFor new networks or when automatic retrieval fails:\n\n1. Enter SSID (network name)\n2. Select security type (WPA/WPA2, WEP, Open)\n3. Enter password if required\n\nGenerated QR codes work with all modern smartphones!\n\n## \ud83d\udcc1 File Upload & Sharing\n\nBBQR integrates with 0x0.st for easy file sharing:\n\n### Features\n\n- **Large File Support**: Automatic chunking for files >512MB\n- **Parallel Processing**: Multi-threaded uploads/downloads\n- **Progress Tracking**: Real-time progress bars\n- **Integrity Checking**: SHA256 hash verification\n- **Auto-Cleanup**: Temporary files automatically removed\n\n### How It Works\n\n1. Upload file to 0x0.st (30-day expiration)\n2. Generate QR code containing download information\n3. Scan QR code to download and reassemble file\n4. Automatic integrity verification\n\n## \ud83d\udd0d QR Code Reading\n\nBBQR can decode various QR code types:\n\n### WiFi QR Codes\n\n- Displays network name, security type, password\n- Can automatically connect on Windows\n- Supports standard WiFi QR format\n\n### File Upload QR Codes\n\n- Shows file info (name, size, chunks)\n- Downloads and reassembles automatically\n- Verifies file integrity\n\n### Image QR Codes\n\n- Extracts base64-encoded images\n- Saves to Pictures directory\n- Supports multiple image formats\n\n### Text/URL QR Codes\n\n- Displays content with formatting\n- Opens URLs in browser\n- Copies content to clipboard\n\n## \ud83d\udc40 File Watching\n\nMonitor files for changes and auto-generate QR codes:\n\n```bash\n# Watch file with default output\npython bbqr.py --watch notes.txt\n\n# Custom output location\npython bbqr.py --watch journal.md --output qr_codes/journal_qr.png\n\n# Custom QR size\npython bbqr.py --watch data.txt --size 15\n```\n\nUses cross-platform file watching (falls back to polling if needed).\n\n## \ud83d\udcc2 Multi QR Generation\n\nGenerate QR codes from multiple lines in a file:\n\n```bash\npython bbqr.py --multi urls.txt\npython bbqr.py --multi contact_list.txt --size 12\n```\n\nCreates numbered QR code files in a `qrcodes/` directory.\n\n## \ufffd Technical Details\n\n### Dependencies\n\n- `qrcode[pil]`: QR code generation\n- `Pillow`: Image processing\n- `pyperclip`: Clipboard operations\n- `colorama`: Cross-platform colored output\n- `watchdog`: File monitoring\n- `pyzbar`: QR code decoding\n- `requests`: HTTP operations for file upload\n\n### File Structure\n\n```\nbbqr.py              # Main script\nrequirements.txt     # Dependencies\nREADME.md           # This file\nQUICKSTART.md       # Quick start guide\nLICENSE             # MIT License\n```\n\n### Performance\n\n- Multi-threaded file operations\n- Efficient chunking algorithm\n- Memory-conscious processing\n- Progress tracking for long operations\n\n## \ud83c\udfa8 BBQ Theme\n\nBBQR uses a fun BBQ theme throughout:\n\n- \ud83d\udd25 Fire emojis for active operations\n- \ud83e\udd69 Meat emojis for success messages\n- \ud83d\udca8 Smoke emojis for info messages\n- \ud83d\udca5 Explosion emojis for errors\n- BBQ-themed terminology (\"grilling\", \"smoking\", \"cooking\")\n\n## \ud83d\udd25 Examples\n\n### Basic Usage\n\n```bash\n# Quick URL QR\npython bbqr.py -u \"https://example.com\"\n\n# Text with custom size\npython bbqr.py -t \"Meeting at 3PM\" -s 12\n\n# Clipboard content\npython bbqr.py -c\n```\n\n### Advanced Usage\n\n```bash\n# File upload with save\npython bbqr.py --file presentation.pdf --save\n\n# Watch file with custom output\npython bbqr.py --watch todo.txt --output ~/Desktop/todo_qr.png\n\n# Multi QR generation\npython bbqr.py --multi contact_list.txt\n\n# Read and handle QR code\npython bbqr.py --read wifi_qr.png\n```\n\n### Piped Usage\n\n```bash\n# From file\ncat secret.txt | python bbqr.py\n\n# From command output\ndate | python bbqr.py --save\n\n# Chain commands\ncurl -s https://api.github.com/users/octocat | python bbqr.py --copy\n```\n\n## \ud83d\udca1 Tips\n\n- QR codes display directly in terminal using ASCII art\n- Use `--save` to create PNG files with auto-generated names\n- Larger `--size` values create more detailed QR codes\n- WiFi QR codes work with most modern smartphones\n- File watching supports both real-time monitoring and polling fallback\n- Multi QR generation creates organized numbered files\n- QR reading handles multiple content types intelligently\n\n## \ud83e\udd1d Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Add your BBQ-themed improvements\n4. Test thoroughly across platforms\n5. Submit a pull request\n\n## \ud83d\udcc4 License\n\nMIT License - Feel free to grill this code however you like!\n\n---\n\n**Happy Grilling!** \ud83d\udd25\ud83c\udf56\ud83d\udd25\n\n_\"Where data meets the grill, and QR codes are always perfectly cooked!\"_\n\n## \ud83d\udd27 Installation\n\n### Prerequisites\n\n- Python 3.7 or higher\n- Windows OS (for WiFi profile management)\n\n### Quick Setup\n\n1. **Clone or download** this repository:\n\n   ```bash\n   git clone <repository-url>\n   cd bbqr\n   ```\n\n2. **Install dependencies**:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Make it executable** (optional):\n\n   ```bash\n   pip install -e .\n   ```\n\n## \ud83d\ude80 Usage\n\n### Command Line Options\n\n```bash\n# Generate QR from URL\npython bbqr.py --url https://github.com\n\n# Generate QR from text\npython bbqr.py --text \"Hello, World!\"\n\n# Generate QR from image\npython bbqr.py --image photo.jpg\n\n# Generate QR from clipboard\npython bbqr.py --clipboard\n\n# Generate WiFi QR code\npython bbqr.py --wifi\n\n# Piped input\necho \"Secret message\" | python bbqr.py\n\n# Custom size and auto-save with timestamp\npython bbqr.py --text \"Hello\" --size 15 --save\n\n# Save any QR code with auto-generated filename (works with all input types)\npython bbqr.py --url \"https://github.com\" --save\npython bbqr.py --wifi --save\n```\n\n## \ud83d\udcbe Output Functionality\n\nBBQR has a **safe dual output system**:\n\n### \ud83d\udda5\ufe0f **Terminal Display (Always)**\n\n- **Dark Mode Compatible**: Uses white blocks that show clearly on dark backgrounds\n- **Light Mode Compatible**: Uses proper spacing for light backgrounds\n- **ASCII Art**: Beautiful terminal-based QR code display\n- **Instant View**: See your QR code immediately without opening files\n\n### Interactive Mode\n\nRun without arguments for interactive mode:\n\n```bash\npython bbqr.py\n```\n\nYou'll see a beautiful BBQ-themed menu:\n\n```\n\ud83d\udd25 Welcome to BBQR - The Barbequer! \ud83d\udd25\nTime to grill your data into delicious QR codes!\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n\ud83c\udf56 Interactive Mode - What would you like to grill?\n1. \ud83c\udf10 URL\n2. \ud83d\udcdd Text\n3. \ud83d\uddbc\ufe0f  Image\n4. \ud83d\udccb Clipboard\n5. \ud83d\udcf6 WiFi\n```\n\n### WiFi QR Codes\n\nThe WiFi feature offers two grilling methods:\n\n#### \ud83d\udd25 **Saved WiFi Profiles**\n\n- Automatically discovers all saved Windows WiFi profiles\n- Retrieves stored passwords using Windows netsh\n- One-click QR generation for known networks\n\n#### \ud83e\udd69 **Manual WiFi Entry**\n\n- Enter SSID, security type, and password manually\n- Supports WPA/WPA2, WEP, and Open networks\n- Perfect for sharing guest networks\n\n## \ud83d\udcf1 WiFi QR Code Format\n\nGenerated WiFi QR codes use the standard format:\n\n```\nWIFI:T:WPA;S:NetworkName;P:password;;\n```\n\nWhen scanned, devices will automatically prompt to join the network!\n\n## \ud83c\udfa8 BBQ Theme\n\nBBQR brings the heat with:\n\n- \ud83d\udd25 Fire emojis for emphasis\n- \ud83e\udd69 Meat-themed progress indicators\n- \ud83c\udf56 Grill terminology throughout\n- \ud83d\udca8 Smoke effects for processing\n\n## \ud83d\udd27 Technical Details\n\n### Dependencies\n\n- **qrcode[pil]** - QR code generation with PIL imaging\n- **Pillow** - Image processing\n- **pyperclip** - Clipboard access\n- **click** - Command-line interface enhancements\n- **colorama** - Cross-platform colored terminal text\n\n### Windows WiFi Integration\n\nUses Windows `netsh` command for:\n\n- Listing saved WiFi profiles\n- Retrieving stored passwords\n- No additional dependencies required\n\n## \ud83e\udd1d Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Add your BBQ-themed improvements\n4. Test thoroughly\n5. Submit a pull request\n\n## \ud83d\udcc4 License\n\nGNU GPLv3\n\n## \ud83d\udd25 Examples\n\n### Basic Usage\n\n```bash\n# Quick URL QR\npython bbqr.py -u \"https://example.com\"\n\n# Text with custom size\npython bbqr.py -t \"Meeting at 3PM\" -s 12\n\n# Clipboard content\npython bbqr.py -c\n```\n\n### Piped Usage\n\n```bash\n# From file\ncat secret.txt | python bbqr.py\n\n# From command output\ndate | python bbqr.py\n\n# Chain commands\ncurl -s https://api.github.com/users/octocat | python bbqr.py\n```\n\n### WiFi Sharing\n\n```bash\n# Interactive WiFi setup\npython bbqr.py --wifi\n\n# This will show:\n# 1. \ud83d\udd25 Use saved WiFi profile\n# 2. \ud83e\udd69 Add new WiFi credentials\n```\n\n## \ud83d\udca1 Tips\n\n- QR codes are displayed directly in the terminal using ASCII art\n- Use `--output` to save QR codes as image files\n- Larger `--size` values create more detailed QR codes\n- WiFi QR codes work with most modern smartphones\n- Pipe any command output to instantly create QR codes\n\n---\n\n**Happy Grilling!** \ud83d\udd25\ud83c\udf56\ud83d\udd25\n\n_\"Where data meets the grill, and QR codes are always perfectly cooked!\"_\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "\ud83d\udd25 BBQR - The hottest terminal-based QR code generator that grills your data to perfection!",
    "version": "0.1.1",
    "project_urls": {
        "Bug Reports": "https://github.com/foglomon/bbqr/issues",
        "Documentation": "https://github.com/foglomon/bbqr#readme",
        "Homepage": "https://github.com/foglomon/bbqr",
        "Source": "https://github.com/foglomon/bbqr"
    },
    "split_keywords": [
        "qr",
        "qrcode",
        "generator",
        "terminal",
        "cli",
        "bbq",
        "barcode",
        "wifi",
        "upload"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "eca071a9396543cf9fd7136261bad7ed393a1de9022ec17c12a842100c985968",
                "md5": "4beb4f606eb8b7a47eac71e9ae4c1d34",
                "sha256": "43c83879127f4010ffe46a3001414a2c84882d6e24bc71b4c9a087ab992208ae"
            },
            "downloads": -1,
            "filename": "bbqr-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4beb4f606eb8b7a47eac71e9ae4c1d34",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 35923,
            "upload_time": "2025-07-26T18:04:22",
            "upload_time_iso_8601": "2025-07-26T18:04:22.473032Z",
            "url": "https://files.pythonhosted.org/packages/ec/a0/71a9396543cf9fd7136261bad7ed393a1de9022ec17c12a842100c985968/bbqr-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8e6d9e68d644de15fc6406619c2b385c5fd7e7f95b351cd33a689e46a52711a0",
                "md5": "4d10c5338941c49408ace775f4416f7a",
                "sha256": "c67b41e8f45dbcf1b4b1146db49650292585cdc1ee15aa97afe5b3eea7d55bea"
            },
            "downloads": -1,
            "filename": "bbqr-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "4d10c5338941c49408ace775f4416f7a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 36435,
            "upload_time": "2025-07-26T18:04:24",
            "upload_time_iso_8601": "2025-07-26T18:04:24.506898Z",
            "url": "https://files.pythonhosted.org/packages/8e/6d/9e68d644de15fc6406619c2b385c5fd7e7f95b351cd33a689e46a52711a0/bbqr-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-26 18:04:24",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "foglomon",
    "github_project": "bbqr",
    "github_not_found": true,
    "lcname": "bbqr"
}