https://github.com/kualta/logo
cli to add logo to images
https://github.com/kualta/logo
cli image-processing rust
Last synced: 5 months ago
JSON representation
cli to add logo to images
- Host: GitHub
- URL: https://github.com/kualta/logo
- Owner: kualta
- License: mit
- Created: 2024-10-27T14:43:43.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-11-01T16:04:45.000Z (over 1 year ago)
- Last Synced: 2025-10-09T00:41:50.504Z (9 months ago)
- Topics: cli, image-processing, rust
- Language: Rust
- Homepage:
- Size: 891 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# logo
A command-line tool for overlaying logos on images with precise control over size and position.
## Features
- Add a logo to any image
- Control logo size as a percentage of the base image
- Choose logo position (top-right, top-left, bottom-right, bottom-left)
- Maintains logo aspect ratio
- Supports various image formats (PNG, JPEG, etc.)
## Installation
### Using Cargo (Recommended)
If you have Rust installed, you can install directly from crates.io:
```bash
cargo install ku-logo
```
### Manual Installation
1. Download the latest release for your platform from the [releases page](https://github.com/kualta/logo/releases)
2. Extract the archive
3. Add the binary to your PATH
For development setup, see the [Development Setup](#development-setup) section.
### Development Setup
To set up the development environment, we use [devenv.sh](https://devenv.sh/). This ensures a consistent development experience across different platforms.
1. Install `devenv` following the instructions at [devenv.sh/getting-started](https://devenv.sh/getting-started/)
2. Clone the repository:
```bash
git clone https://github.com/kualta/logo.git
cd logo
```
3. Initialize the development environment:
```bash
devenv init
```
4. Enter the development shell:
```bash
devenv shell
```
This will set up all required dependencies, including:
- Rust toolchain and cargo
- Cross-compilation tools
- Required system libraries
#### Available Scripts
- `hello` - Test the development environment
- `build-linux` - Build release binary for Linux
Run scripts using:
```bash
devenv run
```
## Usage
```bash
# Basic usage with default settings (5% size, top-right position)
logo -i input.png -l logo.png -o output.png
# Specify size and position
logo -i input.png -l logo.png -p 10 --position bottom-left -o output.png
# Show help
logo --help
```
### Options
- `-i, --image ` - Path to the base image
- `-l, --logo ` - Path to the logo image
- `-p, --percentage ` - Logo size as percentage (default: 5%)
- `--position ` - Logo position (top-right, top-left, bottom-right, bottom-left)
- `-o, --output ` - Output path for the resulting image
## License
This project is licensed under the MIT License - see the LICENSE file for details.