lensight 0.1.0

A command-line tool for adding camera information and shooting details to photos.
Documentation

Lensight

A command-line tool for adding camera information and shooting details to photos.

Features

  • Add camera information and shooting details to photos
  • Support for single image and batch processing
  • Built-in support for major camera brands (Canon, Nikon, Sony, Fujifilm, Panasonic)
  • Optional 16:9 aspect ratio output for video platforms
  • Custom logo support
  • Customizable information bar height with adaptive font and logo sizing

Installation

From Source

  1. Ensure you have Rust and Cargo installed
  2. Clone the repository:
    git clone git@github.com:AngelMsger/lensight.git
    cd lensight
    
  3. Build and install:
    cargo install --path .
    

From crates.io

cargo install lensight

Usage

Basic Commands

Single Image Processing

lensight input.jpg output.jpg

Batch Processing

lensight ./input_directory ./output_directory

Advanced Options

Force 16:9 Aspect Ratio

lensight --force-16-9 input.jpg output.jpg

Custom Information Bar Height

lensight ./input ./output --info-height 240

Custom Logo

When installed via Cargo, Lensight includes built-in logos for Canon, Nikon, Sony, Fujifilm, and Panasonic. When building from source, you can add custom logos by placing them in the logos directory with the brand name in lowercase.

To specify a custom logo file:

lensight ./input ./output --logo logos/custom.png

Examples

Original image: Original

Processed result: Processed

16:9 aspect ratio result: 16:9 Result

Note: Please do not use the sample images in the repository for testing as they have been compressed and lost their EXIF data for preview purposes.

Related Projects

License

This project is licensed under the MIT License. See the LICENSE file for details.