# 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.