How to Visualize Scan results

In this simple tutorial example, we import results from a basic scan performed on the samples directory distributed by default with Scancode, and visualize the outputs through Scancode Workbench.


This tutorial uses the 3.1.1 version of Scancode Toolkit, and Scancode Workbench 3.1.0 (This beta version of ScanCode Workbench is compatible with scans from any ScanCode Toolkit develop version/branch at or after v3.0.2). If you are using an older version of Scancode Toolkit, check respective versions of this documentation. Also refer the Scancode Workbench release highlights.


This tutorial is for Linux based systems presently. Additional Help for Windows/MacOS will be added.

Setting up Scancode Workbench

According to the Installation instructions for the Workbench, we have to install Node.js 6.x or later. Refer to Node.js install instructions here.

You can also run the following commands:

sudo apt-get install -y nodejs
sudo npm install npm@5.2.0 -g

After Node.js and npm is installed and get the Scancode Workbench 3.1.0 tarball from the Workbench Release Page. Extract the package and then launch Scancode Workbench:


This opens the Workbench.


You can also build Scancode Toolkit and Scancode Workbench from source. Clone the repository, don’t forget to checkout to the specific release using git checkout <release>, and follow the build instructions. You will ll also have to create a Python virtual environment.

Importing Data into Scancode Workbench

  1. Click on the File -> Import JSON File or Press Ctrl + I.

  2. Select the file from the pop-up window.

  3. Select a Name and Location (where you want it later) for the .sqlite output file.


You can also import a .sqlite file you’ve saved in the past to load scan results. As it is much faster, once you’ve imported the JSON file and a corresponding SQLite file has been created, you shouldn’t repeat this. Instead, import the SQLite file next time you want to visualize the same scan result.



Refer to the workbench documentation for more information on Visualization.

The dashboard has a general overview.


There are three main views (They appear in the same order in the GIFs):

  • Chart Summary View,

  • Table View,

  • Components Summary View.



You can also click any file/directory on the file list located on the right, to filter the results such that it only contains results from that File/Directory.



Refer How-To: Create Conclusions for more information on Components.

In the table view,

  1. Apply filters by selecting Files/Directories

  2. Right Click on the Left Panel

  3. Select Edit Component

  4. A pop-up opens with fields, make necessary edits and Save.

  5. Go to the Component Summary View to see the Component.