{"id":13747340,"url":"https://github.com/kinduff/slack-big-emoji","last_synced_at":"2025-05-07T07:47:46.805Z","repository":{"id":59155899,"uuid":"95466539","full_name":"kinduff/slack-big-emoji","owner":"kinduff","description":"Command-line tool to create big emojis for Slack.","archived":false,"fork":false,"pushed_at":"2025-04-25T18:30:44.000Z","size":16,"stargazers_count":45,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-25T19:36:13.404Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kinduff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-26T16:25:49.000Z","updated_at":"2025-04-25T18:30:54.000Z","dependencies_parsed_at":"2022-09-13T17:52:05.352Z","dependency_job_id":null,"html_url":"https://github.com/kinduff/slack-big-emoji","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Fslack-big-emoji","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Fslack-big-emoji/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Fslack-big-emoji/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Fslack-big-emoji/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kinduff","download_url":"https://codeload.github.com/kinduff/slack-big-emoji/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252839171,"owners_count":21812083,"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":[],"created_at":"2024-08-03T06:01:25.532Z","updated_at":"2025-05-07T07:47:46.777Z","avatar_url":"https://github.com/kinduff.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# Slack Big Emoji\n\nSlack Big Emoji is a ruby command-line tool (see support) that helps out with the generation of big emojis to a Slack team.\n\nSee [What's a Big Emoji?](#whats-a-big-emoji) for more information.\n\n## Support\n\nMake sure you're using Ruby 2.4.0 (will support native OS X version soon) and you have a working installation of ImageMagick.\n\nAbout images:\n\n- Tool can only process static image files (only png, jpg, jpeg).\n- Images must be square or hold a w/h ratio of 1.0, this is going to be validated.\n- No GIF support since Slack's limit is 64kb and it's a pain to generalize optimization.\n\n## Docker\n\nBuild:\n\n```\ndocker build -t slack-big-emoji .\n```\n\nMount dir with the input file and run:\n\n```\nmkdir myinput\ncp ~/Downloads/example.png myinput/\ndocker run -ti -v $PWD/myinput:/input slack-big-emoji /app/bin/slack-big-emoji -c -o /input/ /input/example.png\n```\n\n## Installation\n\nInstallation is done through RubyGems, to install run:\n\n```\n$ gem install slack-big-emoji\n```\n\nOnce completed you should be ready to go.\n\n## Usage\n\nFirst, locate a square image and run:\n\n```\n$ slack-big-emoji liarliar.jpg\n```\n\nThe script will resize and crop the image into tiles and upload them all (through a small wizard) to your team's Slack.\n\nYou can also run `slack-big-emoji --help` for more options.\n\n\n## What's a Big Emoji?\n\nBig emojis are a set of multiple emojis combined in a grid that together displays a big image.\n\n\n\u003e — Probably you: What?\n\u003e\n\u003e — Me, probably: Why not?\n\u003e\n\u003e — You: I mean, what's a Slack Big Emoji?\n\nA Bigger Emoji™.\n\nWith this tool you'll be able to turn this Jim Carrey snapshot from the movie Liar Liar:\n\n![Picture of Jim Carrey's teeth in the movie \"Liar Liar\"](https://user-images.githubusercontent.com/1270156/27774411-73333d40-5f57-11e7-933e-751dbc178617.jpg)\n\nInto a set of emoji codes like this one:\n\n```\n:liarliar00::liarliar01::liarliar02::liarliar03::liarliar04:\n:liarliar05::liarliar06::liarliar07::liarliar08::liarliar09:\n:liarliar10::liarliar11::liarliar12::liarliar13::liarliar14:\n:liarliar15::liarliar16::liarliar17::liarliar18::liarliar19:\n:liarliar20::liarliar21::liarliar22::liarliar23::liarliar24:\n```\n\nOnce posted in Slack will look like this (mobile looks shitty, tho):\n\n![](https://user-images.githubusercontent.com/1270156/27774488-935d2850-5f58-11e7-8417-944b1251a3da.png)\n\n## Advanced Installation \u0026 Usage\n\nThis gem can be used from an application too, add this line to your Gemfile:\n\n```ruby\ngem 'slack-big-emoji'\n```\n\nAnd then execute:\n\n```ruby\n$ bundle install\n```\n\nFor example, this is the minimal setup for a command-line tool:\n\n```ruby\nrequire 'slack-big-emoji'\n# require 'slack-big-emoji/cli'\n\n# Sets up option parser coming from ARGV\ncli = SlackBigEmoji::CLI.new(ARGV)\n\n# Converter takes as args the file and conversion options\nemoji = SlackBigEmoji::Converter.new(cli.options)\nemoji.convert\n\n# The uploader takes care to upload a folder full of images\nuploader = SlackBigEmoji::Uploader.new(emoji.output_filename)\nuploader.upload_emojis\n\n# The CLI generates a grid based on the output filename,\n# this is the grid to be used in Slack to see the full emoji\ncli.emoji_grid(emoji.output_filename)\n```\n\nFurther documentation can be read in code.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/kinduff/slack-big-emoji. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinduff%2Fslack-big-emoji","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkinduff%2Fslack-big-emoji","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinduff%2Fslack-big-emoji/lists"}