https://github.com/tj/letterbox
Go program to batch-process letter-boxing of photographs.
https://github.com/tj/letterbox
golang image-processing instagram photography
Last synced: 2 months ago
JSON representation
Go program to batch-process letter-boxing of photographs.
- Host: GitHub
- URL: https://github.com/tj/letterbox
- Owner: tj
- License: mit
- Created: 2019-10-22T12:13:08.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-07T02:21:23.000Z (almost 2 years ago)
- Last Synced: 2024-12-10T02:21:30.555Z (2 months ago)
- Topics: golang, image-processing, instagram, photography
- Language: Go
- Homepage:
- Size: 20.5 KB
- Stars: 168
- Watchers: 5
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: Readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Letterbox
A tiny Go program to batch-process letter-boxing of photographs.
## Installation
From [gobinaries.com](https://gobinaries.com):
```sh
$ curl -sf https://gobinaries.com/tj/letterbox/cmd/letterbox | sh
```
From source:
```
$ go get github.com/tj/letterbox/cmd/letterbox
```
## Usage
```
Usage of letterbox:
-aspect string
Output aspect ratio (default "16:9")
-concurrency int
Concurrency of image processing (default 8)
-force
Force image reprocess when it exists
-output string
Image output directory (default "processed")
-padding int
Output image padding in percentage
-quality int
Output jpeg quality (default 90)
-white
Output a white letterbox
```
## Examples
Example of 1:1
```
$ letterbox -aspect 1:1
```
Example of 4:3
```
$ letterbox -aspect 4:3
```
Example of 16:9 (the default)
```
$ letterbox -aspect 16:9
```
Example of explicitly listing images:
```
$ letterbox DSCF6719.jpg DSCF6718.jpg
```
Example of 1:1 with a white background and 6% padding:
```
$ letterbox -white -aspect 1:1 -padding 6
```
---
[](https://godoc.org/github.com/tj/letterbox)
## Sponsors
This project is sponsored by my [GitHub sponsors](https://github.com/sponsors/tj):
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/0)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/1)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/2)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/3)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/4)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/5)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/6)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/7)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/8)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/9)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/10)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/11)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/12)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/13)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/14)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/15)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/16)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/17)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/18)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/19)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/20)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/21)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/22)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/23)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/24)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/25)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/26)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/27)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/28)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/29)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/30)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/31)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/32)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/33)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/34)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/35)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/36)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/37)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/38)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/39)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/40)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/41)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/42)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/43)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/44)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/45)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/46)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/47)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/48)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/49)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/50)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/51)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/52)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/53)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/54)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/55)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/56)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/57)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/58)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/59)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/60)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/61)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/62)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/63)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/64)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/65)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/66)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/67)
[
](https://sponsors-api-u2fftug6kq-uc.a.run.app/sponsor/profile/68)