Skip to content

spdx/spdx-license-diff

Repository files navigation

SPDX License Diff

Actions Statussemantic-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.

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

spdx-diff in action

Installation

Get it from the:

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 for support and issue reporting

Contributing

Come help out!

Credits

License

We are initially GPL-3.0-or-later but will move to Apache-2.0 as soon as we refactor the stackoverflow code.

About

Chrome/Firefox browser extension to compare text against spdx license list

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 6