lensight 1.0.1

A command-line tool for embedding camera metadata and shooting details into photos.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

<div align="center">
  <img src="docs/lensight_logo.jpg" alt="Lensight Logo" width="128" height="128" style="border-radius: 32px">
  <br>
  <a href="https://github.com/AngelMsger/lensight/actions/workflows/ci.yml">
    <img src="https://github.com/AngelMsger/lensight/actions/workflows/ci.yml/badge.svg" alt="Build Status">
  </a>
</div>

# Lensight

A command-line tool for embedding camera metadata and shooting details into photos.

## Features

- Embed camera metadata and shooting details into photos
- Support for both single image and batch processing
- Native support for major camera manufacturers (Canon, Nikon, Sony, Fujifilm, Panasonic)
- Optional 16:9 aspect ratio output for video platforms
- Custom logo support
- Configurable information bar height with adaptive font and logo sizing

## Installation

### From Source

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

### From crates.io

```bash
cargo install lensight
```

## Usage

### Basic Commands

#### Single Image Processing

```bash
lensight input.jpg output.jpg
```

#### Batch Processing

```bash
lensight ./input_directory ./output_directory
```

### Advanced Options

#### Force 16:9 Aspect Ratio

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

#### Custom Information Bar Height

```bash
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:

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

## Examples

Original image:
![Original](docs/IMG_0197.jpg)

Processed result:
![Processed](docs/IMG_0197_info.jpg)

16:9 aspect ratio result:
![16:9 Result](docs/IMG_0197_info_16_9.jpg)

> Note: The sample images in the repository have been compressed and their EXIF data removed for preview purposes. Please use your own images for testing.

## Related Projects

- [**camera-watermark**](https://github.com/dearDreamWeb/camera-watermark): Lensight utilizes the logo files organized by this project.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.