3 releases (breaking)

0.7.0 Jan 29, 2020
0.5.0 Sep 26, 2018
0.4.0 Sep 26, 2018

#2417 in Command line utilities

MIT/Apache

51KB
1.5K SLoC

ripclip

ripclip crate

Description

Turns your windows clipboard into a stack! Everything you copy is pushed onto the top. Popping is done with a configurable hotkey (default Control + Shift + C.)

Features

Stack De-Duplication

If the same item is copied repeatedly, ripclip can automatically identify this and ignore the duplicate copies.

Tray Icon

A small, unobtrusive tray icon that lets you know ripclip is still running.

Configurable

All keybindings are configurable, and extra features (above) may be disabled.

Robust

ripclip uses an exponential backoff policy to try accessing the clipboard in case opening it fails (because it is open by another process).

Multi-Platform

Coming soon! If you're waiting for this, file an issue and it will motivate me :)

Configuration

Configuration is present at C:\Users\%username%\AppData\Roaming\ripclip. A default config file is written there when ripclip is first run.

The configuration options are as follows:

max_stack_size = 100

The maximum size of the stack. Any further items copied will push out the oldest (bottom) element of the stack. This can be None for a cliboard stack limited only by available memory.

show_tray_icon = true

Whether or not to enable the tray icon.

pop_keybinding = Control + Shift + C

They keybinding to remove the top item of the stack.

swap_keybinding = None

The keybinding to swap the top two items of the stack.

clear_keybinding = None

The keybinding to remove all items from the stack.

prevent_duplicate_push = false

Whether or not to prevent duplicate items from being pushed onto the stack. This only applies to the topmost item.

Known Quirks

  • Some terminal emulators for windows abuse (IMO) the windows clipboard by putting whatever you highlight into the clipboard, attempting to emulate common functionality in linux. That clogs up the stack, annoyingly. Look into your terminal emulator settings and see if this functionality can be disabled.
  • If another application tries to access the clipboard simultaneously and ripclip beats it to the punch, the other application might fail badly as it fails to access the clipboard (such as displaying an error popup, or worst-case, crashing.) There's not a lot that can be done about this; race conditions are inherit with the windows clipboard model. If possible, contact the author of the offending program and ask about implementing a retry policy for accessing the clipboard.

Debugging

Run with RUST_LOG=ripclip=trace as an environment variable to see debugging statements.

Status

Pushing, popping, swapping and clearing all should work with configurable bindings. A tray icon is available. Multi-platform is a work in progress (see above.)

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~4–12MB
~130K SLoC