Skip to content

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

PawMoji

A charming kaomoji clipboard for effortlessly adding kawaii faces to your text.

Version 0.0.8 Stable


🚀 Features

  • Instant Copy-Paste
    Click any kaomoji to automatically copy it to your clipboard with a “Copied!” toast.
  • Tag-Based Filtering
    Predefined tag buttons let you filter your collection—no typing needed.
  • Light & Dark Themes
    Toggle between Catppuccin Latte (light) and Mocha (dark) palettes; your choice persists between sessions.
  • Global Hotkey
    Bring PawMoji to front or hide it with Ctrl + Shift + P (customizable in settings.json).
  • Database Manager
    Under Settings → KaomojiDB, open the editor window to add, update, or delete entries.
  • Auto-Correct Tags
    When editing tags, small typos (≤ 1 edit) auto-correct to existing tags.
  • Responsive & Animated
    Window resizes smoothly, and UI elements animate on hover and click.

📦 Installation

Windows:

Download the installer and install PawMoji onto your system


Linux:

  1. Download install.sh
  2. sudo bash install.sh

🧰 Developer Setup:

  1. Clone & Install
    git clone https://github.com/MrMidnight7331/PawMoji.git
    cd pawmoji
    npm install
  2. Run in Development
    npm start
  3. Build for Distribution
    npm run build
    Generates installers in dist/ for your platform.

📔 Changelog

  • v0.0.8

    • Patch Release
    • Ensured consistent settings path and added escaping of all Discord markdown chars (*, _, ~, `) #
    • Added a Window Resize button under Settings (resets to 400x800 pixels)
    • Fixed: not being able to access the Menu Bar when backgrounding and reopening the application
  • v0.0.7

    • Initial Release
    • Added cross-platform packaging (NSIS installer for Windows, AppImage for Linux)
    • Implemented global hotkey (Ctrl+Shift+P) and system tray icon
    • Added Discord Escape mode to prefix backslashes for markdown-safe copying
    • Persisted theme and escape settings in settings.json
    • Enforced single-instance lock to prevent multiple windows
    • Default data folder set to ~/Documents/PawMoji

🖥️ Usage

  • Open PawMoji
    • From your Applications/Start menu or via npm start.
    • Press your global hotkey (Ctrl + Shift + P by default) to hide or display the active window.
  • Copy a Kaomoji
    • Click any displayed kaomoji; it’s copied and a “Copied!” bubble appears.
  • Filter by Tag
    • Click “Show All” or any tag button to refresh the list.
    • Buttons wrap and remain centered up to a 400 px width.
  • Switch Theme
    • Toggle the slider next to “Show All” to switch palettes.
  • Manage Database
    • Go to Settings → KaomojiDB to open the DB editor.
    • Click to add a row, fill in kaomoji & tags, then save (💾).
    • Delete unwanted entries with the 🗑️ button.
    • Editor window auto-resizes (max 800 px tall) and scrolls as needed.

⚙️ Configuration

  • Data Folder
    On first run, choose where to store:
    • kaomoji.db – your kaomoji entries
    • settings.json – stores theme & hotkey
  • settings.json
    Located in your chosen folder, e.g. ~/Documents/PawMoji/settings.json:
    {
      "theme": "dark",
      "hotkey": "CommandOrControl+Shift+P"
    }
  • styles.css
    Template shipped in src/styles.css – copy to your data folder and tweak colors, fonts, or animations; PawMoji auto-loads it on launch.

🛠️ Known Issues

Linux

  1. Window Manager quirks

    The global hotkey for show/hide can be unreliable on window managers.

  2. Startup lag

    Noticeable delay on launch under window managers.

🎨 Theming

PawMoji leverages Catppuccin color palettes:

  • Latte (light) – rosewater, flamingo, mauve, peach, green, blue…
  • Mocha (dark) – rosewater, flamingo, mauve, peach, green, blue…

Customize these in your local styles.css under :root (light) and .dark-theme (dark) variables.


🤝 Contributing

  1. Fork the repo
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit changes: git commit -am "Add my feature"
  4. Push: git push origin feature/my-feature
  5. Open a Pull Request

🫰 Donation

ETH: 0x939A9353e1a72e5d6Da07424c74815a6651a86f4

MATIC: 0x939A9353e1a72e5d6Da07424c74815a6651a86f4

SOLANA: HsNpPDGhDsmq4j1PBTDuMx67svj6446m8aUWGSpjGCjk

BTC: bc1q55kfd0elssc9u3ha86gw4ea9w3l5cw7ch58hce

Or buy me a coffee here:

ko-fi


📜 License

MIT © MrMidnight


Enjoy adding kawaii flair to your text with PawMoji! 🐾✨

About

A charming kaomoji clipboard for effortlessly adding kawaii faces to your text

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages