Getting Started

Download and Install

  • You can download the latest ScanCode Workbench release for your Windows, OS X or Linux operating system from the ScanCode Workbench releases page. Once downloaded, you’ll find the ScanCode Workbench executable in the ScanCode-Workbench-<os>-x64-<version> folder. On Windows 10, for example, the executable will be named ScanCode-Workbench.exe.

  • If you’re interested in digging into the code, you can also use ScanCode Workbench by cloning the GitHub repository and building it yourself – see the Contribute/Building section for details.

ScanCode Workbench-ScanCode Toolkit Compatibility

  • ScanCode Workbench >= v3.1.1 is only compatible with scans from ScanCode v3.1.1 and above that have been run with the ScanCode Toolkit -i option.

  • You would typically create your scan with the following command: ./scancode -clipeu <input> <output_file>

Open ScanCode Workbench and Load a ScanCode Toolkit Scan

  • Double-click the ScanCode Workbench executable you downloaded. You’ll probably want to maximize the application once it has opened.

  • Import your JSON scan file and save it as a SQLite file (ScanCode Workbench works with the data in a SQLite database).

    • File > Import JSON File (Ctrl + I) ==> opens Open a JSON File window.

    • Select your JSON scan and click Open ==> opens Save a SQLite Database File window.

    • Keep or modify the default SQLite filename and click Save.

  • You’re now looking at your scan data displayed in the Table View – the Table View itself is on the right, and the Directory Tree (which is visible in all views) is on the left.

    ../_images/initial_load_getting_started.png

    Your first imported ScanCode Toolkit Scan.

You can find additional details in the How-To Guides section below.

Try a Sample Scan

We’ve also provided a set of sample scans that you can review in ScanCode Workbench in order to get a sense of its functionality and the types of information captured by a scan.