https://github.com/premshinde-2013/brainwave.ai_chrome_extention

https://github.com/premshinde-2013/brainwave.ai_chrome_extention

Last synced: 10 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/premshinde-2013/brainwave.ai_chrome_extention
• Owner: PremShinde-2013
• Created: 2025-04-24T03:13:43.000Z (27 days ago)
• Default Branch: main
• Last Pushed: 2025-04-24T03:15:13.000Z (27 days ago)
• Last Synced: 2025-04-24T04:23:02.919Z (27 days ago)
• Language: JavaScript
• Size: 1.91 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Blinko Chrome Extension 🚀

[中文](README_CN.md)

A Chrome extension for Blinko that uses AI to automatically extract and summarize web content. Supports custom summary templates and can save content to a specified Blinko server.

Original Project: [Blinko](https://github.com/blinko-space/blinko) 🔗

[Chrome Store](https://chromewebstore.google.com/detail/blinko%E7%BD%91%E9%A1%B5%E5%86%85%E5%AE%B9%E6%8F%90%E5%8F%96%E6%80%BB%E7%BB%93/gpdobkhkjbgbgllpkhaomajicoaccjjo?hl=zh-CN&utm_source=ext_sidebar)

[Firefox Version](https://github.com/BryceWG/Blinko-Firefox-Extension)

## ✨ Features

- 🤖 One-click web content extraction and summarization, save to Blinko

- 🎯 Customizable AI model and parameters

- 📝 Configurable summary prompt templates

- 🔗 Optional inclusion of source URLs

- ✂️ Right-click menu to send selected text to Blinko

- 📌️ Right-click to save web images to Blinko

- 📌 Quick note feature for instant thoughts capture

- 🏷️ Custom tags for summaries, selections, and images

- 💾 Temporary content storage to prevent loss on accidental closure

- 🎨 Modern UI design for smooth operation

- 🔔 Smart notification system for timely processing results

- 🎈 Floating ball for quick access (left-click to summarize, right-click to extract content)

- 🔍 Jina Reader integration for better content extraction

- 🖼️ Optional web image link preservation in extracted content

## 🔧 Installation

1. Download the extension source code

2. Open Chrome browser and go to extensions page (chrome://extensions/)

3. Enable "Developer mode" in the top right

4. Click "Load unpacked extension"

5. Select the extension directory

## 📖 User Guide

### ⚙️ Basic Configuration

Before first use, configure the following in the extension settings:

1. **Blinko API Configuration** 🎯

   - API URL: Fill up to /v1 (e.g., https://your-domain/api/v1)

   - Auth Key: Authentication key for accessing Blinko API

   - One-click AI config: Click "Get AI Config from Blinko" to auto-fetch AI settings

2. **AI Model Configuration** 🤖

   - Model URL: AI service API address (fill up to /v1)

   - API Key: Key for accessing AI service

   - Model Name: AI model to use (default: gpt-4o-mini)

   - Temperature: Controls output randomness (default: 0.5)

### 🚀 Usage

#### Summarize Entire Page 📄

1. Click the extension icon on the page you want to summarize

2. Click "Extract and Summarize Page Content"

3. Wait for AI to generate summary

4. Review and edit the summary content

5. Click "Edit and Save" to send to target server

6. You'll receive a system notification when summary is complete

#### Quick Notes ✏️

1. Click the extension icon

2. Enter content in the quick note box

3. Click "Send" to save to Blinko

#### Summarize Selected Text ✂️

1. Select text on the webpage

2. Right-click and choose "Send to Blinko Notes"

3. Content will be automatically sent to target server

#### Save Web Images 🖼️

1. Right-click on any web image

2. Select "Save Image to Blinko"

3. Image link will be saved in Markdown format

4. Option to include original page link

### 🛠️ Custom Settings

#### Prompt Template 📝

Customize summary prompt template using `{content}` as placeholder for web content. Default template provides structured summary format including:

- Title and topic overview

- Core content summary

- Key information extraction

- One-sentence summary

#### Tag Settings 🏷️

- **Summary Tag**: Default tag for page summaries (e.g., #web/summary)

- **Selection Tag**: Default tag for selected text (e.g., #web/excerpt)

- **Image Tag**: Default tag for saved images (e.g., #web/image)

#### URL Include Options 🔗

Configure whether to include source URLs for page summaries, text selections, and image saves. When enabled, links are added in Markdown format.

#### Jina Reader Settings 🔍

- **API Key**: Optional Jina Reader API key for faster content extraction

- **Save Image Links**: Toggle whether to include image links in extracted content

- **Extract Tag**: Default tag for extracted content (e.g., #web/extract)

### 🎈 Floating Ball

The floating ball provides quick access to core features:

- Left-click: Generate AI summary of current page

- Right-click: Extract clean content using Jina Reader

- Drag to reposition

- Different loading animations for different operations (green for summary, purple for extraction)

## ❗ Troubleshooting

1. **Cannot Extract Content** 🚫

   - Ensure page is fully loaded

   - Check for necessary permissions

   - Look for errors in console

2. **AI Service Not Responding** 🤖

   - Verify API key is correct

   - Check model URL accessibility

   - Confirm API usage limits

3. **Save Failed** ❌

   - Confirm target URL is correct

   - Verify auth key is valid

   - Check network connection