Microwave Pie
Browse documentation

🧭 Start Here

Blackcap Overview ✨ Blackcap Feature Catalog Installation First Run

🚀 Deploy Blackcap

Platform Stacks and Raspberry Pi Hardware Raspberry Pi Deployment Raspberry Pi Client Services GCP Deployment Application Updates Environment Variables and Secrets Reverse Proxy and TLS Background Jobs and Schedules

🛠️ Administer Blackcap

Organizations Users, Permissions, and Authentication Configuration Workspace Backups and Restore Database Administration Regression Testing Performance and Job Status Audit, Access Activity, and Logging GeoIP and Access Location Data Retention and Purge Support Requests API Tester and Postman Instance Reporting

🍽️ Use Recipes

Recipes and the Recipe Library Recipe Import and Discovery Recipe Editing and Cache Artifacts Recipe Sharing Social Recipe Import AI Recipe Image Generation

📅 Plan Meals

Meal Planner

🛒 Use Shopping Lists

Shopping Lists and Shop a List External and Household Shopping 🧩 Chrome Extension Shop With

🧺 Manage Kitchen Inventory

🧺 Kitchen Inventory

🖥️ Use Displays

Displays and Connections Assigning and Scheduling Display Content Remote Pi Client E-Ink Rendering Menu Refresh and Rendering Noun Project Footer Images

🧑‍🍳 Cook with Let’s Cook

🧑‍🍳 Let’s Cook 🧑‍🍳 Let’s Cook Controls and Timers

🤖 Use and Administer AI

🤖 AI in Blackcap 🤖 AI Providers and Connections 🤖 AI Seeds and Usage

🧩 Use the Chrome Extension

🧩 Blackcap Chrome Extension 🧩 Chrome Extension Recipe Capture 🧩 Chrome Extension Shop With 🧩 Chrome Extension Release and Privacy

🎮 Play Games

🎮 Games and Trivia

🔌 Integrations

Email Integration Cloud Storage Integrations Voice Assistants Shop With Integrations Authentication Providers

⚙️ Develop Blackcap

Application Architecture Database Service and Data Access SQLite and PostgreSQL Database Migrations Background Job Architecture Testing API Architecture Security and Organization Scoping UI, Icons, and Documentation Assets Blackcap-Safe Emoji Documentation Standards Terminology

⚠️ Troubleshoot Blackcap

⚠️ Troubleshooting Deployment Troubleshooting Display Troubleshooting Recipe Import Troubleshooting 🤖 AI Troubleshooting Backup Troubleshooting Database Troubleshooting Diagnostic Organization Clones Support Requests

🧩 Chrome Extension Release and Privacy

Audience: Developer, Deployment Administrator, Support Related: Overview

Release documentation covers local loading, versioning, packaging, Chrome Web Store listing content, privacy disclosures, permission justification, screenshots, and review checks. Public store text must match the extension’s actual permissions and data flow.

The checked-in package privacy policy and release checklist remain authoritative for the distributable extension. Draft store material belongs here rather than in unrelated feature documents.

Store privacy draft

Last updated: July 2026

The Blackcap Chrome Extension connects Chrome to the Blackcap application for recipe capture and attended shopping workflows. It can be used with Blackcap Cloud or with a self-hosted Blackcap deployment.

Public privacy page: https://microwavepie.com/blackcap/privacy/

Information the extension uses

The extension may access the following information when you choose to use it:

  • The URL of the active browser tab
  • The title of the active browser tab
  • When you intentionally capture a supported social recipe page: normalized visible caption/description text, creator/title metadata, public image candidates, and explicit public links needed to discover the recipe
  • When deterministic Instagram or TikTok extraction fails and you explicitly confirm a priced AI review: a temporary bounded recording of only the visible active-tab video region, that tab's audio, and a bounded number of cropped frames
  • Recipe details you enter or confirm in the extension popup, such as recipe name, type, layout, description, and optional notes
  • Shopping-list item progress when you use an attended shopping helper
  • The Blackcap server URL you configure
  • The Blackcap API token you configure

How information is used

The extension uses the active tab title and URL to prepare a recipe submission when you intentionally save a page to Blackcap. For supported YouTube, TikTok, Instagram, Facebook Reel, and Pinterest pages, it may also collect bounded visible recipe evidence after you choose Capture Page so Blackcap can process the import in the background. When you use attended shopping, the extension asks Blackcap for the current shopping-list item, opens the retailer search page, and sends list progress back to Blackcap.

The normal social capture flow does not collect cookies, social session/access tokens, authorization headers, local/session storage, browsing history, or the complete page DOM. Optional AI video review is never automatic: Blackcap first shows the configured provider/quality, exact AI Seed price, available Personal and Organization balances, and requires confirmation. The extension verifies that the active Instagram/TikTok content ID still matches the confirmed capture, records only that tab's visible video region and tab audio, and does not use the microphone or capture other tabs.

Where information is sent

Recipe, shopping, and explicitly confirmed temporary AI-review media are sent only to the Blackcap server URL you configure. That may be Blackcap Cloud or a self-hosted Blackcap server. When a Blackcap administrator enables Social Recipe Extraction, the server may send that bounded media and recipe evidence to the Gemini or OpenAI provider configured for the quality tier selected by the user. Provider credentials remain on the Blackcap server and are never sent to the extension.

Local storage

The extension stores your configured Blackcap URL and API token in Chrome local extension storage so you do not need to re-enter them each time. It may also store short-lived capture/job state so an explicitly confirmed AI review can resume after the popup closes. It does not store captured video/audio files in Chrome storage. Blackcap deletes temporary server-side media after processing, cancellation, failure, or expiration.

Chrome Web Store Limited Use disclosure

The extension uses browser data only to provide its single purpose: connecting Chrome to Blackcap for recipe capture and attended shopping workflows. It does not sell user data, does not use user data for advertising, does not use third-party analytics, and does not transfer user data except as needed to send the information you choose to your configured Blackcap server.

Data sharing

The extension does not sell user data. The extension does not share user data with advertisers, analytics services, or third-party data brokers.

Remote code

The extension does not load or execute remotely hosted JavaScript. Extension logic is packaged with the extension.

User control

You can clear the configured Blackcap URL and API token from the extension settings at any time. You can also revoke API tokens inside Blackcap and uninstall the extension from Chrome.

Security

The API token should be treated like a password. If you believe the token has been exposed, revoke it or generate a new token from Blackcap and update the extension settings.

Contact

For Blackcap support and privacy questions, contact blackcap@microwavepie.com.

Store release guide

This guide supports Chrome Web Store submission for the Blackcap Chrome Extension.

Public URLs

Submission strategy

  1. Package only the files in Blackcap-Pi-Extension/.
  2. Submit to the Chrome Web Store as Unlisted first.
  3. Complete the privacy disclosures with the same data-use statements shown on the public privacy page.
  4. Explain activeTab, storage, tabs, scripting, sidePanel, and optional host permissions in the permission justification fields.
  5. After Google assigns the permanent extension ID, optionally add chrome-extension://YOUR_EXTENSION_ID to Blackcap extension_allowed_origins.
  6. Test the Web Store-installed extension with Blackcap Cloud and self-hosted Blackcap URLs before public release.

Review notes

The extension has a narrow purpose: connect Chrome to Blackcap for recipe capture and attended shopping workflows. It does not sell user data, use advertising, use third-party tracking, or load remotely hosted extension code.

Store listing draft

Extension name

Blackcap Chrome Extension

Short description

Capture recipe pages and supported social recipes, and use attended shopping workflows with Blackcap.

Detailed description

Blackcap Chrome Extension connects Chrome to Blackcap, a kitchen planning application for recipes, meal plans, shopping lists, displays, and guided cooking.

Use the extension to capture recipe pages from Chrome and send them to Blackcap. Blackcap can process the recipe, organize it in your library, and prepare it for meal planning, shopping lists, mobile access, and kitchen display workflows.

The extension also supports attended shopping workflows. Blackcap can guide your shopping list while you choose products and complete checkout yourself on supported retailer sites.

Features

  • Capture recipe pages from Chrome
  • Import supported YouTube, TikTok, Instagram, Facebook Reel, and Pinterest recipe sources
  • Capture expanded visible social recipe evidence without collecting social cookies or session tokens
  • When deterministic Instagram/TikTok extraction fails, optionally review a user-confirmed bounded video capture through Blackcap's configured Gemini or OpenAI quality tiers
  • Show the exact AI Seed cost and funding balance before any AI review
  • Send recipe URL, title, description, type, and layout details to Blackcap
  • Queue Blackcap recipe processing and cache generation
  • Use attended shopping helpers with Blackcap shopping lists
  • Show shopping-list context in Chrome's side panel
  • Store your Blackcap URL and API token locally in Chrome
  • Works with Blackcap Cloud and self-hosted Blackcap deployments

Requirements

This extension requires access to a Blackcap application. You can use Blackcap Cloud when available or connect to your own self-hosted Blackcap server.

To connect the extension, open Blackcap, create a personal API token from My Account, then paste that token into the extension settings with your Blackcap URL.

Privacy-first design

The extension sends recipe and shopping information only to the Blackcap server you configure. It does not use advertising, third-party analytics, or remotely hosted extension code.

Category

Productivity

Single purpose statement

This extension connects Chrome to Blackcap so users can capture recipe pages, optionally capture a user-confirmed bounded social video for server-managed recipe review, and run attended shopping-list workflows with their configured Blackcap application.

Permission justification

activeTab

Used when the user opens the extension or saves a recipe to read the current tab title and URL and, after an intentional Capture Page action, bounded visible recipe evidence from a supported page.

storage

Used to save the user's Blackcap server URL and API token locally in Chrome.

tabs

Used for attended shopping workflows that open or return to Blackcap and retailer tabs at the user's request.

scripting

Used after a user action to capture normalized recipe evidence from the active recipe/social page, register Blackcap helper scripts for the user-configured Blackcap host, and support attended shopping workflows. The extension does not inject unrelated advertising, tracking, or checkout automation.

sidePanel

Used to show the current Blackcap shopping-list item while the user shops on supported retailer sites.

tabCapture

Used only after the user confirms an AI Seed-priced Instagram or TikTok review. It captures the exact active social tab so the extension can crop the visible video region, include that tab's audio, and submit bounded temporary media to the configured Blackcap server. It does not capture the microphone or unrelated tabs.

offscreen

Used to keep the user-initiated tab recording and upload alive after the small action popup closes. The offscreen document performs no background browsing and stores no media in Chrome storage.

optional host permissions

Requested for the Blackcap server URL entered by the user so the extension can call the configured Blackcap API.

Public support and policy URLs

On this page