ScanCode Workbench provides an advanced visual UI to help you quickly evaluate license and other notices identified by ScanCode. ScanCode detects licenses, copyrights and other interesting information in your code.

ScanCode Workbench is based on Electron and will be the primary desktop/GUI tool for using nexB’s AboutCode tools. This app works on Windows, macOS and Linux operating systems.

Using

• You can download the latest release for your operating system or build it yourself (see below). Once downloaded, you can find ScanCode-Workbench under dist/ScanCode-Workbench-<os>-<arch>-<version>
• ScanCode Workbench >= v4 is only compatible with scans from ScanCode v32.0.0 and above which are run with the ScanCode -i option. For a list of available ScanCode options see How To: Set what will be detected in a scan

scancode -clipeu <input> <output_file>

• We have provided a set of sample scans that you can quickly review in ScanCode Workbench in order to get a sense of its functionality and the types of information captured by a scan. The samples are located at https://github.com/aboutcode-org/scancode-workbench/tree/develop/samples.
• Import a ScanCode JSON file, and see what components are in your software! See the documentation for more information on how to use ScanCode Workbench.

Import a JSON file

Running locally

You'll need Node.js (which comes with npm) installed on your computer in order to build this app. For a list of platform specific requirements, see the Building section of the documentation. Then, from your command line:

# Clone this repository
$ git clone https://github.com/aboutcode-org/scancode-workbench.git

# Go into the repository
$ cd scancode-workbench

# Install dependencies and run the app
$ npm install

# Run the app
$ npm start

Release Instructions

You'll need python 3.x to run the build. You can build a dist directory containing executables for your platform

Note: Due to usage of native modules, a build must be done on target platform only.

$ npm run publish

You can find the executible ScanCode-Workbench-<version> inside out/ScanCode-Workbench-<version>-<os>-<arch> and distributable archive (.tar.gz or .zip) in dist/

Testing

Run tests using:

$ npm test

License

• Apache-2.0
• Multiple licenses (LGPL, MIT, BSD, etc.) for third-party components.

See the NOTICE file for more details.

Support

If you have a question, a suggestion or find a bug, enter an issue.

For questions and chats, you can join the Gitter channel at https://matrix.to/#/#aboutcode-org_scancode-workbench:gitter.im