3.7 KiB

Raw Permalink Blame History

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

3.7 KiB Raw Permalink Blame History