{"id":13579301,"url":"https://github.com/NotCookey/Quote2Image","last_synced_at":"2025-04-05T20:33:41.581Z","repository":{"id":48148663,"uuid":"437248855","full_name":"NotCookey/Quote2Image","owner":"NotCookey","description":"Quote2Image is a python library for turning text quotes into graphical images","archived":false,"fork":false,"pushed_at":"2024-03-05T01:18:58.000Z","size":617,"stargazers_count":62,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-09T19:35:34.520Z","etag":null,"topics":["conversion","font","graphics","image-generation","image-generator","image-processing","python","quote-generator","quote-image","quote-maker","quote-to-image","quote2image","quotes","quotes-generator","quotes-on-design","text","text-art","text-to-image","text-to-quote"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/Quote2Image","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NotCookey.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":"2021-12-11T10:16:51.000Z","updated_at":"2025-01-17T13:48:43.000Z","dependencies_parsed_at":"2023-10-15T17:07:13.978Z","dependency_job_id":"b0b4d47b-bcd1-4f1b-8197-2b432a2e6437","html_url":"https://github.com/NotCookey/Quote2Image","commit_stats":{"total_commits":13,"total_committers":1,"mean_commits":13.0,"dds":0.0,"last_synced_commit":"6d5af6ebd5e8b17748769be4f70a6b3c94453995"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotCookey%2FQuote2Image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotCookey%2FQuote2Image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotCookey%2FQuote2Image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotCookey%2FQuote2Image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NotCookey","download_url":"https://codeload.github.com/NotCookey/Quote2Image/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399874,"owners_count":20932876,"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":["conversion","font","graphics","image-generation","image-generator","image-processing","python","quote-generator","quote-image","quote-maker","quote-to-image","quote2image","quotes","quotes-generator","quotes-on-design","text","text-art","text-to-image","text-to-quote"],"created_at":"2024-08-01T15:01:38.180Z","updated_at":"2025-04-05T20:33:36.565Z","avatar_url":"https://github.com/NotCookey.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eQuote2Image\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cb\u003eA python module to convert text quotes into graphical images\u003c/b\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003ckbd\u003e\u003cimg src=\"https://github.com/NotCookey/Quote2Image/assets/88582190/c49bedbd-73a5-4eac-a1b0-a4d98445ae08\" height=300px\u003e\u003c/kbd\u003e\u003c/p\u003e\n\n## Installation\n**To install Quote2Image, you can use `pip`:**\n```bash\npip install Quote2Image\n```\n\n## Usage\n**The `Convert` function takes the following arguments:**\n\n- **`quote` : The quote to convert.**\n- **`author` : The author of the quote.**\n- **`fg` : The foreground color of the text.**\n- **`bg` : The background color of the image.**\n- **`font_type` : The font to use for the text.**\n- **`font_size` : This font size is used for the quote.**\n- **`font_size_author` : This font size is used for the author (Optional, Default value is set to `font_size`).**\n- **`width` : The width of the image.**\n- **`height` : The height of the image.**\n- **`watermark_text` : The text for the watermark (Leave it blank for no watermarks).**\n- **`watermark_font_size` : The font size for the watermark text (Optional, Default save is set to `font_size`).**\n\n## Generating an image using RGB background and foreground\n\n**The package comes with a builtin `GenerateColors` function that generates a fg and bg color with the correct amount of luminosity and returns them in tuples.**\n\n```python\nfrom Quote2Image import Convert, GenerateColors\n\n# Generate Fg and Bg Color\nfg, bg = GenerateColors()\n\nimg=Convert(\n\tquote=\"Pooing keeps you healthy\",\n\tauthor=\"Pee\",\n\tfg=fg,\n\tbg=bg,\n\tfont_size=32,\n\tfont_type=\"arial.ttf\",\n\twidth=1080,\n\theight=450)\n\n# Save The Image as a Png file\nimg.save(\"hello.png\")\n```\n## Generating an image using a custom background image.\n\n **We can do that using the `ImgObject` that gives us alot of flexibility on how we want our background Image to be.**\n\n**The `ImgObject` class takes the following arguments:**\n\n- **`image` : The link to the background image (required).**\n- **`brightness` : The brightness of the image (optional, default is 100).**\n- **`blur` : The blur of the image (optional, default is 0).**\n\n**You can then use the `ImgObject` instance as the bg argument in the convert function:**\n\n```py\nfrom Quote2Image import Convert, ImgObject\n\nbg=ImgObject(image=\"IMAGE FILE LOCATION\", brightness=80, blur=80)\n\nimg=Convert(\n\tquote=\"Pooing keeps you healthy\",\n\tauthor=\"Pee\",\n\tfg=(21, 21, 21),\n\tbg=bg,\n\tfont_size=32,\n\tfont_type=\"arial.ttf\",\n\twidth=1080,\n\theight=450)\n\n# Save The Image as a Png file\nimg.save(\"hello.png\")\n```\n\n## Adding a watermark:\n\n- **`watermark_text` : The text for the watermark.**\n- **`watermark_font_size` : The font size for the watermark text.**\n\n```py\nfrom Quote2Image import Convert, GenerateColors\n\n# Generate Fg and Bg Color\nfg, bg = GenerateColors()\n\nimg=Convert(\n\tquote=\"Pooing keeps you healthy\",\n\tauthor=\"Pee\",\n\tfg=fg,\n\tbg=bg,\n\tfont_size=32,\n\tfont_type=\"arial.ttf\",\n\tfont_size_author=25,\n\twidth=1080,\n\theight=450,\n    \twatermark_text=\"@My.Watermark\",\n    \twatermark_font_size=15\n)\n\n# Save The Image as a Png file\nimg.save(\"hello.png\")\n```\n\n## Permissions\n\n- **You are allowed to use, modify, and distribute the module.**\n- **You are allowed to distribute modified versions of the module, as long as you follow the terms of the license.**\n\n## Obligations\n\n- **You must include a copy of the GPL-3.0 license with the module.**\n- **You must provide a copy of the source code of the module, either along with the modified version of the module or through a written offer to provide the source code.**\n- **You must provide a prominent notice stating that you have modified the module, and the date of the modification.**\n- **If you distribute the module, you must do so under the terms of the GPL-3.0 license.**\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#NotCookey/Quote2Image\u0026Date\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=NotCookey/Quote2Image\u0026type=Date\u0026theme=dark\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=NotCookey/Quote2Image\u0026type=Date\" /\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=NotCookey/Quote2Image\u0026type=Date\" /\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n# That's It\n\u003e **Thank You! Hope this was useful to you \u003c3**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNotCookey%2FQuote2Image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNotCookey%2FQuote2Image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNotCookey%2FQuote2Image/lists"}