brickdiff

brickdiff

Have you ever desinged a LEGO MOC with BrickLink Studio, created the wanted list to order the parts and sourced the parts, only to decide to make some changes afterwards in your digital model? How do you check what parts you now need in addition to build your MOC with the new version? That's what brickdiff is for: it allows you to "subtract" a wanted list from another one, so that you end up with a new wanted list that only contains the parts you need to make the changes.

Installation

With homebrew (Mac and Linux)

This is the easiest way to install brickdiff if you have already have homebrew installed on your Mac or Linux system.

Open a terminal and type:

brew tap geekgasm/homebrew-tap
brew install brickdiff

Note: you might get asked for a github password, but you don't actually need to provide one.

To upgrade to the latest released version later, type

brew upgrade brickdiff

Manually downloading the binary (Windows, Mac and Linux)

• Go to the latest release page and download the zip file for your platform.
• Unzip the archive
• Copy the executable (brickdiff.exe on Windows or brickdiff on Mac and Linux) to the desired location (if you have a directory for command-line tools that is included in your PATH, then this would be a good choice)
• In a cmd/Powershell/terminal window try executing it by typing brickdiff.exe (Windows) or brickdiff (Mac and Linux). It should print out a help message. (If you haven't copied the binary to a directory in your PATH you might need to specify the path where the binary is located.)

Note: you might have to allow the execution in your system settings. Refer to the general instructions for your platform.

To upgrade to the latest released version later, follow the same steps and simply replace the old version with the new one.

Usage

> brickdiff --help
A command line tool for comparing BrickLink Wanted lists

Usage:
  brickdiff [command]

Available Commands:
  add         Adds two BrickLink Wanted lists in XML format
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  intersect   Creates the intersection of two BrickLink Wanted lists in XML format
  subtract    Subtracts two BrickLink Wanted lists in XML format
  union       Creates the union of two BrickLink Wanted lists in XML format

Flags:
  -c, --clipboard        Copy output to clipboard (default true)
  -h, --help             help for brickdiff
  -m, --mulitline        Multiline output (default is compact output)
  -o, --outfile string   Name of output file (default output is to clipboard)
  -s, --stdout           Print output to console (stdout)
  -v, --version          Print version information

Use "brickdiff [command] --help" for more information about a command.

Subtracting two wanted lists

Subtracting two wanted lists is useful if you have modified your MOC digitally after already building a physical version. It allows you to easily find out which parts you need to make the changes on your physical build.

> brickdiff subtract --help
Subtracts two BrickLink Wanted lists in XML format and copies the output to the clipboard or writes it to the console or a file.
        If an item is in the first list, but not in the second, it will be unchanged
        If an item is in both lists, the quantity in the second list is subtracted from the quantity in the first,
        and if the result is >0 the item will be in the result with the remaining quantity.

Usage:
  brickdiff subtract bricklist1 bricklist2 [flags]

Aliases:
  subtract, sub, s

Flags:
  -h, --help   help for subtract

Global Flags:
  -c, --clipboard        Copy output to clipboard (default true)
  -m, --mulitline        Multiline output (default is compact output)
  -o, --outfile string   Name of output file (default output is to clipboard)
  -s, --stdout           Print output to console (stdout)

Adding two wanted lists

Adding two wanted is useful if you have digitally created parts of your MOC in separate files and now want to have a complete list for all the parts from the separate builds.

> brickdiff add --help
Adds two BrickLink Wanted lists in XML format and copies the output to the clipboard or writes it to the console or a file.
        If an item is in both lists, the quantities are added up in the result list.
        If an item is in only one list, the item will be added to the reault list.

Usage:
  brickdiff add bricklist1 bricklist2 [flags]

Aliases:
  add, a

Flags:
  -h, --help   help for add

Global Flags:
  -c, --clipboard        Copy output to clipboard (default true)
  -m, --mulitline        Multiline output (default is compact output)
  -o, --outfile string   Name of output file (default output is to clipboard)
  -s, --stdout           Print output to console (stdout)

Union of two wanted lists

Building the union of two lists can be useful if you have two variations of a MOC and want to create a list for a 2-in-1 model. With the parts of the list either of the MOCs could be built, but not both at the same time.

> brickdiff union --help
Creates the union of two BrickLink Wanted lists in XML format and copies the output to the clipboard or writes it to the console or a file.
        If an item is in both lists, the item is added with the higher quantity to the result list.
        If an item is in only one list, the item will be added to the result list.

Usage:
  brickdiff union bricklist1 bricklist2 [flags]

Aliases:
  union, u

Flags:
  -h, --help   help for union

Global Flags:
  -c, --clipboard        Copy output to clipboard (default true)
  -m, --mulitline        Multiline output (default is compact output)
  -o, --outfile string   Name of output file (default output is to clipboard)
  -s, --stdout           Print output to console (stdout)

Intersection of two wanted lists

Intersecting two lists will result in a list that only contains parts that are present in both lists with the lower quantity for the part.

> brickdiff intersect --help
Creates the intersection of two BrickLink Wanted lists in XML format and copies the output to the clipboard or writes it to the console or a file.
        If an item is in both lists, the item is added with the lower quantity to the result list.

Usage:
  brickdiff intersect bricklist1 bricklist2 [flags]

Aliases:
  intersect, int, i

Flags:
  -h, --help   help for intersect

Global Flags:
  -c, --clipboard        Copy output to clipboard (default true)
  -m, --mulitline        Multiline output (default is compact output)
  -o, --outfile string   Name of output file (default output is to clipboard)
  -s, --stdout           Print output to console (stdout)

Example

Let's assume that you have the parts for my Funny Birds: Chicken.

And now you want to change it into the Funny Birds: Rooster, which shares a lot of the same pieces with the chicken.

You want to know what pieces you would need in addition to the parts you already have for the chicken in order to build the rooster instead.

Getting the parts lists

First step is to obtain the parts list:

• For a MOC you find on Rebrickable you can go to the MOC inventory, click on Export Parts and select BrickLink XML. Copy the data from the popup window and save in into a file on your computer.
• For a wanted list you already have in your BrickLink Account, select the desired wanted list and click on Download to save the XML file to your computer.
• For a MOC you have created in BrickLink Studio select File ➔ Export As ➔ Export as WL xml..., select a name and location, and save the file.

In the examples folder of this repository, you will find the parts list for the chicken and the rooster, so that you can more easily try this out.

Subtracting the parts list

If you want to know now what additional parts you need to build the rooster, you use the brickdiff tool to simply subtract the chicken list from the rooster list by typing the following command in a terminal/cmd window:

brickdiff subtract examples/rooster.xml examples/chicken.xml

(Note: on Windows use the backslash "\" instead of the forward slash "/" to separate the folder names)

You should see an output like:

Output copied to clipboard.

Uploading the parts list to BrickLink

To create the new wanted list with the result:

1. Go to the BrickLink Wanted List Upload Page
2. Click on Upload BrickLink XML format
3. Select a wanted list you want to add the parts to or select Create New Wanted List from the dropdown and provide a name for it.
4. Click on the area which says Copy and paste here
5. Paste the content of your clipboard (Command-C on Mac, Ctrl-C on Windows, or use the context menu)
6. Click on Proceed to verify items. You should now see the list of parts with preview pictures.
7. Click on Add to Wanted List