Kicad Diff

Dependencies

Installing dependencies on Windows

:: Enalbe Windows Sybsystem for Linux (using Power Shell)
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
#Install-WindowsFeature -Name Microsoft-Windows-Subsystem-Linux
:: Install Ubuntu 20.04
Invoke-WebRequest -Uri https://aka.ms/wsl-ubuntu-2004 -OutFile ~/Downloads/ubuntu-2004.zip
New-Item -Path C:\ubuntu-2004 -ItemType Directory
Expand-Archive -Path ~/Downloads/ubuntu-2004.zip C:\ubuntu-2004
Set-Location C:\ubuntu-2004
& .\ubuntu1804.exe

Installing dependencies on Linux

# Basic dependencies
sudo apt install -y libgmp-dev
sudo apt install -y pkg-config
sudo apt install -y opam
sudo apt install -y python3-pip
sudo apt install -y python3-tk
sudo apt install -y kicad
# Initialize opam
opam init --disable-sandboxing --reinit
opam switch create 4.09.1
opam switch 4.09.1
eval $(opam env)
# Install custom plotgitsch
git clone https://github.com/leoheck/plotkicadsch.git
cd plotkicadsch
./install.sh
# Kicad-Diff dependencies
pip3 install pygubu
pip3 install python_dateutil
# Install Kicad-Diff
git clone https://github.com/Gasman2014/KiCad-Diff.git

Installing dependencies on OSX

brew install gsed
brew install findutils

Environment Setup (before using it)

# Load KiCad-Diff environment
cd KiCad-Diff
source ./env.sh
# Install kdiff environment
git clone https://github.com/leoheck/kdiff
cd kdiff
# Load kdiff environment
source ./env.sh

Using

cd [kicad_git_repo]
kdiff board.kicad_pcb

Command line flags (Help)

➜ kdiff -h
USAGE :
 kdiff [OPTIONS] KICAD_PROJECT_FILE
OPTIONS:
 -a Track all commits (slower).
 -o HASH Show commits starting from this one.
 -n HASH Show commits until this one delimited by this one.
 -r Remove kidiff folder before run
 -l Do not launch browser at the end
 -p PORT Set webserver port
 -V Verbose
 -h This help
EXAMPLES:
 # Kicad project on the root of the repo
 kdiff board.pro
 # Nested Kicad projects 
 kdiff nested-project/board.pro -r -V

Examples