Skip to content

Latest commit

 

History

History
61 lines (52 loc) · 2.13 KB

README.md

File metadata and controls

61 lines (52 loc) · 2.13 KB
Raw

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

roficlip in rofi screenshot

Requirements

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.