{"id":19806537,"url":"https://github.com/danielchristianschroeter/watermark-to-image","last_synced_at":"2025-09-18T04:32:12.954Z","repository":{"id":80787174,"uuid":"583155298","full_name":"danielchristianschroeter/watermark-to-image","owner":"danielchristianschroeter","description":"This application inserts a watermark into images located in a specified folder.","archived":false,"fork":false,"pushed_at":"2024-10-21T13:07:57.000Z","size":13196,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-19T09:55:45.437Z","etag":null,"topics":["image","image-processing","image-watermark","image-watermarking","watermark","watermark-image","watermark-tools","watermarking"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielchristianschroeter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-28T23:47:59.000Z","updated_at":"2024-10-06T13:03:04.000Z","dependencies_parsed_at":"2023-12-20T12:48:54.844Z","dependency_job_id":"131cba6c-3937-41f2-8953-e9f6a6494cdd","html_url":"https://github.com/danielchristianschroeter/watermark-to-image","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielchristianschroeter%2Fwatermark-to-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielchristianschroeter%2Fwatermark-to-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielchristianschroeter%2Fwatermark-to-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielchristianschroeter%2Fwatermark-to-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielchristianschroeter","download_url":"https://codeload.github.com/danielchristianschroeter/watermark-to-image/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233447836,"owners_count":18677707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image","image-processing","image-watermark","image-watermarking","watermark","watermark-image","watermark-tools","watermarking"],"created_at":"2024-11-12T09:07:50.169Z","updated_at":"2025-09-18T04:32:07.151Z","avatar_url":"https://github.com/danielchristianschroeter.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# watermark-to-image\n\nWatermark-to-Image is a command-line application for inserting watermarks into images located in a specified folder. It supports various customization options.\n\n## Table of Contents\n\n- [Examples](#examples)\n- [Usage](#usage)\n- [Clone and Build](#clone-and-build)\n- [Command Line Parameters](#command-line-parameters)\n- [Download Executables](#download-executables)\n- [License](#license)\n\n# Examples\n\nYou can see the application in action by examining the following images:\n\n|                                                                  Original image                                                                  |                                                                   Watermarked image                                                                    |\n| :----------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------: |\n| ![landscape_original](https://raw.githubusercontent.com/danielchristianschroeter/watermark-to-image/main/examples/original_images/landscape.jpg) | ![landscape_watermarked](https://raw.githubusercontent.com/danielchristianschroeter/watermark-to-image/main/examples/watermarked_images/landscape.jpg) |\n|  ![portrait_original](https://raw.githubusercontent.com/danielchristianschroeter/watermark-to-image/main/examples/original_images/portrait.jpg)  |  ![portrait_watermarked](https://raw.githubusercontent.com/danielchristianschroeter/watermark-to-image/main/examples/watermarked_images/portrait.jpg)  |\n\n## Usage\n\n1. Build or download the prebuilt executable.\n2. Execute the following command in your terminal:\n\n```shell\n./watermark-to-image -sourceDirectory ./examples/original_images -targetDirectory ./examples/watermarked_images -watermarkImageFile ./examples/watermark.png\n```\n\n## Clone and Build\n\nYou can also clone the project and build it locally. Here are the steps:\n\n```shell\n$ git clone https://github.com/danielchristianschroeter/watermark-to-image\n$ cd watermark-to-image\n$ go build .\n```\n\n## Command Line Parameters\n\nThe application supports various command-line parameters for customization. Here is a list of all available parameters:\n\n```shell\n./watermark-to-image --help\n  -sourceDirectory string\n        Set the source directory for original images (required).\n  -targetDirectory string\n        Set the target directory for watermarked images (required).\n  -targetWatermarkedImageFilename string\n        Rename all target files to the specified filename.\n  -targetWatermarkedImageFilenameSuffix string\n        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\")\n  -targetWatermarkedImageHeight int\n        Resize the target watermarked image to the specified height (in pixels). Aspect ratio will be preserved if 'targetWatermarkedImageWidth' is empty.\n  -targetWatermarkedImageMaxDimension int\n        Specify the maximum dimension size for the target watermarked image. Use 0 to maintain the aspect ratio. Default is 0.\n  -targetWatermarkedImageWidth int\n        Resize the target watermarked image to the specified width (in pixels). Aspect ratio will be preserved if 'targetWatermarkedImageHeight' is empty.\n  -watermarkImageFile string\n        Specify the path and name of the watermark PNG image file (required).\n  -watermarkScaleFactor float\n        Set the scale factor for the watermark image (in percentage). (default 100)\n  -watermarkMarginBottom int\n        Set the margin from the bottom edge for the watermark (in pixels). (default 20)\n  -watermarkMarginRight int\n        Set the margin from the right edge for the watermark (in pixels). (default 20)\n  -watermarkOpacity float\n        Set the opacity/transparency of the watermark image (0.0 to 1.0). (default 0.5)\n```\n\n## Download Executables\n\nYou can download prebuilt executables for various operating systems from the [Releases](https://github.com/danielchristianschroeter/watermark-to-image/releases) page.\n\n_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._\n\n## License\n\nThis 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielchristianschroeter%2Fwatermark-to-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielchristianschroeter%2Fwatermark-to-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielchristianschroeter%2Fwatermark-to-image/lists"}