diff --git a/GEmojiSharp.DotnetTool.md b/GEmojiSharp.DotnetTool.md
index cd66fd8..456ec9e 100644
--- a/GEmojiSharp.DotnetTool.md
+++ b/GEmojiSharp.DotnetTool.md
@@ -2,7 +2,7 @@
[](https://github.com/hlaueriksson/GEmojiSharp/actions?query=workflow%3Abuild) [](https://www.codefactor.io/repository/github/hlaueriksson/gemojisharp)
-> GitHub Emoji dotnet tool
+> GitHub Emoji `dotnet` tool
## Raw
@@ -32,6 +32,22 @@ emoji r grinning cat -c
πΊπΈ
```
+Skin tone variants:
+
+```cmd
+emoji raw "victory" --skin-tones
+emoji r victory -st
+```
+
+```txt
+βοΈ
+βπ»
+βπΌ
+βπ½
+βπΎ
+βπΏ
+```
+
## Alias
Get emoji aliases:
diff --git a/GEmojiSharp.PowerToysRun.md b/GEmojiSharp.PowerToysRun.md
new file mode 100644
index 0000000..aee8ab5
--- /dev/null
+++ b/GEmojiSharp.PowerToysRun.md
@@ -0,0 +1,51 @@
+# GEmojiSharp.PowerToysRun ποΈππ
+
+[](https://github.com/hlaueriksson/GEmojiSharp/actions?query=workflow%3Abuild) [](https://www.codefactor.io/repository/github/hlaueriksson/gemojisharp)
+
+> GitHub Emoji [PowerToys Run](https://docs.microsoft.com/en-us/windows/powertoys/run) plugin
+
+## Installation
+
+The plugin is developed and tested with `PowerToys` `v0.65.0`.
+
+Install:
+
+0. [Install PowerToys](https://docs.microsoft.com/en-us/windows/powertoys/install)
+1. Exit PowerToys
+2. Download [GEmojiSharp.PowerToysRun.1.0.0.zip](https://github.com/hlaueriksson/GEmojiSharp/releases/download/v1.0.0/GEmojiSharp.PowerToysRun.1.0.0.zip) and extract it to:
+ - `%ProgramFiles%\PowerToys\modules\launcher\Plugins`
+3. Start PowerToys
+
+## Usage
+
+1. Open PowerToys Run with `alt + space`
+2. Type `emoji`
+ - A list of all emojis will be displayed
+3. Continue to type to find emojis via description, category, alias or tag
+4. Use β¬οΈ and β¬οΈ keys to select an emoji
+5. Press `Enter` to copy the selected raw emoji to clipboard
+6. Press `ctrl + c` to copy the selected emoji aliases to clipboard
+7. Press `ctrl + Enter` to copy the selected raw emoji skin tone variants to clipboard
+ - For emoji that supports skin tone modifiers
+
+Emojify:
+
+- You can paste a text containing emoji aliases to replace them with raw emojis
+
+Demojify:
+
+- You can paste a text containing raw emojis to replace them with aliases
+
+## Configuration
+
+Change action keyword:
+
+1. Open PowerToys
+2. Select PowerToys Run
+3. Scroll down to Plugins
+4. Expand `GEmojiSharp`
+5. Change *Direct activation command*
+
+## Would you like to know more? π€
+
+Further documentation is available at [https://github.com/hlaueriksson/GEmojiSharp](https://github.com/hlaueriksson/GEmojiSharp)
diff --git a/GEmojiSharp.md b/GEmojiSharp.md
index 1ebd9ef..113c4fd 100644
--- a/GEmojiSharp.md
+++ b/GEmojiSharp.md
@@ -14,6 +14,7 @@ Emoji.Alias("π"); // :tada:
Emoji.Emojify(":tada: initial commit"); // π initial commit
Emoji.Demojify("π initial commit"); // :tada: initial commit
Emoji.Find("party popper").First().Raw; // π
+Emoji.Get("βοΈ").RawSkinToneVariants(); // βπ», βπΌ, βπ½, βπΎ, βπΏ
```
Extension methods:
diff --git a/README.md b/README.md
index 5eb645a..242ed8d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# GEmojiSharp
+# GEmojiSharp :octocat:
[](https://github.com/hlaueriksson/GEmojiSharp/actions?query=workflow%3Abuild)
[](https://www.codefactor.io/repository/github/hlaueriksson/gemojisharp)
@@ -8,7 +8,12 @@
[](https://www.nuget.org/packages/GEmojiSharp.Blazor)
[](https://www.nuget.org/packages/GEmojiSharp.DotnetTool)
-> GitHub Emoji for C#, ASP.NET Core and Blazor, dotnet tool for the terminal and PowerToys Run plugin
+> GitHub Emoji for C# and .NET:
+> - `netstandard2.0`
+> - ASP.NET Core
+> - Blazor
+> - `dotnet` tool
+> - PowerToys Run plugin
```txt
π :octopus:
@@ -21,15 +26,15 @@
## Content
- [Introduction](#introduction)
-- [`GEmojiSharp` π¦](#gemojisharp-)
-- [`GEmojiSharp.AspNetCore` π¦](#gemojisharpaspnetcore-)
+- [`GEmojiSharp`](#gemojisharp)
+- [`GEmojiSharp.AspNetCore`](#gemojisharpaspnetcore)
- [TagHelpers](#taghelpers)
- [HtmlHelpers](#htmlhelpers)
-- [`GEmojiSharp.Blazor` π¦](#gemojisharpblazor-)
-- [`GEmojiSharp.DotnetTool` π§°](#gemojisharpdotnettool-)
+- [`GEmojiSharp.Blazor`](#gemojisharpblazor)
+- [`GEmojiSharp.DotnetTool`](#gemojisharpdotnettool)
- [Installation](#installation)
- [Usage](#usage)
-- [`GEmojiSharp.PowerToysRun` π§°](#gemojisharppowertoysrun-)
+- [`GEmojiSharp.PowerToysRun`](#gemojisharppowertoysrun)
- [Installation](#installation-1)
- [Usage](#usage-1)
- [Configuration](#configuration)
@@ -45,17 +50,18 @@
:+1: This PR looks great - it's ready to merge! :shipit:
-`GEmojiSharp`, `GEmojiSharp.AspNetCore` and `GEmojiSharp.Blazor` are three libraries to make this possible in C#, Blazor and ASP.NET Core.
+`GEmojiSharp` make this possible in C#. The library contains a static array of all valid emoji in GitHub Flavored Markdown.
+That is the intersection of the [emoji.json](https://raw.githubusercontent.com/github/gemoji/master/db/emoji.json) database and the API with [available emojis](https://api.github.com/emojis).
-A list of all GitHub Emojis:
+A visual referense of all GitHub Emoji:
- https://github.com/hlaueriksson/github-emoji
-## `GEmojiSharp` π¦
+## `GEmojiSharp`
[](https://www.nuget.org/packages/GEmojiSharp/)
-> GitHub Emoji for C# and .NET
+> GitHub Emoji for C# and .NET π¦
Static methods:
@@ -67,6 +73,7 @@ Emoji.Alias("π"); // :tada:
Emoji.Emojify(":tada: initial commit"); // π initial commit
Emoji.Demojify("π initial commit"); // :tada: initial commit
Emoji.Find("party popper").First().Raw; // π
+Emoji.Get("βοΈ").RawSkinToneVariants(); // βπ», βπΌ, βπ½, βπΎ, βπΏ
```
Extension methods:
@@ -92,11 +99,11 @@ string.Join(string.Empty, matches.Select(x => x.Value)); // ππ
Regex.Replace(text, Emoji.RegexPattern, string.Empty); // Lorem ipsum
```
-## `GEmojiSharp.AspNetCore` π¦
+## `GEmojiSharp.AspNetCore`
[](https://www.nuget.org/packages/GEmojiSharp.AspNetCore/)
-> GitHub Emoji for ASP.NET Core
+> GitHub Emoji for ASP.NET Core π¦
The package includes:
@@ -241,11 +248,11 @@ Use the `Emoji` extension methods to render emojis:
@Html.Emoji(x => x.Text)
```
-## `GEmojiSharp.Blazor` π¦
+## `GEmojiSharp.Blazor`
[](https://www.nuget.org/packages/GEmojiSharp.Blazor/)
-> GitHub Emoji for Blazor
+> GitHub Emoji for Blazor π¦
The package is a Razor class library (RCL) with a Razor component.
@@ -273,11 +280,11 @@ Custom GitHub emojis are rendered as images:
```
-## `GEmojiSharp.DotnetTool` π§°
+## `GEmojiSharp.DotnetTool`
[](https://www.nuget.org/packages/GEmojiSharp.DotnetTool/)
-> GitHub Emoji dotnet tool
+> GitHub Emoji `dotnet` tool π§°
@@ -343,8 +350,9 @@ Arguments:
Find emojis via description, category, alias or tag
Options:
- -c, --copy Copy to clipboard
- -?, -h, --help Show help and usage information
+ -st, --skin-tones Include skin tone variants
+ -c, --copy Copy to clipboard
+ -?, -h, --help Show help and usage information
```
@@ -374,6 +382,22 @@ emoji r grinning cat -c
πΊπΈ
```
+Skin tone variants:
+
+```cmd
+emoji raw "victory" --skin-tones
+emoji r victory -st
+```
+
+```txt
+βοΈ
+βπ»
+βπΌ
+βπ½
+βπΎ
+βπΏ
+```
+
#### Alias
@@ -597,17 +621,17 @@ emoji export "grinning cat" -c
-## `GEmojiSharp.PowerToysRun` π§°
+## `GEmojiSharp.PowerToysRun`
[](https://github.com/hlaueriksson/GEmojiSharp/releases/download/v1.0.0/GEmojiSharp.PowerToysRun.1.0.0.zip)
-> GitHub Emoji [PowerToys Run](https://docs.microsoft.com/en-us/windows/powertoys/run) plugin
+> GitHub Emoji [PowerToys Run](https://docs.microsoft.com/en-us/windows/powertoys/run) plugin ποΈππ
### Installation
-The plugin is developed and tested with `PowerToys` `v0.57.2`.
+The plugin is developed and tested with `PowerToys` `v0.65.0`.
Install:
@@ -628,6 +652,8 @@ Install:
4. Use β¬οΈ and β¬οΈ keys to select an emoji
5. Press `Enter` to copy the selected raw emoji to clipboard
6. Press `ctrl + c` to copy the selected emoji aliases to clipboard
+7. Press `ctrl + Enter` to copy the selected raw emoji skin tone variants to clipboard
+ - For emoji that supports skin tone modifiers
Emojify: