A friendly watermarking tool with optional GUI component.
Project description
Watermarkd
Friendly Watermarking Software with GUI option.
Watermarkd User Manual
You can find a couple of simple examples below. You are also welcome to visit this tutorial on holypython.com: How to Use Watermarkd: A Batch Watermarking Library with GUI
Installation
Watermarkd can be installed using this command:
pip install watermarkd
or
pip3 install watermarkd
Dependencies
Watermarkd is built on two Python libraries in addition to several default Python libraries. These are:
- PIL
- PySimpleGui
Please make sure these libraries are installed before using Watermarkd. You can also refer to our requirements.txt.
The Python Imaging Library (PIL) is
Copyright © 1997-2011 by Secret Labs AB
Copyright © 1995-2011 by Fredrik Lundh
Pillow is the friendly PIL fork. It is
Copyright © 2010-2020 by Alex Clark and contributors
Examples
Single File Example
With GUI Enabled
import Watermarkd as wmd
#Enable GUI & Enjoy
wmd.Spread.single(gui=True)
Working Without GUI
import Watermarkd as wmd
#Or work without GUI
wmd.Spread.single(img_path=r"c://Users/ABC/Desktop/Anniversary.jpg")
- File will be saved to Desktop under name Watermarkd.png by default.
Batch Example
import Watermarkd as wmd
#Or work without GUI
wmd.Spread.batch(folder_path=r"c://Users/ABC/Desktop/New_Photos")
- Files will be saved to Desktop/watermarkd_/ folder by default.
Functions
There are currently two functions in Watermarkd module and they both belong to Spread class. They both aim to do a good job spreading out watermark texts nicely on image file(s).
Spread.single()
single is one of the two current functions, the other being batch. It can be used to watermark a single image file.
It shares most of the same parameters with batch function with the exception of:
-img_path
which is replaced with:
-folder_path
in the batch case.
Default output file name and path are as following: r"c:/Users/"+user_path+"/Desktop/watermarkd.png"
Spread.batch()
batch the other function can be used to watermark a folder of images at once. This option can be useful for people who has to deal with watermarking images in large amounts and in high frequency.
Currently batch function is missing the GUI component which should be ready soon.
Default output file name and path are as following:
Output Path: r"c:/Users/"+user_path+"/Desktop/watermarkd_/"
Output File: 1.png, 2.png, 3.png, 4.png and so on.
Parameters
- gui, (default=False) : Opens graphical user interface when True
- img_path: Image's Path and Name for Watermarking
- folder_path : For Batch Operation, Folder's Path for Watermarking
- wm_text, (default= Watermarkd) : Watermark Text
- wm_trans, (default= 85) : Watermark Transparency
- font_size, (default= 55) : Watermark Font Size
- font_name, (default= "arial.ttf") : Font Type
- filename, (default="Watermarkd") : Saving File Name
- save_to_path, (default="Desktop/watermarkd_"): Saving Folder Path
- save_to_suffix, (default=".png") : Saving File Type
- output_filename, (default= r"c:/Users/"+user_path+"/Desktop/watermarkd.png") : Watermarked File Name When Saving Single File
Use Cases
Although watermarking technology existed long before digital technologies (on money, stamps and special documents), its use cases reached astronomical levels with the revolution of digital imaging brought about in the last couple of decades.
Watermarkd aims to help users do watermarking in the most practical sense, without having to open resource heavy Photo Editors. You can probably be done with Watermarking all together via Watermarkd in the time that it takes for a traditional Image Editing Software to load up in most computers.
Through photos, watermarking can be used to:
- Communicate contact information
- Advertise
- Share artist info
- Share owner info
- Imply Confidentiality
- Imply Sensitivity
- Post instructions
- Notify of copyright etc.
It's expected to be dominantly used by:
- Professional photographers
- Illustrators
- Visual Artists
- Newspapers and Magazines
- Bloggers
- Media agencies
- Businesses in general
- Educational institutions
- Non-profit organizations
- Military & Law Enforcement
- Entrepreneurs
Known Issues
-
Sometimes, current algorithm doesn't spread out the watermark as nicely. This happens in approximately 10-20% of different size and shapes of photos. It can be fixed by improving the algorithm.
-
In batch function font size is not calculated dynamically. When a folder has images with very different image resolutions this can cause a problem of very different watermark font sizes.
Versions
| Version | Description |
|---|---|
| 0.7.0.1 | September 27, 2020 - Initial Release |
| 0.7.0.2 | September 28, 2020 - New Version |
| 0.7.0.3 | September 28, 2020 - New Version: init.py fixed |
| 0.7.1.0 | September 29, 2020 - New Version w/ batch GUI: init.py fixed, bugs fixed |
| 0.7.1.1 | September 29, 2020 - New Version: code typo fixed |
| 0.7.1.2 | September 29, 2020 - New Version: logo fixed, source code correct description added |
| 0.7.2.0 | October 5, 2020 - New Version: GUI Exit behavior improved |
| 0.7.2.1 | October 5, 2020 - New Version: Correct Version Name |
Release Notes
0.7.0.1 - Initial release is out.
0.7.0.2 - Added functionality to add folder for batch operations when saving folder doesn't already exist.
0.7.0.3 - Fixed init.py files for correct installation.
0.7.1.0 - Added Batch GUI, fixed Cancel button, fixed path conflicts
0.7.2.0 - When GUI is closed without picking any image or folder, instead of giving an error, function is terminated by returning None. This should allow repeat operations in a single session and make usage more convenient and smooth for users.
0.7.2.1 - Version name fixed
Upcoming Work
Batch Graphic User Interface (done)
Add color options for watermarking white color dominant images (soon)
Add Dynamic font_size calculation to batch function. (soon)
Improved algorithm For spreading out watermark text (soon)
A sibling class to the only current class: Spread, potentially named Place that can be used to places a single watermark text on the image. (maybe soon)
Author & Owner
Written and owned by Holypython.com a Python lessons, tutorials and exercises site. (https://holypython.com)
This documentation as well as all other Watermarkd documentation and code is Copyright 2020, 2021, 2022 by Holypython.com
Send correspondence to watermarkd@holypython.com
License
Apache-2.0
Acknowledgments
PySimpleGui and PIL libraries for faciliating and inspiring.
UMICH Professors Dr. Charles Severance & Dr. Paul Resnick, for doing an amazing job teaching Python and their inspirational Computer Science works.
Stack Overflow Co-Founder Jeff Atwood for creating such an amazing platform to learn and share and also for sharing inspiring knowledge on his blog and other platforms.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
