{"id":17225991,"url":"https://github.com/jacebrowning/memegen-flask","last_synced_at":"2026-01-18T11:42:59.887Z","repository":{"id":146888651,"uuid":"291494068","full_name":"jacebrowning/memegen-flask","owner":"jacebrowning","description":"Flask app formerly powering https://memegen.link","archived":false,"fork":false,"pushed_at":"2022-01-14T19:25:24.000Z","size":115582,"stargazers_count":2,"open_issues_count":10,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T07:45:35.108Z","etag":null,"topics":["api","flask","flask-api","meme-generator","memes","pillow","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jacebrowning.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":"jacebrowning"}},"created_at":"2020-08-30T15:10:25.000Z","updated_at":"2022-05-08T08:44:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"e9032331-0367-4ff1-a378-b0e0a2577e94","html_url":"https://github.com/jacebrowning/memegen-flask","commit_stats":{"total_commits":867,"total_committers":37,"mean_commits":23.43243243243243,"dds":0.2110726643598616,"last_synced_commit":"e4e67e76f061fa4e418901031b6086966376b8f3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jacebrowning/memegen-flask","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacebrowning%2Fmemegen-flask","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacebrowning%2Fmemegen-flask/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacebrowning%2Fmemegen-flask/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacebrowning%2Fmemegen-flask/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jacebrowning","download_url":"https://codeload.github.com/jacebrowning/memegen-flask/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacebrowning%2Fmemegen-flask/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28535177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T10:13:46.436Z","status":"ssl_error","status_checked_at":"2026-01-18T10:13:11.045Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["api","flask","flask-api","meme-generator","memes","pillow","python"],"created_at":"2024-10-15T04:14:59.290Z","updated_at":"2026-01-18T11:42:59.867Z","avatar_url":"https://github.com/jacebrowning.png","language":"Python","funding_links":["https://github.com/sponsors/jacebrowning"],"categories":[],"sub_categories":[],"readme":"# Memegen\n\nAn API to programatically generate memes based solely on requested URLs.\n\n[![Unix Build Status](http://img.shields.io/travis/jacebrowning/memegen-flask/main.svg?label=unix)](https://travis-ci.org/jacebrowning/memegen-flask)\n[![Windows Build Status](https://img.shields.io/appveyor/ci/jacebrowning/memegen-flask/main.svg?label=windows)](https://ci.appveyor.com/project/jacebrowning/memegen-flask)\n[![Coverage Status](http://img.shields.io/coveralls/jacebrowning/memegen-flask/main.svg)](https://coveralls.io/r/jacebrowning/memegen-flask)\n[![Scrutinizer Code Quality](http://img.shields.io/scrutinizer/g/jacebrowning/memegen-flask.svg)](https://scrutinizer-ci.com/g/jacebrowning/memegen-flask/?branch=main) \n[![License](https://img.shields.io/badge/license-mit-blue)](https://github.com/jacebrowning/memegen-flask/blob/main/LICENSE.md)\n\n\u003e :warning: This project is now archived. See [jacebrowning/memegen](https://github.com/jacebrowning/memegen) for active development.\n\n\u003c!--content--\u003e\n\n## Generating Images\n\nThe API is stateless so URLs contain all the information necessary to generate meme images. For example, http://localhost:5000/buzz/memes/memes_everywhere.jpg produces:\n\n![Sample Image](docs/sample.jpg)\n\nBut, the site can also produce masked URLs to conceal the joke:\n\nhttp://localhost:5000/_YnV6egltZW1lcy9tZW1lcy1ldmVyeXdoZXJl.jpg\n\nFor any image, lose the extension to see a list of all format options:\n\nhttp://localhost:5000/buzz/memes/memes_everywhere\n\n### Special Characters\n\nIn URLs, spaces can be inserted using underscores, dashes, or mixed case:\n\n* underscore (`_`) → space (` `)\n* dash (`-`) → space (` `)\n* 2 underscores (`__`) → underscore (`_`)\n* 2 dashes (`--`) → dash (`-`)\n* \"weLoveMemes\" → \"we love memes\"\n\nReserved URL characters can be escaped:\n\n* tilde + Q (`~q`) → question mark (`?`)\n* tilde + P (`~p`) → percentage (`%`)\n* tilde + H (`~h`) → hashtag/pound (`#`)\n* tilde + S (`~s`) → slash (`/`)\n* 2 single qutoes (`''`) → double quote (`\"`)\n\nFor example, http://localhost:5000/doge/~hspecial_characters~q/underscore__-dash--.jpg produces:\n\n![Escaped Characters](docs/escaped.jpg)\n\n### Alternate Styles\n\nSome memes come in multiple forms, which can be selected via `?alt=\u003cstyle\u003e`:\n\n![Sample Image](docs/styles.png)\n\nFor example: [http://localhost:5000/sad-biden/sad_joe_biden/doesn't_think_you'll_vote.jpg?alt=scowl](http://localhost:5000/sad-biden/sad_joe_biden/doesn't_think_you'll_vote.jpg?alt=scowl)\n\nOr, you can use your own image URL as the style. For example, http://localhost:5000/custom/my_pretty/background.jpg?alt=http://www.gstatic.com/webp/gallery/1.jpg produces:\n\n![Custom Background](docs/custom.jpg)\n\n### Alternate Fonts\n\nAdditional fonts are available (see: http://localhost:5000/api/fonts) and can be selected via `?font=\u003cname\u003e`.\n\nFor example, http://localhost:5000/joker/pick_a_different_font/people_lose_their_minds.jpg?font=typoline-demo produces:\n\n![Custom Font](docs/font.jpg)\n\n### Custom sizes\n\nImages can be scaled to a specific width via `?width=\u003cint\u003e` or a specific height via `?height=\u003cint\u003e`. If both parameters are provided (`?width=\u003cint\u003e\u0026height=\u003cint\u003e`), the image will be padded to the exact dimensions.\n\nFor example, http://localhost:5000/both/width_or_height/why_not_both~q.jpg?height=350\u0026width=600 produces:\n\n![Custom Size](docs/size.jpg)\n\n### Preview Images\n\nAPI clients that want to show a preview of an image while the user is still typing should disable caching and analytics via `?preview=true`.\n\n### Social Media\n\nAdd `?share=true` to get HTML with images optimized for sharing on social media.\n\n## Adding Templates\n\nTo add a new template, please follow the [contributor instructions](CONTRIBUTING.md).\n\nThanks go to [danieldiekmeier/memegenerator](https://github.com/danieldiekmeier/memegenerator) for the inspiration!\n\n## Sample Clients\n\n| Platforms | Link | Source |\n| :-: | :-- | :-- |\n| Slack | --- | Python: [nicolewhite/slack-meme](https://github.com/nicolewhite/slack-meme) | --- |\n| Slack | --- | Go: [CptSpaceToaster/slackbot](https://github.com/CptSpaceToaster/slackbot) | --- |\n| Slack | http://www.memetizer.com | --- |\n| Hain | --- | JavaScript: [Metrakit/hain-plugin-meme](https://github.com/Metrakit/hain-plugin-meme) |\n| Web | ---| Clojure: [jasich/mighty-fine-memes](https://github.com/jasich/mighty-fine-memes) |\n| Web, Slack | https://memecomplete.com | --- |\n\nAdditional clients can be found by searching for [code examples on GitHub](https://github.com/search?o=desc\u0026q=%22memegen.link%22+\u0026ref=searchresults\u0026s=indexed\u0026type=Code\u0026utf8=%E2%9C%93).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacebrowning%2Fmemegen-flask","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjacebrowning%2Fmemegen-flask","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacebrowning%2Fmemegen-flask/lists"}