Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danielchristianschroeter/watermark-to-image
This application inserts a watermark into images located in a specified folder.
https://github.com/danielchristianschroeter/watermark-to-image
image image-processing image-watermark image-watermarking watermark watermark-image watermark-tools watermarking
Last synced: about 1 month ago
JSON representation
This application inserts a watermark into images located in a specified folder.
- Host: GitHub
- URL: https://github.com/danielchristianschroeter/watermark-to-image
- Owner: danielchristianschroeter
- License: apache-2.0
- Created: 2022-12-28T23:47:59.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-21T13:07:57.000Z (4 months ago)
- Last Synced: 2024-11-19T09:55:45.437Z (3 months ago)
- Topics: image, image-processing, image-watermark, image-watermarking, watermark, watermark-image, watermark-tools, watermarking
- Language: Go
- Homepage:
- Size: 12.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# watermark-to-image
Watermark-to-Image is a command-line application for inserting watermarks into images located in a specified folder. It supports various customization options.
## Table of Contents
- [Examples](#examples)
- [Usage](#usage)
- [Clone and Build](#clone-and-build)
- [Command Line Parameters](#command-line-parameters)
- [Download Executables](#download-executables)
- [License](#license)
# Examples
You can see the application in action by examining the following images:
| Original image | Watermarked image |
| :----------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------: |
|  |  |
|  |  |
## Usage
1. Build or download the prebuilt executable.
2. Execute the following command in your terminal:
```shell
./watermark-to-image -sourceDirectory ./examples/original_images -targetDirectory ./examples/watermarked_images -watermarkImageFile ./examples/watermark.png
```
## Clone and Build
You can also clone the project and build it locally. Here are the steps:
```shell
$ git clone https://github.com/danielchristianschroeter/watermark-to-image
$ cd watermark-to-image
$ go build .
```
## Command Line Parameters
The application supports various command-line parameters for customization. Here is a list of all available parameters:
```shell
./watermark-to-image --help
-sourceDirectory string
Set the source directory for original images (required).
-targetDirectory string
Set the target directory for watermarked images (required).
-targetWatermarkedImageFilename string
Rename all target files to the specified filename.
-targetWatermarkedImageFilenameSuffix string
Set the dynamic suffix for the filename defined in 'targetWatermarkedImageFilename'. Allowed values are '3DIGITSCOUNT' (3-digit enumeration count) or 'RAND' (random 6-digit number). Default is '3DIGITSCOUNT'. (default "3DIGITSCOUNT")
-targetWatermarkedImageHeight int
Resize the target watermarked image to the specified height (in pixels). Aspect ratio will be preserved if 'targetWatermarkedImageWidth' is empty.
-targetWatermarkedImageMaxDimension int
Specify the maximum dimension size for the target watermarked image. Use 0 to maintain the aspect ratio. Default is 0.
-targetWatermarkedImageWidth int
Resize the target watermarked image to the specified width (in pixels). Aspect ratio will be preserved if 'targetWatermarkedImageHeight' is empty.
-watermarkImageFile string
Specify the path and name of the watermark PNG image file (required).
-watermarkScaleFactor float
Set the scale factor for the watermark image (in percentage). (default 100)
-watermarkMarginBottom int
Set the margin from the bottom edge for the watermark (in pixels). (default 20)
-watermarkMarginRight int
Set the margin from the right edge for the watermark (in pixels). (default 20)
-watermarkOpacity float
Set the opacity/transparency of the watermark image (0.0 to 1.0). (default 0.5)
```
## Download Executables
You can download prebuilt executables for various operating systems from the [Releases](https://github.com/danielchristianschroeter/watermark-to-image/releases) page.
_Note for macOS users: Due to the application not being officially signed, it may need to be manually approved under your system's security settings._
## License
This project is licensed under the [Apache License 2.0](LICENSE). The Apache License 2.0 is a permissive open-source license that provides comprehensive legal protections for contributors and users of the software. You are free to use, modify, and distribute this software according to the terms of the Apache License 2.0.