{"id":26397653,"url":"https://github.com/andrepradika/combiner-image","last_synced_at":"2025-03-17T12:18:33.694Z","repository":{"id":282138997,"uuid":"947615072","full_name":"andrepradika/combiner-image","owner":"andrepradika","description":"🛋️ Image Combiner is a Python script that merges two images into a single composite image. It reads a CSV file containing fabric and sofa image filenames, processes them in batch, and saves the final images with a timestamped filename. Perfect for visualizing fabric samples on furniture! 🎨✨","archived":false,"fork":false,"pushed_at":"2025-03-13T01:10:57.000Z","size":298,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T02:22:35.677Z","etag":null,"topics":["automation","csv-processing","image-manipulation"],"latest_commit_sha":null,"homepage":"","language":"Python","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/andrepradika.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}},"created_at":"2025-03-13T01:09:15.000Z","updated_at":"2025-03-13T01:11:52.000Z","dependencies_parsed_at":"2025-03-13T02:33:53.842Z","dependency_job_id":null,"html_url":"https://github.com/andrepradika/combiner-image","commit_stats":null,"previous_names":["andrepradika/combiner-image"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrepradika%2Fcombiner-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrepradika%2Fcombiner-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrepradika%2Fcombiner-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrepradika%2Fcombiner-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrepradika","download_url":"https://codeload.github.com/andrepradika/combiner-image/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244031119,"owners_count":20386534,"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":["automation","csv-processing","image-manipulation"],"created_at":"2025-03-17T12:18:33.014Z","updated_at":"2025-03-17T12:18:33.689Z","avatar_url":"https://github.com/andrepradika.png","language":"Python","readme":"# 🛋️ Image Combiner  \n\n## 📌 About  \n\n**Image Combiner** 🖼️🔗 is a Python script that merges two images—one representing **fabric** and the other a **sofa**—into a single **500x500px composite image**. The script reads a CSV file containing filenames, processes each pair of images, and saves the combined results with a **timestamped filename**.  \n\n## 🚀 Features  \n\n✅ **Batch Processing** – Reads image filenames from a CSV file and processes multiple pairs at once.  \n✅ **Automated Image Merging** – Stacks fabric (bottom) and sofa (top) into a new composite image.  \n✅ **Timestamped Filenames** – Ensures unique output filenames using the current timestamp.  \n✅ **CSV File Update** – Updates the CSV file with the generated image filenames.  \n\n---\n\n## 📦 Installation  \n\n1. **Clone this repository**  \n\n   ```bash\n   git clone https://github.com/andrepradika/combiner-image.git\n   cd combiner-image\n   ```\n\n2. **Install dependencies**  \n\n   ```bash\n   pip install pillow\n   ```\n\n---\n\n## 🛠️ Usage  \n\n1. **Prepare the required folders and files**  \n   - Place **fabric images** in the `file_1/` folder.  \n   - Place **sofa images** in the `file_2/` folder.  \n   - Ensure the `data.csv` file contains:  \n\n     ```csv\n     file_1;file_2\n     fabric1.jpg;sofa1.jpg\n     fabric2.png;sofa2.png\n     ```\n\n2. **Run the script**  \n\n   ```bash\n   python main.py\n   ```\n\n3. **Check the results**  \n   - Combined images are saved in the `output_images/` folder.  \n   - `data.csv` is updated with the result filenames.  \n\n---\n\n## 📂 File Structure  \n\n```\nimage-combiner/\n│── file_1/              # Folder containing fabric images\n│── file_2/              # Folder containing sofa images\n│── output_images/       # Folder where combined images are saved\n│── data.csv             # CSV file with input filenames\n│── main.py              # Main script\n│── README.md            # Documentation\n```\n\n---\n\n## 📝 Example Output  \n\nA **fabric** image and a **sofa** image are stacked into a **new composite image** like this:  \n\n🛋️ **Sofa (top)**  \n🧵 **Fabric (bottom)**  \n\n---\n\n## 🏷️ Topics  \n\n📄 **CSV Processing** – Reads and updates a CSV file for batch processing.  \n🖼️ **Image Manipulation** – Uses `Pillow` to resize and merge images.  \n⚡ **Automation** – Automatically combines multiple image pairs.  \n🐍 **Python** – Simple, lightweight script for quick processing.  \n\n---\n\n## 📜 License  \n\nThis project is open-source under the **MIT License**.  \n\n## Author\nandrepradika","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrepradika%2Fcombiner-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrepradika%2Fcombiner-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrepradika%2Fcombiner-image/lists"}