About

Clipboard history manager designed for using with Rofi.

Features

• Show runtime (ring) clipboard history.
• Show/Create/Delete persistent notes from clipboard.
• Define and use actions with clipboard contents.
• Desktop notifications via D-Bus.

Shots

Requirements

• pygobject
• pyyaml
• pyxdg
• docopt
• notify2

Installation

• Install requirements via your favorite package manager.
• Clone this repository to preferred place.
• Make link to roficlip.py and place it to directory listed in $PATH e.g.: ln -s ~/bin/apps/roficlip/roficlip.py ~/bin

Usage

Run clipboard watcher:

roficlip.py --daemon &

Read the help:

roficlip.py --help

Bind hotkey (combined mode):

rofi -modi "clipboard:roficlip.py --show,persistent:roficlip.py --show --persistent,actions:roficlip.py --show --actions" -show clipboard

or (single mode)

rofi -modi "clipboard:roficlip.py --show" -show clipboard

Settings

Yaml config placed in $XDG_CONFIG_HOME/roficlip/settings Example:

settings:
  ring_size: 20                 # maximum clips count.
  newline_char: '¬'             # any character for using in preview as new line marker.
  notify: True                  # allow using desktop notifications.
  notify_timeout: 1             # notification timeout in seconds.
  show_comments_first: False    # all text after last '#' moved to beginning of line (in persitent mode)
  colored_comments: False       # all text after last '#' is grayed

actions:
  'open url via mpv player': 'mpv --geometry=720x405-20-20 %s' # %s will be replaced with current clipboard content.
  'add persistent clip': 'roficlip.py --add' # save current clipboard in persistent history.
  'remove persistent clip': 'roficlip.py --remove' # remove current clipboard from persistent history.
  'clear clipboard': 'roficlip.py --clear' # clear clipboard history.