{"id":16508688,"url":"https://github.com/mobeets/gifmoji-og","last_synced_at":"2026-05-13T00:04:18.885Z","repository":{"id":73677686,"uuid":"133111407","full_name":"mobeets/gifmoji-og","owner":"mobeets","description":"translate images and gifs into emoji mosaics","archived":false,"fork":false,"pushed_at":"2018-05-16T21:01:39.000Z","size":6258,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-02T04:33:36.624Z","etag":null,"topics":["emoji","emojify","emojis","gif","gifs"],"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/mobeets.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":"2018-05-12T03:44:49.000Z","updated_at":"2020-10-17T08:49:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"a9ab0009-b9aa-4aeb-9c6b-4c3c589c4af9","html_url":"https://github.com/mobeets/gifmoji-og","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mobeets/gifmoji-og","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mobeets%2Fgifmoji-og","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mobeets%2Fgifmoji-og/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mobeets%2Fgifmoji-og/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mobeets%2Fgifmoji-og/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mobeets","download_url":"https://codeload.github.com/mobeets/gifmoji-og/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mobeets%2Fgifmoji-og/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32961791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T23:30:32.555Z","status":"ssl_error","status_checked_at":"2026-05-12T23:30:18.191Z","response_time":102,"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":["emoji","emojify","emojis","gif","gifs"],"created_at":"2024-10-11T15:46:58.719Z","updated_at":"2026-05-13T00:04:18.870Z","avatar_url":"https://github.com/mobeets.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Turns images or gifs into emojis.\r\n\r\nThe way it works is to repeatedly sample random 32x32 segments of a target image, and for each segment it selects the best emoji to go in that location.\r\n\r\nThe \"best\" emoji is chosen based on Euclidean distance in pixel space. For example, in a given 32x32 segment of the target image, it treats the pixel values as a 32*32*3-dimensional vector, and picks the emoji (each of which is also a 32*32*3-d vector) such that the L2 norm between the two vectors is smallest.\r\n\r\n## Examples\r\n\r\n(If you squint, you can see more detail of the original image.)\r\n\r\n![trump](examples/trump.gif)\r\n\r\n![doge](examples/doge.gif)\r\n\r\n![kaleidoscope](examples/kaleidoscope.gif)\r\n\r\n\u003c!--\u003cimg src=\"https://media.giphy.com/media/ZylyPiu6Zhrqy0mhnE/giphy.gif\" width=\"400px\"\u003e\u003c/img\u003e\u003cbr\u003e\r\n\u003cimg src=\"https://media.giphy.com/media/SGVjSCEAzrgVlslV21/giphy.gif\" width=\"400px\"\u003e\u003c/img\u003e\u003cbr\u003e\r\n\u003cimg src=\"https://media.giphy.com/media/wHYCPnVLcoRu9hRCbN/giphy.gif\" width=\"400px\"\u003e\u003c/img\u003e--\u003e\r\n\r\n## Requirements\r\n\r\n- Python (see `requirements.txt` for individual packages)\r\n- [ImageMagick](https://www.imagemagick.org/script/index.php) to convert a collection of .png images to a single .gif\r\n\r\n## Instructions\r\n\r\nTo process a single .png file, you can run something like:\r\n\r\n```\r\npython gifmoji.py output --targetfile input.png --force_add --target_upsample 4\r\n```\r\n\r\nAbove, `--force_add` means that we must add an emoji at every segment of the target image, and `--target_upsample` means we will scale the target image's size by 4 to make an emoji image with better resolution.\r\n\r\nTo process a .gif into a series of .png made of emojis, you can run something like the following:\r\n```\r\npython gifmoji.py emoji-trump --targetfile trump.gif --is_gif --force_add --outdir images/trump --target_upsample 4\r\n```\r\n\r\nThis will output a series of .png files named `emoji-trump-*.png`, where `*` will be 0, 1, 2, etc. This will take some time to run!\r\n\r\n__If you want a super fast version (seconds rather than minutes), with emojis on a fixed and non-overlapping grid, add `--quick`.__\r\n\r\nYou can then run the following (using [ImageMagick](https://www.imagemagick.org/script/index.php)) to combine the .pngs into a single .gif:\r\n```\r\nconvert -dispose previous -delay 1 emoji-trump-*.png emoji-trump.gif\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmobeets%2Fgifmoji-og","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmobeets%2Fgifmoji-og","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmobeets%2Fgifmoji-og/lists"}