Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/toofuw/shortmoji

ShortMoji is a lightweight python program that makes it easy to insert emojis and special characters anywhere with simple keyboard shortcuts (similar to Discord's emoji system).
https://github.com/toofuw/shortmoji

desktop-app emoji emoji-keyboard emoticon keyboard keyboard-shortcuts python shortcut windows windows-app

Last synced: 9 months ago
JSON representation

ShortMoji is a lightweight python program that makes it easy to insert emojis and special characters anywhere with simple keyboard shortcuts (similar to Discord's emoji system).

Awesome Lists containing this project

README 

          


    




ShortMoji [:๐Ÿค“]





    

        Latest Release

    

    

        Latest Commit

    

    

        GNU License

    

    

        GitHub stars

    




ShortMoji makes it easy to insert emojis and special characters anywhere with simple keyboard shortcuts (similar to Discord's emoji system). ๐Ÿ”ฅ



## Keyboard Shortcuts



(Click here to see the full list) 140+ SHORTCUTS FOR 140+ UNIQUE EMOJIS AND SPECIAL CHARACTERS ! ๐Ÿคช



| Shortcut | ร‰moji |

|-|-|

| `:gri `  | ๐Ÿ˜€ |

| `:smi `  | ๐Ÿ˜„ |

| `:la `   | ๐Ÿ˜† |

| `:ro `   | ๐Ÿคฃ |

| `:sl `   | ๐Ÿ™‚ |

| `:wi `   | ๐Ÿ˜‰ |

| `:in `   | ๐Ÿ˜‡ |

| `:sm `   | ๐Ÿ˜ƒ |

| `:gr `   | ๐Ÿ˜ |

| `:sw `   | ๐Ÿ˜… |

| `:jo `   | ๐Ÿ˜‚ |

| `:up `   | ๐Ÿ™ƒ |

| `:bl `   | ๐Ÿ˜Š |

| `:3h `   | ๐Ÿฅฐ |

| `:st `   | ๐Ÿคฉ |

| `:kisc ` | ๐Ÿ˜š |

| `:te `   | ๐Ÿฅฒ |

| `:hea `  | ๐Ÿ˜ |

| `:ki `   | ๐Ÿ˜˜ |

| `:rel `  | โ˜บ๏ธ |

| `:kis `  | ๐Ÿ˜™ |

| `:yu `   | ๐Ÿ˜‹ |

| `:stuw ` | ๐Ÿ˜œ |

| `:stuc ` | ๐Ÿ˜ |

| `:stu `  | ๐Ÿ˜› |

| `:za `   | ๐Ÿคช |

| `:mo `   | ๐Ÿค‘ |

| `:sa `   | ๐Ÿซก |

| `:hu `   | ๐Ÿค— |

| `:sh `   | ๐Ÿคซ |

| `:ha `   | ๐Ÿคญ |

| `:th `   | ๐Ÿค” |

| `:zi `   | ๐Ÿค |

| `:ner `  | ๐Ÿ˜ |

| `:no `   | ๐Ÿ˜ถ |

| `:smir ` | ๐Ÿ˜ |

| `:rol `  | ๐Ÿ™„ |

| `:fa `   | ๐Ÿ˜ฎโ€๐Ÿ’จ |

| `:ra `   | ๐Ÿคจ |

| `:exp `  | ๐Ÿ˜‘ |

| `:fac `  | ๐Ÿ˜ถโ€๐ŸŒซ๏ธ |

| `:un `   | ๐Ÿ˜’ |

| `:grim ` | ๐Ÿ˜ฌ |

| `:ly `   | ๐Ÿคฅ |

| `:re `   | ๐Ÿ˜Œ |

| `:slee ` | ๐Ÿ˜ช |

| `:sle `  | ๐Ÿ˜ด |

| `:pe `   | ๐Ÿ˜” |

| `:dr `   | ๐Ÿคค |

| `:ma `   | ๐Ÿ˜ท |

| `:ba `   | ๐Ÿค• |

| `:vo `   | ๐Ÿคฎ |

| `:ho `   | ๐Ÿฅต |

| `:wo `   | ๐Ÿฅด |

| `:sp `   | ๐Ÿ˜ตโ€๐Ÿ’ซ |

| `:the `  | ๐Ÿค’ |

| `:na `   | ๐Ÿคข |

| `:sn `   | ๐Ÿคง |

| `:co `   | ๐Ÿฅถ |

| `:di `   | ๐Ÿ˜ต |

| `:ex `   | ๐Ÿคฏ |

| `:cow `  | ๐Ÿค  |

| `:dis `  | ๐Ÿฅธ |

| `:pa `   | ๐Ÿฅณ |

| `:su `   | ๐Ÿ˜Ž |

| `:ne `   | ๐Ÿค“ |

| `:mon `  | ๐Ÿง |

| `:con `  | ๐Ÿ˜• |

| `:sli `  | ๐Ÿ™ |

| `:op `   | ๐Ÿ˜ฎ |

| `:as `   | ๐Ÿ˜ฒ |

| `:pl `   | ๐Ÿฅบ |

| `:an `   | ๐Ÿ˜ง |

| `:col `  | ๐Ÿ˜ฐ |

| `:cr `   | ๐Ÿ˜ข |

| `:sc `   | ๐Ÿ˜ฑ |

| `:per `  | ๐Ÿ˜ฃ |

| `:swe `  | ๐Ÿ˜“ |

| `:ti `   | ๐Ÿ˜ซ |

| `:wor `  | ๐Ÿ˜Ÿ |

| `:fr `   | โ˜น๏ธ |

| `:hus `  | ๐Ÿ˜ฏ |

| `:fl `   | ๐Ÿ˜ณ |

| `:fro `  | ๐Ÿ˜ฆ |

| `:fe `   | ๐Ÿ˜จ |

| `:disr ` | ๐Ÿ˜ฅ |

| `:so `   | ๐Ÿ˜ญ |

| `:conf ` | ๐Ÿ˜– |

| `:disa ` | ๐Ÿ˜ž |

| `:we `   | ๐Ÿ˜ฉ |

| `:ya `   | ๐Ÿฅฑ |

| `:tr `   | ๐Ÿ˜ค |

| `:ang `  | ๐Ÿ˜  |

| `:imps ` | ๐Ÿ˜ˆ |

| `:sk `   | ๐Ÿ’€ |

| `:po `   | ๐Ÿ˜ก |

| `:cu `   | ๐Ÿคฌ |

| `:im `   | ๐Ÿ‘ฟ |

| `:cro `  | โ˜ ๏ธ |

| `:poo `  | ๐Ÿ’ฉ |

| `:og `   | ๐Ÿ‘น |

| `:gh `   | ๐Ÿ‘ป |

| `:inv `  | ๐Ÿ‘พ |

| `:cl `   | ๐Ÿคก |

| `:gob `  | ๐Ÿ‘บ |

| `:al `   | ๐Ÿ‘ฝ |

| `:rob `  | ๐Ÿค– |

| `:cs `   | ๐Ÿ˜บ |

| `:cj `   | ๐Ÿ˜น |

| `:csm `  | ๐Ÿ˜ผ |

| `:csc `  | ๐Ÿ™€ |

| `:cp `   | ๐Ÿ˜พ |

| `:csmi ` | ๐Ÿ˜ธ |

| `:ch `   | ๐Ÿ˜ป |

| `:ck `   | ๐Ÿ˜ฝ |

| `:cc `   | ๐Ÿ˜ฟ |

| `:se `   | ๐Ÿ™ˆ |

| `:spe `  | ๐Ÿ™Š |

| `:hear ` | ๐Ÿ™‰ |

| `:lo `   | ๐Ÿ’Œ |

| `:gi `   | ๐Ÿ’ |

| `:heart `| ๐Ÿ’— |

| `:rev `  | ๐Ÿ’ž |

| `:he `   | โค๏ธ |

| `:kiss ` | ๐Ÿ’‹ |

| `:wa `   | ๐Ÿ‘‹ |

| `:fu `   | ๐Ÿ–• |

| `:tu `   | ๐Ÿ‘ |

| `:td `   | ๐Ÿ‘Ž |

| `:pr `   | ๐Ÿ™ |

| `:ey `   | ๐Ÿ‘€ |

| `:go `   | ๐Ÿ |

| `:fi `   | ๐Ÿ”ฅ |

| `:moy `  | ๐Ÿ—ฟ |

| `:spa `  | โœจ |

| `:au `   | โฌ†๏ธ |

| `:ar `   | โžก๏ธ |

| `:ad `   | โฌ‡๏ธ |

| `:ale `  | โฌ…๏ธ |

| `:che `  | โœ… |

| `:x `    | โŒ |



| Shortcut | Special character |

|-|-|

| `:>> `   | โ†’ |

| `:<< `   | โ† |

| `:ร  `    | ร€ |

| `:รฉ `    | ร‰ |

| `:pi `   | ฯ€ |

| `:si `   | ฯƒ |



You can find the JSON where they are stored [HERE](https://github.com/TooFuW/ShortMoji/blob/main/emojis.json)



## Installation

### Download the latest version [HERE](https://github.com/TooFuW/ShortMoji/releases/latest) ! ๐Ÿคฉ



### If you are on MacOS or Linux you will have to run the python file `main.py` because the executable will not work (but you can also execute the python file even if you are on Windows) :



Download the source code and make sure `Python 3.12.7` is installed on your system. You can check your Python version with `python3 --version`.  

- **Windows** :  

If Python is not installed or you need to update it, download the version 3.12 or later at [python.org](https://www.python.org/downloads/).  

Once python is installed, install the required libraries using pip : `pip install pyautogui pynput pyperclip pystray PIL webbrowser`.  

Then run the following script in the same directory as `main.py` : `python3 main.py`.  



- **MacOS** :  

If Python is not installed or you need to update it :  

    - Install Homebrew (if not already installed) with `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`.  

    - Install Python with `brew install python@3.12`.  

    - Or to update it use `brew upgrade python@3.12`.  



    Install the required libraries using pip : `pip install pyautogui pynput pyperclip pystray PIL webbrowser`.  

    Then run the following script in the same directory as `main.py` : `python3 main.py`.  



    On macOS, some features (like `pyautogui` and `pynput`) require accessibility permissions :  

    Open `System Preferences` > `Security & Privacy` > `Accessibility`.  

    Add your terminal or IDE to the list of allowed apps.

- **Linux** :  

Use your package manager to install Python. For example :  

On **Debian/Ubuntu** type `sudo apt update` and then `sudo apt install python3.12`.  

On **Fedora** type `sudo dnf install python3.12`.  



    If the latest version is not available via your package manager, you can install Python manually :  

    Download the latest source code from [python.org](https://www.python.org/downloads/).  

    Follow the instructions for compiling and installing.



    Install the required libraries using pip : `pip install pyautogui pynput pyperclip pystray PIL webbrowser`.  

    Then run the following script in the same directory as `main.py` : `python3 main.py`.  



### How to automatically launch ShortMoji on startup :

- **Windows** :  

Press `โŠž Win`+`R` and type `shell:startup`.  

Then create a shortcut (`Right-click` -> `New` -> `Shortcut`),  

And paste the path to `ShortMoji.exe` (for example `C:\Users\User\Downloads\ShortMoji.exe`).  

Click `Enter`.

- **MacOS** :  

Click the Apple logo in the top left corner and select `System Preferences`.  

Click on `Users & Groups`.  

Select the user account you want to add the application to.  

Click on `Login Items`.  

Click the `+` button at the bottom of the list.  

Navigate to the location of `ShortMoji.app` (e.g. `Applications/ShortMoji.app`) and select it.  

Click `Add`.

- **Linux** :  

Open a terminal and navigate to the `~/.config/autostart` directory.  

Create a new file called `shortmoji.desktop` with the following contents:  

    ```

    [Desktop Entry]

    Type=Application

    Exec=/path/to/ShortMoji

    Hidden=false

    NoDisplay=false

    X-GNOME-Autostart-enabled=true

    ```

    Replace `/path/to/shortmoji` with the path to the `ShortMoji` executable.



*Your antivirus might flag the program as a virus on the first run but it's a false positive (you can check the code, everything is in main.py) don't worry !* ๐Ÿ˜…



## How to use it

Type a shortcut from the list [HERE](https://github.com/TooFuW/ShortMoji?tab=readme-ov-file#keyboard-shortcuts), press `space` and it will automatically be replaced by the corresponding emoji or special character, it's that simple ! ๐Ÿฅณ



![Gif](https://github.com/TooFuW/ShortMoji/blob/main/img/ShortMojiGif.gif)



*The program may not always work in system applications (e.g. Task Manager) because the OS blocks keyboard access at that time*



**If you want to close the program, you can close it from the system tray !**



## Usage and Features

Launch ShortMoji and start typing your shortcuts to see your emojis appear automatically ! โœจ



- **Easy shortcuts** : If you are already using Discord then it should be easy for you to start using ShortMoji, else GO LEARN THE SHORTCUTS ! ๐Ÿ—ฟ



- **Fast correction** : If you misspell a shortcut, you can retype it (if you do it right away) and it will still be replaced ! ๐Ÿ˜Ž



- **Lightweight program** : ShortMoji is a lightweight utility program that doesn't slow down your system. And if you want, you can easily close the program with the icon in the system tray ! ๐Ÿค“



- **System tray** : The program also has a system tray icon that you can click to see the repository or close the program ! ๐Ÿ’ป



- **Audience** : Whether you're a developper looking for efficiency, a casual user who enjoys using emojis or a Discord user who's already familiar with emoji shortcuts, ShortMoji is the perfect tool for you ! ๐Ÿค 



- **Support** : I'm committed to regularly update ShortMoji with new emojis and features. Contributions are welcome, submit [pull requests](https://github.com/TooFuW/ShortMoji/compare), suggest ideas to help it grow by creating an [issue](https://github.com/TooFuW/ShortMoji/issues/new) or even send me an [email](mailto:eyrianmuet@proton.me) ! ๐Ÿ”ฅ



## Licence

Free project under the [MIT license](https://github.com/TooFuW/ShortMoji/blob/main/LICENSE). Do what you want with it! ๐Ÿš€