{"id":15394248,"url":"https://github.com/xyproto/emojiterm","last_synced_at":"2025-06-26T19:37:24.694Z","repository":{"id":57517383,"uuid":"245997753","full_name":"xyproto/emojiterm","owner":"xyproto","description":"List and display GitHub emojis directly on the terminal","archived":false,"fork":false,"pushed_at":"2022-12-16T09:57:29.000Z","size":3621,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-15T23:56:33.249Z","etag":null,"topics":["ansi-art","ascii-art","emoji","emojis","github","github-api","terminal","utility"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xyproto.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}},"created_at":"2020-03-09T09:48:31.000Z","updated_at":"2025-04-11T14:12:45.000Z","dependencies_parsed_at":"2023-01-29T12:15:26.868Z","dependency_job_id":null,"html_url":"https://github.com/xyproto/emojiterm","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/xyproto/emojiterm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Femojiterm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Femojiterm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Femojiterm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Femojiterm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xyproto","download_url":"https://codeload.github.com/xyproto/emojiterm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Femojiterm/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262133450,"owners_count":23264217,"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":["ansi-art","ascii-art","emoji","emojis","github","github-api","terminal","utility"],"created_at":"2024-10-01T15:22:46.523Z","updated_at":"2025-06-26T19:37:24.675Z","avatar_url":"https://github.com/xyproto.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Emojiterm [![Go Report Card](https://goreportcard.com/badge/github.com/xyproto/emojiterm)](https://goreportcard.com/report/github.com/xyproto/emojiterm) [![License](https://img.shields.io/badge/License-BSD3-brightgreen)](https://raw.githubusercontent.com/xyproto/emojiterm/main/LICENSE)\n\n* Do you want to find a suitable Emoji for use on GitHub, using only a terminal that supports 256 colors?\n* Then this application is for you.\n\n`emojiterm` can list all available emoji names, or search for a keyword and display the emoji directly on the terminal.\n\n![recording](img/recording.gif)\n\n## Requirements\n\n* Go \u003e= 1.10.\n* A terminal emulator that supports 256 colors.\n\n## Installation\n\nInstall with your favorite package manager, if possible.\n\n### Manual installation of the development version\n\n    go get -u github.com/xyproto/emojiterm\n\n## Supported terminal emulators\n\nThese terminal emulators are known to work:\n\n* `konsole`\n* `xfce4-terminal`\n\nThis one does not work:\n\n* `urxvt`\n\nThis one works, but does not look quite right:\n\n* `st`\n\n## Request limit\n\nIf you reach the request limit for using the GitHub API, placing a valid token in the `GITHUB_TOKEN` environment variable should solve the issue.\n\nFor generating a token, just visit [github.com/settings/tokens](https://github.com/settings/tokens) and click \"Generate new token\". None of the boxes with extra access needs to be checked, since `emojiterm` only fetches emoji-related information.\n\n## Slideshow\n\nYou can display a slideshow of all available GitHub emojis with the following command:\n\n```bash\nGITHUB_TOKEN=\"asdf\" emojiterm -a\n```\n\nThis can also take an optional search term:\n\n```bash\nGITHUB_TOKEN=\"asdf\" emojiterm -a cat\n```\n\n## Setting up an alias\n\nOne way of using `emojiterm` is through an alias, that also sets the `GITHUB_TOKEN`, like this:\n\n```bash\nalias et='GITHUB_TOKEN=\"asdf\" emojiterm'\n```\n\nReplace `asdf` with your own token, that can be generated here: [github.com/settings/tokens](https://github.com/settings/tokens).\n\n## General Info\n\n* Developed on Arch Linux, using Go 1.18.\n* Uses [pixterm](https://github.com/eliukblau/pixterm), [imaging](https://github.com/disintegration/imaging), [go-colorful](https://github.com/lucasb-eyer/go-colorful) and [go-github](https://github.com/google/go-github).\n* The `display` function in `main.go` is based on code from [pixterm](https://github.com/eliukblau/pixterm) (which is also licensed under `Mozilla Public License 2.0`).\n* License: BSD-3\n* Version: 0.3.2\n* Author: Alexander F. Rødseth \u0026lt;xyproto@archlinux.org\u0026gt;\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxyproto%2Femojiterm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxyproto%2Femojiterm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxyproto%2Femojiterm/lists"}