Security News
MCP Community Begins Work on Official MCP Metaregistry
The MCP community is launching an official registry to standardize AI tool discovery and let agents dynamically find and install MCP servers.
By Sarah Gooding - May 09, 2025
🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more →
- Maintainers
- 1
fotolab
A console program to manipulate photos.
Installation
Stable version From PyPI using pipx:
pipx install fotolab
Stable version From PyPI using pip:
python -m pip install fotolab
Upgrade to latest stable version:
python3 -m pip install fotolab --upgrade
Latest development version from GitHub:
python -m pip install -e git+https://github.com/kianmeng/fotolab.git
Usage
fotolab -h
usage: fotolab [-h] [-o] [-q] [-v] [-d] [-V]
{animate,auto,border,contrast,env,halftone,info,montage,resize,rotate,sharpen,watermark} ...
A console program to manipulate photos.
website: https://github.com/kianmeng/fotolab
changelog: https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
issues: https://github.com/kianmeng/fotolab/issues
positional arguments:
{animate,auto,border,contrast,env,halftone,info,montage,resize,rotate,sharpen,watermark}
sub-command help
animate animate an image
auto auto adjust (resize, contrast, and watermark) a photo
border add border to image
contrast contrast an image.
env print environment information for bug reporting
halftone halftone an image
info info an image
montage montage a list of image
resize resize an image
rotate rotate an image
sharpen sharpen an image
watermark watermark an image
options:
-h, --help show this help message and exit
-o, --overwrite overwrite existing image
-q, --quiet suppress all logging
-v, --verbose show verbosity of debugging log, use -vv, -vvv for more details
-d, --debug show debugging log and stacktrace
-V, --version show program's version number and exit
fotolab animate
fotolab animate -h
usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP] [-op]
[-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-f, --format FORMAT set the image format (default: 'gif')
-d, --duration DURATION
set the duration in milliseconds (default: '2500')
-l, --loop LOOP set the loop cycle (default: '0')
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab auto
fotolab auto -h
usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filename
options:
-h, --help show this help message and exit
fotolab border
fotolab border -h
usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
[-wb WIDTH] [-wl WIDTH] [-op] [-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-c, --color COLOR set the color of border (default: 'black')
-w, --width WIDTH set the width of border in pixels (default: '10')
-wt, --width-top WIDTH
set the width of top border in pixels (default: '0')
-wr, --width-right WIDTH
set the width of right border in pixels (default: '0')
-wb, --width-bottom WIDTH
set the width of bottom border in pixels (default:
'0')
-wl, --width-left WIDTH
set the width of left border in pixels (default: '0')
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab contrast
fotolab contrast -h
usage: fotolab contrast [-h] [-c CUTOFF] [-op] [-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filename
options:
-h, --help show this help message and exit
-c, --cutoff CUTOFF set the percentage (0-50) of lightest or darkest
pixels to discard from histogram (default: '1.0')
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab info
fotolab info -h
usage: fotolab info [-h] [-s] [--camera] [--datetime] IMAGE_FILENAME
positional arguments:
IMAGE_FILENAME set the image filename
options:
-h, --help show this help message and exit
-s, --sort show image info by sorted field name
--camera show the camera maker details
--datetime show the datetime
fotolab rotate
fotolab rotate -h
usage: fotolab rotate [-h] [-r ROTATION] [-cw] [-op] [-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-r, --rotation ROTATION
Rotation angle in degrees (default: '0')
-cw, --clockwise Rotate clockwise (default: 'False)
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab montage
fotolab montage -h
usage: fotolab montage [-h] [-op] [-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab resize
fotolab resize -h
usage: fotolab resize [-h] [-c] [-l CANVAS_COLOR] [-W WIDTH | -H HEIGHT] [-op]
[-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filename
options:
-h, --help show this help message and exit
-c, --canvas paste image onto a larger canvas
-l, --canvas-color CANVAS_COLOR
the color of the extended larger canvas(default:
'black')
-W, --width WIDTH set the width of the image (default: '600')
-H, --height HEIGHT set the height of the image (default: '277')
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab sharpen
fotolab sharpen -h
usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD] [-ba]
[-op] [-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-r, --radius RADIUS set the radius or size of edges (default: '1')
-p, --percent PERCENT
set the amount of overall strength of sharpening
effect (default: '100')
-t, --threshold THRESHOLD
set the minimum brightness changed to be sharpened
(default: '3')
-ba, --before-after generate a GIF showing before and after changes
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab watermark
fotolab watermark -h
usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
[-p {top-left,top-right,bottom-left,bottom-right}]
[-pd PADDING] [-fs FONT_SIZE] [-fc FONT_COLOR]
[-ow OUTLINE_WIDTH] [-oc OUTLINE_COLOR] [--camera]
[-l | --lowercase | --no-lowercase] [-op]
[-od OUTPUT_DIR]
IMAGE_FILENAMES [IMAGE_FILENAMES ...]
positional arguments:
IMAGE_FILENAMES set the image filenames
options:
-h, --help show this help message and exit
-t, --text WATERMARK_TEXT
set the watermark text (default: 'kianmeng.org')
-p, --position {top-left,top-right,bottom-left,bottom-right}
set position of the watermark text (default: 'bottom-
left')
-pd, --padding PADDING
set the padding of the watermark text relative to the
image (default: '15')
-fs, --font-size FONT_SIZE
set the font size of watermark text (default: '12')
-fc, --font-color FONT_COLOR
set the font color of watermark text (default:
'white')
-ow, --outline-width OUTLINE_WIDTH
set the outline width of the watermark text (default:
'2')
-oc, --outline-color OUTLINE_COLOR
set the outline color of the watermark text (default:
'black')
--camera use camera metadata as watermark
-l, --lowercase, --no-lowercase
lowercase the watermark text
-op, --open open the image using default program (default:
'False')
-od, --output-dir OUTPUT_DIR
set default output folder (default: 'output')
fotolab env
fotolab env -h
usage: fotolab env [-h]
options:
-h, --help show this help message and exit
Copyright and License
Copyright (C) 2024,2025 Kian-Meng Ang
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
The fish logo used in the documentation generated by Sphinx is a public domain drawing of male freshwater phase [Sockeye (red) salmon (Oncorhynchus nerka)] (https://en.wikipedia.org/w/index.php?oldid=1186575702) from https://commons.wikimedia.org/entity/M2787002.
Keywords
FAQs
A console program that manipulate images.
We found that fotolab demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Research
Security News
Malicious npm Packages Use Telegram to Exfiltrate BullX Credentials
Socket uncovers an npm Trojan stealing crypto wallets and BullX credentials via obfuscated code and Telegram exfiltration.
By Kush Pandya - May 08, 2025
Research
Security News
Backdooring the IDE: Malicious npm Packages Hijack Cursor Editor on macOS
Malicious npm packages posing as developer tools target macOS Cursor IDE users, stealing credentials and modifying files to gain persistent backdoor access.
By Kirill Boychenko - May 07, 2025