119 lines
3.7 KiB
Markdown
119 lines
3.7 KiB
Markdown
# CrowdProof Observe (Chrome)
|
|
|
|
A Chrome browser extension for quickly submitting observations to your CrowdProof instance.
|
|
|
|
## Features
|
|
|
|
- **Side Panel Interface** - Submit observations without leaving your current page
|
|
- **Multiple Observation Types** - Photos, URLs, emails (.msg/.eml), logs, and statements
|
|
- **Quick Capture** - Right-click images or links to send directly to CrowdProof
|
|
- **Paste to Submit** - Paste screenshots directly from clipboard
|
|
- **Access Management** - Set public access levels for your observations
|
|
- **Theme Integration** - Adapts to system light/dark mode
|
|
|
|
## Installation
|
|
|
|
### From Chrome Web Store (Recommended)
|
|
Visit the [Chrome Web Store page](#) and click "Add to Chrome".
|
|
|
|
### Manual Installation (Development)
|
|
1. Open Chrome and navigate to `chrome://extensions`
|
|
2. Enable "Developer mode" in the top right
|
|
3. Click "Load unpacked"
|
|
4. Select this directory
|
|
|
|
## Usage
|
|
|
|
### Initial Setup
|
|
1. Click the CrowdProof Observe icon in the toolbar to open the side panel
|
|
2. The extension defaults to `https://crowdproof.silogroup.org`
|
|
3. To use a different instance, click "Settings" and enter your server URL
|
|
4. Log in with your CrowdProof credentials
|
|
|
|
### Submitting Observations
|
|
|
|
**Photos:**
|
|
- Select a file using the file picker, OR
|
|
- Click the paste zone and press Ctrl+V to paste from clipboard, OR
|
|
- Right-click any image on a webpage and select "Send Image to CrowdProof"
|
|
|
|
**URLs:**
|
|
- Click "Capture Current Page" to grab the active tab's URL, OR
|
|
- Enter a URL manually, OR
|
|
- Right-click any link and select "Send Link to CrowdProof"
|
|
|
|
**Emails:**
|
|
- Select a .msg or .eml file, OR
|
|
- Drag and drop an email file onto the drop zone
|
|
|
|
**Logs & Statements:**
|
|
- Fill in the form fields and submit
|
|
|
|
### Managing Access
|
|
Click the "Access" button to view your observations and set public access levels:
|
|
- **None** - Only explicitly added users can access
|
|
- **Editor** - All active CrowdProof users can view and edit
|
|
- **Viewer** - All active CrowdProof users can view only
|
|
|
|
## Development
|
|
|
|
### Project Structure
|
|
```
|
|
crowdproof-observe-chrome/
|
|
├── manifest.json # Extension manifest (MV3)
|
|
├── background/
|
|
│ └── background.js # Service worker for context menus
|
|
├── sidepanel/
|
|
│ ├── sidepanel.html # Side panel UI structure
|
|
│ ├── sidepanel.css # Side panel styles
|
|
│ └── sidepanel.js # Side panel logic
|
|
├── options/
|
|
│ ├── options.html # Options page
|
|
│ └── options.js # Options logic
|
|
├── icons/ # Extension icons
|
|
├── README.md # This file
|
|
└── CWS/ # Chrome Web Store submission info
|
|
```
|
|
|
|
### Building
|
|
No build step required. The extension runs directly from source.
|
|
|
|
### Testing
|
|
1. Load the extension via `chrome://extensions` (Developer mode)
|
|
2. Make changes to source files
|
|
3. Click the refresh icon on the extension card to reload
|
|
|
|
### Packaging
|
|
```bash
|
|
cd crowdproof-observe-chrome
|
|
zip -r crowdproof-observe-chrome.zip . -x "*.git*" -x "CWS/*" -x "CWS" -x "*.md"
|
|
```
|
|
|
|
## Permissions
|
|
|
|
| Permission | Purpose |
|
|
|------------|---------|
|
|
| `storage` | Store configured server URL |
|
|
| `activeTab` | Capture current page URL/title |
|
|
| `cookies` | Maintain server authentication |
|
|
| `contextMenus` | Right-click menu integration |
|
|
| `sidePanel` | Native side panel UI |
|
|
| `<all_urls>` | Connect to user-configured servers |
|
|
|
|
## Privacy
|
|
|
|
- No data collection or third-party transmission
|
|
- Communicates only with your configured CrowdProof server
|
|
- No analytics or tracking
|
|
|
|
See [CWS/CWS.md](CWS/CWS.md) for the full privacy policy.
|
|
|
|
## Support
|
|
|
|
- **Email:** crowdproof-support@silogroup.org
|
|
- **Homepage:** https://crowdproof.silogroup.org
|
|
|
|
## License
|
|
|
|
Copyright SILO GROUP. All rights reserved.
|