https://github.com/serpent7776/clip-dmenu
tool executing commands with clipboard contents as argument
https://github.com/serpent7776/clip-dmenu
actions clipboard commands dmenu execute rofi
Last synced: 6 months ago
JSON representation
tool executing commands with clipboard contents as argument
- Host: GitHub
- URL: https://github.com/serpent7776/clip-dmenu
- Owner: serpent7776
- License: bsd-2-clause
- Created: 2018-05-31T09:49:05.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-12-21T17:46:58.000Z (about 7 years ago)
- Last Synced: 2025-03-11T20:48:36.385Z (11 months ago)
- Topics: actions, clipboard, commands, dmenu, execute, rofi
- Language: Perl
- Size: 14.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clip-dmenu
This tool executes commands with clipboard contents as argument.
It is meant to be used with clipboard manager that doesn't support performing actions on clipboard contents.
## Config file
`clip-dmenu` reads actions form file `~/.config/clip-dmenu/config`.
It's format is very simple:
```
action-1-name: actions-1-command
action-2-name: actions-2-command
```
`action-name` is displayed label to identify command.
`action-command` is a command that will be executed when this action will be selected from a menu. Any occurence of `%s` will be replaced with clipboard contents.
Name should be separated from a command by a tab.
See `config.sample` file for an example.
## Invocation
`clip-dmenu [OPTIONS]`
where OPTIONS may be:
--file
-f specifies path to config file
--background
-b run selected command in the background
--command
-c specify command to run instead of `dmenu`
--help
-h show help
--version show version information
## Dependencies
- perl
- Clipboard perl module (optional) with fallback to `xclip` utility
- dmenu (or equivalent, like rofi)