Introduction

The watermarker script provides a convenient way to watermark more than one image. It was created to make easier to watermark images, because it can take a lot of time if you have more than one image.

Video tutorial

Installation

Use out of the box

You can use this script without installing it. You can run binary file (.exe) or source file (.py).

Binary file

1. Download watermarker.exe and save it anywhere you like.
2. Run it with :

   watermarker.exe <arguments>
   

Source file

1. Install python
2. Install python dependencies with

   pip install pillow
   

3. Download repository and save it anywhere you like.
4. Run script with:

   python watermarker.py <arguments>
   

Generate binary from source

1. Follow above steps for source code.
2. Install python installer with instructions.
3. Run generate.bat to create binary file, which will be saved to dist folder.

Install on your device

1. Create folder Watermarker in Program Files.
2. Download watermarker.exe and save it to Watermarker folder.
3. Add location of Watermarker folder to PATH variable.

Examples

Here are some examples that will help you start. Note that there are different way to call watermarker script, examples use watermarker.exe.

Arguments

Argument	Description
-h,--help	Prints help
-V,--version	Prints version
-v,--verbose	Enables verbose mode
-i <path>,--input=<path>	Path of input file or directory
-o <path>,--output=<path>	Path of output file or directory, if input is file, then output also must be file, same for directory
-O,--overwrite	Automaticly overwrite existing files
--allowext=<extension1>,<extension2>	Select file extensions which files will be watermarked. By default png and jpg.
--width=<new width>	Resize image to new width
--height=<new height>	Resize image to new height
--preview	Show image before saving
--ask-to-save	Ask if we want image to be saved
--wpos=<corner>	Set corner where watermark will be, available corners LU - LeftUpperCorner,L - LeftCorner, LD - LeftDownCorner,RU - RightUpperCorner,R - RightCorner,RD - RightDownCorner, U - UpperCorner,D - DownCorner
--wposm=<margin_px>	Set margin from border for logo in px, use with --wpos
--wposx=<x_coord_px>	X coordinate of watermark position
--wposy=<y_coord_px>	Y coordinate of watermark position
--wimage=<image_path>	Path to watermark image
--wwidth=<new width>	Resize watermark to new width
--wheight=<new height>	Resize watermark to new height
--wtext=<watermark text>	Watermark text
--wcolor=<text color>	Text color, valid formats are #rrggbb,rgb(r,g,b),#rgb,hsl(hue,saturation%,lightness%),color_name
--wfont=<path_to_ttf>	Path to font file
--wfsize=<font size pt>	Text font size

Print version

watermarker --version

Get help

watermarker --help

Watermark image with image (basic example - choose corner)

Here is basic example. We set input file and output file which can be omitted, then it would overwrite input file. We also set watermark which can be image (--wimage) or text (--wtext). We must also specify position of watermark. We set in which corner watermark should be with --wpos and margins from borders with --wposm. Watermark images show be PNG in RGBA format if posible.

watermarker --input=input_image.jpg --output=output_image.jpg --wimage watermark_image.png --wpos=LD --wposm 10 --verbose

Watermark image with image (extended example - choose position)

What is different to previous example is that here we specify absolute position of watermark with --wposx and --wposy. Note that x=0,y=0 is in left upper corner.

watermarker --input=input_image.jpg --output=output_image.jpg --wimage watermark_image.png --wposx=10 --wposy=10 --verbose

Watermark image with text (basic example)

Here we watermark images with text instead of images. We use --wtext. We can also change color of text with --wcolor. We can specify color in differen formats eg. red,#ff0000,rgb(255,0,0) and more. Also there is option to change text size --wfsize.

watermarker --input=input_image.jpg --output=output_image.jpg --wtext Test --wpos U --wposm 100 --wcolor=red --wfsize=32 --verbose

Watermark image with text (extended example)

By default program uses Roboto font, but you can specify different TTF file with --wfont.

watermarker --input=input_image.jpg --output=output_image.jpg --wtext Test --wpos U --wposm 100 --wcolor=red --wfsize=32 --wfont="fonts/Roboto-Regular.ttf" --verbose

Watermark images in directory

What is different ? Just specify directories instead of files, script will recursively search for images and watermark them by paramaters you set.