Quick-add observations to your CrowdProof instance. Submit photos, URLs, emails, logs, and statements directly from your browser sidebar.

Go to file

Chris Punches b954a60a58 added AMO dir for submission to keep it all separated		2025-12-30 04:51:39 -05:00
AMO	added AMO dir for submission to keep it all separated	2025-12-30 04:50:47 -05:00
background	first commit	2025-12-30 04:34:38 -05:00
icons	fixed id and icons	2025-12-30 04:46:37 -05:00
options	first commit	2025-12-30 04:34:38 -05:00
sidebar	first commit	2025-12-30 04:34:38 -05:00
README.md	added AMO dir for submission to keep it all separated	2025-12-30 04:51:39 -05:00
manifest.json	fixed id and icons	2025-12-30 04:46:37 -05:00

README.md

CrowdProof Observe

A Firefox browser extension for quickly submitting observations to your CrowdProof instance.

Features

Sidebar 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 your Firefox theme

Installation

From Firefox Add-ons (Recommended)

Visit the Firefox Add-ons page and click "Add to Firefox".

Manual Installation (Development)

Open Firefox and navigate to about:debugging
Click "This Firefox" in the sidebar
Click "Load Temporary Add-on"
Select the manifest.json file from this directory

Usage

Initial Setup

Click the CrowdProof Observe icon in the toolbar to open the sidebar
The extension defaults to https://crowdproof.silogroup.org
To use a different instance, click "Settings" and enter your server URL
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/
├── manifest.json        # Extension manifest
├── background/
│   └── background.js    # Context menu and background tasks
├── sidebar/
│   ├── sidebar.html     # Sidebar UI structure
│   ├── sidebar.css      # Sidebar styles
│   └── sidebar.js       # Sidebar logic
├── options/
│   ├── options.html     # Options page
│   └── options.js       # Options logic
├── icons/               # Extension icons
├── README.md            # This file
└── AMO/AMO.md               # Firefox Add-ons submission info

Building

No build step required. The extension runs directly from source.

Testing

Load the extension temporarily via about:debugging
Make changes to source files
Click "Reload" in about:debugging to apply changes

Packaging

cd crowdproof-observe
zip -r crowdproof-observe.zip . -x "*.git*" -x "*.md"

Permissions

Permission	Purpose
`storage`	Store configured server URL
`activeTab`	Capture current page URL/title
`cookies`	Maintain server authentication
`theme`	Match Firefox theme colors
`contextMenus`	Right-click menu integration
`menus`	Access clicked elements for capture
`<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 AMO/AMO.md for the full privacy policy.

Support

Email: crowdproof-support@silogroup.org
Homepage: https://crowdproof.silogroup.org