https://github.com/spdx/spdx-license-diff
Chrome/Firefox browser extension to compare text against spdx license list
https://github.com/spdx/spdx-license-diff
chrome firefox hacktoberfest license-compliance open-source-licenses spdx
Last synced: 4 months ago
JSON representation
Chrome/Firefox browser extension to compare text against spdx license list
- Host: GitHub
- URL: https://github.com/spdx/spdx-license-diff
- Owner: spdx
- License: gpl-3.0
- Created: 2018-04-15T04:41:03.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-11-27T20:02:46.000Z (7 months ago)
- Last Synced: 2025-11-30T11:28:18.935Z (7 months ago)
- Topics: chrome, firefox, hacktoberfest, license-compliance, open-source-licenses, spdx
- Language: JavaScript
- Homepage:
- Size: 5.43 MB
- Stars: 39
- Watchers: 4
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# SPDX License Diff
[](https://github.com/spdx/spdx-license-diff/actions)[](https://github.com/semantic-release/semantic-release)
Diff selected text against SPDX licenses and find the best match. This extension creates a browser button in Chrome, Firefox, Edge, and Opera to compare any selected text against the SPDX [License List](https://spdx.org/licenses/).
**✨ Now supports Manifest V3** for enhanced security and performance in modern browsers with full cross-browser compatibility.
The SPDX License List is a list of commonly found licenses and exceptions used in free and open source and other collaborative software or documentation. The purpose of the SPDX License List is to enable easy and efficient identification of such licenses and exceptions in an SPDX document, in source files or elsewhere. The SPDX License List includes a standardized short identifier, full name, vetted license text including matching guidelines markup as appropriate, and a canonical permanent URL for each license and exception.
# Installation
Get it from the:
- [Chrome Web Store](https://chrome.google.com/webstore/detail/spdx-diff/kfoadicmilbgnicoldjmccpaicejacdh) (Chrome, Edge)
- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/spdx-license-diff) (Firefox)
- Opera Add-ons (Opera - via Chrome Web Store or sideloading)
## Browser Compatibility
This extension is fully compatible with:
- **Chrome** (Manifest V3 with offscreen documents)
- **Firefox** (Manifest V3 with worker fallback)
- **Microsoft Edge** (Manifest V3 with offscreen documents)
- **Opera** (Manifest V3 with offscreen documents)
## Permissions
The extension requires access to SPDX.org to download the latest license data. When you first use the extension, you may be asked to grant permission to access SPDX.org. This is required for the extension to function properly.
### Granting Permissions
If you see a "Permission denied" error, please grant access to SPDX.org:
#### Chrome, Edge, Opera:
1. Go to your browser's Extensions page: `chrome://extensions/`
2. Find "SPDX License Diff" and click "Details"
3. Click "Site access" or "Permissions"
4. Allow access to `spdx.org`
#### Firefox:
1. Go to Firefox Add-ons: `about:addons`
2. Find "SPDX License Diff" and click on it
3. Go to the "Permissions" tab
4. Enable "Access your data for sites in the spdx.org domain"
**Note**: Due to browser security models, host permissions cannot be granted automatically. The extension will display helpful error messages with specific instructions for your browser when permissions are needed.
### Troubleshooting
- **Permission errors**: The extension will show browser-specific instructions when SPDX.org access is needed
- **Update failures**: Check that SPDX.org permissions are granted in your browser settings
- **Need help?**: Visit the [official repository](https://github.com/spdx/spdx-license-diff/) for support and issue reporting
# Contributing
[Come help out!](CONTRIBUTING.md)
# Credits
- Scaffolding from [webextension-toolbox](https://github.com/HaNdTriX/webextension-toolbox)
- See [third-party licenses](oss-attribution/attribution.txt) for production attribution.
# License
We are initially [GPL-3.0-or-later](LICENSE) but will move to Apache-2.0 as soon as we [refactor the stackoverflow code](https://github.com/spdx/spdx-license-diff/issues/7).