Skip to content
/ lukaj Public

Interactive diff tool for SVG images

License

Notifications You must be signed in to change notification settings

adamws/lukaj

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Interactive diff tool for SVG images.

Crates.io CI - Main License Coverage Status

Features

Swipe SVG graphics comparison with zoom and drag support.

Installation

To install precompiled version of lukaj go to latest release page and download archive for your system. Provided binaries are static executables for Windows and Linux.

If you're a Rust programmer, lukaj can be installed with cargo. It supports two graphics backends which are enabled/disabled with cargo features. The use-rsvg feature is available only when installing from source, precompiled binaries on release page include only default feature set.

Feature name SVG library 2D rendering library Precompiled binary release
use-usvg (default) resvg tiny-skia yes
use-rsvg librsvg cairo no

Depending on the operating system and selected feature set, lukaj will require additional development libraries.

On Ubuntu Linux (click to expand)
  1. When using only default use-usvg feature:

    $ sudo apt-get install libsdl2-dev
    $ cargo install lukaj
  2. When using additional use-rsvg feature:

    $ sudo apt-get install build-essential libcairo2-dev libgdk-pixbuf-2.0-dev \
        libglib2.0-dev libpango1.0-dev libsdl2-dev libxml2-dev
    $ cargo install lukaj --feature user-rsvg
On Windows (using MSYS2) (click to expand)
  1. Install MSYS2 and run from it's terminal run:

    • For default use-usvg feature:

      $ pacman -S mingw-w64-x86_64-SDL2
    • For additional use-rsvg feature:

      $ pacman -S mingw-w64-x86_64-gtk4 mingw-w64-x86_64-gettext \
          mingw-w64-x86_64-libxml2 mingw-w64-x86_64-pkgconf \
          mingw-w64-x86_64-gcc mingw-w64-x86_64-SDL2
  2. Add mingw binaries path (C:\msys64\mingw64\bin) to system Path

  3. Change default rust toolchain to stable-gnu

    rustup toolchain install stable-gnu
    rustup default stable-gnu
  4. Run cargo install command

    • For default feature only:

      $ cargo install lukaj
    • For additional use-rsvg feature:

      $ cargo install lukaj --features use-rsvg

For different setups see this GUI development with Rust and GTK4 guide.

On Mac (using homebrew) (click to expand)
brew install rust sdl2 sdl2_ttf
export LIBRARY_PATH="$LIBRARY_PATH:/opt/homebrew/lib"
cargo install lukaj

Usage

To compare two SVG files run:

$ lukaj [path 1] [path 2]

Lukaj uses following mouse/keyboard controls:

Button Action
Left Click Move diff separator
Right Click Move images
Scroll Zoom in and out
R Reset images position
Esc Exit
Complete lukaj options (click to expand)
$ lukaj --help
Interactive diff tool for SVG images

Usage: lukaj [OPTIONS] [FILES]...

Arguments:
  [FILES]...  Files to compare

  Options:
    -s, --scale <VALUE>      Sets a scaling factor
    --backend <BACKEND>      Preferred backend [default: rsvg-with-cairo]
                             [possible values: rsvg-with-cairo, usvg-with-skia]
    -h, --help               Print help
    -V, --version            Print version

Git integration

Lukaj can be used as git difftool. To add git diff-svg custom command, copy and paste following sections to .gitconfig file:

[difftool "lukaj"]
    cmd = ~/.cargo/bin/lukaj $LOCAL $REMOTE
[alias]
    diff-svg = "difftool -t lukaj -y"

Other integrations