clipmenu-sh

clipmenu-sh is a light and portable clipmenu alternative.

Features:

• Save clipboard to a cache,
• Pass this clipboad cache to a menu,
• Clean this clipboard cache at limit.

Dependencies:

• a POSIX shell,
• X11, xclip, a Window Manager,
• dmenu, rofi, or any menu able to receive a pipe.

Demo

1. Clone the repository:

   git clone https://gitlab.com/ddeh84/clipmenu-sh.git ~/Git/clipmenu-sh

2. Link the shell scripts to a bin directory:

   ln -vs ~/Git/clipmenu-sh/*.sh ~/.local/bin/

3. Add the deamon shell script to the xinitrc file before the last line running the Window Manager:

   sed -i '$i\
   clipemnud.sh&
   ' ~/.xinitrc

4. Add the command shell script to the Window Manager keybindings.

   For DWM:

   static const char *clipboardcmd[]  = { "clipmenu.sh", NULL };
   
   static const Key keys[] = {
     { MODKEY,                  XK_c,    spawn,        {.v = clipboardcmd }  },

   Then rebuild it.

   For AwesomeWM:

    awful.key({ modkey, }, "c", function() awful.util.spawn("clipmenu.sh") end,
              {description="launch clipmenu", group="launcher"}),

   Then reload it.

• Remove all files:

  rm -vri ~/.cache/clipmenu-sh ~/.config/clipemnu-sh ~/Git/clipmenu-sh

Configuration goes to $HOME/.config/clipmenu-sh:

CACHE_DIRECTORY="$HOME/.cache/clipmenu-sh"
CACHE_LIMIT=50
MENU_COMMAND='rofi -dmenu -p clipboard -i -no-sort'

For support, please open an issue on the GitLab issue tracker.

• Handle encryption and decryption.

Contributions are welcome! Please follow these steps:

1. Fork the repository on GitLab
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Merge Request

Please ensure your changes are well-tested and follow the existing code style.

This project was created by ddeh84.

Special thanks to all contributors who have helped improve this project.

GNU GPLv3

This project is actively maintained in early stage. New features and bug fixes are released regularly.