{"id":28240268,"url":"https://github.com/jarif87/flask-watermark-tool","last_synced_at":"2026-04-29T16:34:53.239Z","repository":{"id":293309679,"uuid":"983621620","full_name":"jarif87/flask-watermark-tool","owner":"jarif87","description":"ImageWatermarker is a Flask app that lets users add logo or text watermarks to any image. Features a modern UI with Tailwind CSS, preview and error feedback.","archived":false,"fork":false,"pushed_at":"2025-05-14T17:33:33.000Z","size":354,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-10T07:42:56.086Z","etag":null,"topics":["css","cv2","html","image","opencv-python","python"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jarif87.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-05-14T16:53:34.000Z","updated_at":"2025-07-10T18:40:49.000Z","dependencies_parsed_at":"2025-05-14T18:40:56.894Z","dependency_job_id":null,"html_url":"https://github.com/jarif87/flask-watermark-tool","commit_stats":null,"previous_names":["jarif87/flask-watermark-tool"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jarif87/flask-watermark-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarif87%2Fflask-watermark-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarif87%2Fflask-watermark-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarif87%2Fflask-watermark-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarif87%2Fflask-watermark-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jarif87","download_url":"https://codeload.github.com/jarif87/flask-watermark-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarif87%2Fflask-watermark-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32435108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["css","cv2","html","image","opencv-python","python"],"created_at":"2025-05-19T03:12:55.400Z","updated_at":"2026-04-29T16:34:53.221Z","avatar_url":"https://github.com/jarif87.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ImageWatermarker\r\n\r\nA Flask-based web application to add watermarks to images. Users can upload an image and apply either a logo watermark (centered with red guiding lines) or a text watermark (bottom-right in red). This app is particularly useful for watermarking medical images, such as lung disease X-rays (e.g., `lung_scc`, `lung_n`, `lung_aca`), to ensure proper attribution or branding.\r\n\r\n## Features\r\n- Upload an image and apply a logo or text watermark.\r\n- Logo watermark: Centered on the image with red lines indicating the placement.\r\n- Text watermark: Positioned at the bottom-right corner in red.\r\n- Modern UI with a gradient background, glassmorphism effects, and animations using Tailwind CSS.\r\n- Preview section to display the watermarked image.\r\n- Success/error messages for user feedback.\r\n\r\n## Directory Structure\r\n```\r\nImageWatermarker/\r\n├── static/\r\n│   ├── style.css        # Custom styles for the UI\r\n│   └── uploads/        # Directory to store watermarked images\r\n├── templates/\r\n│   └── index.html      # HTML template for the web interface\r\n└── app.py              # Flask application with watermarking logic\r\n└── README.md           # Project documentation\r\n\r\n```\r\n\r\n\r\n## Prerequisites\r\n- Python 3.6 or higher\r\n- pip (Python package manager)\r\n\r\n## Setup Instructions\r\n1. **Clone the Repository**  \r\n   ```bash\r\n   git clone https://github.com/\u003cyour-username\u003e/ImageWatermarker.git\r\n   cd ImageWatermarker\r\n\r\n1. **Create a Virtual Environment (Optional but recommended)**\r\n```\r\npython -m venv venv\r\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\r\n```\r\n2. **Install Dependencies** \r\n\r\n```\r\npip install flask pillow opencv-python numpy\r\n```\r\n3. **Run the Application**\r\n```\r\npython app.py\r\n```\r\n\r\n# Usage\r\n* Upload an Image: Click \"Browse\" to upload an image (e.g., a lung X-ray).\r\n\r\n## Choose Watermark Type:\r\n- Logo Watermark: Select the \"Logo Watermark\" option and upload a logo image. The logo will be centered with red guiding lines.\r\n\r\n- Text Watermark: Select the \"Text Watermark\" option, enter your text, and it will appear in red at the bottom-right.\r\n\r\n- Apply Watermark: Click \"Apply Watermark\" to process the image.\r\n\r\n- Preview: View the watermarked image in the preview section.\r\n\r\n- Feedback: Success or error messages will appear as green/red alerts.\r\n\r\n# Dependencies\r\n- Flask: Web framework for the app.\r\n\r\n- Pillow: Image processing for loading and saving images.\r\n\r\n- OpenCV (opencv-python): Applying watermarks to images.\r\n\r\n- NumPy: Array operations for image processing.\r\n\r\n\r\n# Notes\r\n- The app uses Tailwind CSS (via CDN) for styling, with additional custom styles in static/style.css.\r\n\r\n- Watermarked images are saved in static/uploads/ with randomly generated filenames.\r\n\r\n- There’s no default placeholder image; the preview section shows a message until an image is watermarked.\r\n\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarif87%2Fflask-watermark-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjarif87%2Fflask-watermark-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarif87%2Fflask-watermark-tool/lists"}