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). 🔥

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.
  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.
  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.

• 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 ! 😅

Type a shortcut from the list HERE, press space and it will automatically be replaced by the corresponding emoji or special character, it's that simple ! 🥳

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 !

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, suggest ideas to help it grow by creating an issue or even send me an email ! 🔥

Free project under the MIT license. Do what you want with it! 🚀