Installation

Download the package for your system from GitHub Releases:

• Windows x64: portable ZIP or installer
• macOS: Apple Silicon or Intel app bundle
• Ubuntu/compatible AMD64: Debian package

Install it and start D4 Plot. Release packages do not require Crystal or Shards. The Debian package installs declared runtime dependencies; Windows and macOS packages include native libraries.

Build from source

Install Crystal 1.21+, Shards, Git, UIng's native dependencies, HTSlib, and pkg-config.

# macOS
brew install htslib pkg-config

# Debian/Ubuntu
sudo apt install libhts-dev pkg-config

Then build:

git clone https://github.com/kojix2/d4-plot.git
cd d4-plot
shards install --frozen
shards build --release

On Windows, use MSYS2 UCRT64 with the packages in the setup action, then run:

shards install --frozen
bash scripts/build-windows.sh

Start from a terminal

bin/d4-plot sample.d4
bin/d4-plot --region chr1:1,000,000-2,000,000 sample1.d4 sample2.d4
bin/d4-plot --locale ja sample.d4

Use bin/d4-plot --help for language codes. On Windows, the source-build executable is bin/d4-plot.exe. See Start here for the UI workflow.