EMOJI(1)

NAME

emojiA minimalistic emoji package for Go (golang)

SYNOPSIS

INFO

459 stars
23 forks
0 views

DESCRIPTION

A minimalistic emoji package for Go (golang)

README

emoji :rocket: :school_satchel: :tada:

Build Status godoc Go Report Card Codecov MIT License

emoji is a minimalistic emoji library for Go. It lets you use emoji characters in strings.

Inspired by spatie/emoji

Install :floppy_disk:

go get github.com/enescakir/emoji

Usage :surfer:

package main

import ( "fmt"

"github.com/enescakir/emoji"

)

func main() { fmt.Printf("Hello %v\n", emoji.WavingHand) fmt.Printf("I am %v from %v\n", emoji.ManTechnologist, emoji.FlagForTurkey, ) fmt.Printf("Different skin tones.\n default: %v light: %v dark: %v\n", emoji.ThumbsUp, emoji.OkHand.Tone(emoji.Light), emoji.CallMeHand.Tone(emoji.Dark), ) fmt.Printf("Emojis with multiple skin tones.\n both medium: %v light and dark: %v\n", emoji.PeopleHoldingHands.Tone(emoji.Medium), emoji.PeopleHoldingHands.Tone(emoji.Light, emoji.Dark), ) fmt.Println(emoji.Parse("Emoji aliases are :sunglasses:")) emoji.Println("Use fmt wrappers :+1: with emoji support :tada:") }

/* OUTPUT

Hello 👋
I am 👨‍💻 from 🇹🇷
Different skin tones.
  default: 👍 light: 👌🏻 dark: 🤙🏿
Emojis with multiple skin tones.
  both medium: 🧑🏽‍🤝‍🧑🏽 light and dark: 🧑🏻‍🤝‍🧑🏿
Emoji aliases are 😎
Use fmt wrappers 👍 with emoji support 🎉

*/

This package contains emojis constants based on Full Emoji List v13.0.

emoji.CallMeHand // 🤙
emoji.CallMeHand.Tone(emoji.Dark) // 🤙🏿

Also, it has additional emoji aliases from github/gemoji.

emoji.Parse(":+1:") // 👍
emoji.Parse(":100:") // 💯

You can generate country flag emoji with ISO 3166 Alpha2 codes:

emoji.CountryFlag("tr") // 🇹🇷
emoji.CountryFlag("US") // 🇺🇸
emoji.Parse("country flag alias :flag-gb:") // country flag alias 🇬🇧

All constants are generated by internal/generator.

Testing :hammer:

go test

Todo :pushpin:

  • Add examples to godoc

Contributing :man_technologist:

I am accepting PRs that add aliases to the package. You have to add it to customEmojis list at internal/generator/main.

If you think an emoji constant is not correct, open an issue. Please use this list to look up the correct unicode value and the name of the character.

Credits :star:

License :scroll:

The MIT License (MIT). Please see License File for more information.

SEE ALSO

clihub3/4/2026EMOJI(1)