nlbn 1.0.25 - Docs.rs

Features

Convert symbols, footprints, and 3D models
Batch processing with parallel downloads
Standalone binary - no dependencies required
Low memory usage

Installation

Option 1: Download Pre-built Binary

Windows: nlbn-windows-x86_64.exe.zip
Linux: nlbn-linux-x86_64.tar.gz
macOS: nlbn-macos-x86_64.tar.gz or nlbn-macos-aarch64.tar.gz

Option 2: Install from crates.io

cargo install nlbn

Option 3: Build from Source

git clone https://github.com/linkyourbin/nlbn.git
cd nlbn
cargo build --release

Quick Start

Single Component

# Convert everything (symbol + footprint + 3D model)
nlbn --full --lcsc-id C2040

# Convert only symbol
nlbn --symbol --lcsc-id C2040

Batch Processing

# Create a file with LCSC IDs (one per line)
echo "C2040" > components.txt
echo "C529356" >> components.txt

# Batch convert with 8 parallel threads
nlbn --full --batch components.txt --parallel 8

# Continue on errors
nlbn --full --batch components.txt --parallel 8 --continue-on-error

Usage

nlbn [OPTIONS]

Options:
  --lcsc-id <ID>          LCSC component ID (e.g., C2040)
  --batch <FILE>          Batch mode: read IDs from file
  --symbol                Convert symbol only
  --footprint             Convert footprint only
  --3d                    Convert 3D model only
  --full                  Convert all (symbol + footprint + 3D)
  -o, --output <PATH>     Output directory [default: .]
  --parallel <N>          Parallel threads for batch mode [default: 4]
  --continue-on-error     Skip failed components in batch mode
  --overwrite             Overwrite existing components
  --v5                    Use KiCad v5 legacy format
  --debug                 Enable debug logging
  -h, --help              Print help

Output

output/
├── nlbn.kicad_sym              # Symbol library
├── nlbn.pretty/                # Footprint library
│   └── Component_Name.kicad_mod
└── nlbn.3dshapes/              # 3D model library
    └── Component_Name.step

Symbol

Footprint

3D Model

Examples

# High-performance batch conversion
nlbn --full --batch components.txt --parallel 16 -o ./library

# Resume interrupted batch (skip existing)
nlbn --full --batch components.txt --continue-on-error

# KiCad v5 format
nlbn --full --lcsc-id C529356 --v5

License

This work is licensed under CC BY-NC 4.0. You are free to share and adapt this work for non-commercial purposes with attribution.