#spdx #licensing #command-line-tool #cli

app spdx-guide

A tool to help you with the creation of spdx files in your projects

5 releases

0.2.3 Oct 12, 2022
0.2.2 Sep 30, 2022
0.1.2 Sep 30, 2022
0.1.1 Sep 29, 2022
0.1.0 Sep 29, 2022

#1366 in Development tools

Download history 5/week @ 2024-02-25 75/week @ 2024-03-24 43/week @ 2024-03-31

118 downloads per month


779 lines


spdx-guide is a super simple command line tool to get you started with the creation of simple SPDX files.


What is SPDX?

SPDX is a standard for specifying software licenses and creating Software Bills of Materials (SBOMs) that give licensing information for software and its dependencies in a machine-readable format. Adding an SPDX file to your projects, especially to your libraries, helps others and contributes to the greater goal of fixing the mess that currently is open source licensing.

Goals of spdx-guide

This software was specifically created to get people who have never used or heard of SPDX to create SPDX files for their projects. spdx-guide will guide you through the creation process in an intuitive command line dialogue.

There is existing tooling for working with the SPDX framework, but from my experience none of it is aimed at complete beginners or people who want to improve their licensing situation but aren't ready to invest a lot of their time into memorising specifications or configuring their build tools.

In short, the goals of this software are to

  • enable people who do not know anything about SPDX to create SPDX files for their projects
  • provide more advanced users with a tool that creates a simple SPDX file that can later be extended with more sophisticated tools


spdx-guide will not (for now):

  • process the dependencies of your project
  • perform license detection or analysis
  • create a complete SBOM for your distributions
  • give you legal advice
  • pick a license for you


Just run spdx-guide in your project directory. See spdx-guide --help for more info.


Via Cargo

Run cargo install spdx-guide. The executable will end up in ~/.cargo/bin/, so if that is in your PATH, you will be able to use the application from anywhere.


spdx-guide is free software and licensed under the GNU General Public License version 3.0 or any later version, at your discretion.


~498K SLoC