Improve manual install experience
- Add Makefile to install files - It even checks for required binaries - Document manual install steps - Document how to start and enable via systemd
This commit is contained in:
parent
bcbe7b1445
commit
a3916b8e11
13
Makefile
Normal file
13
Makefile
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
# `dmenu` is not a hard dependency, but you need it unless
|
||||||
|
# you plan to set CM_LAUNCHER to another value like `rofi`
|
||||||
|
REQUIRED_BINS := xsel clipnotify
|
||||||
|
$(foreach bin,$(REQUIRED_BINS),\
|
||||||
|
$(if $(shell command -v $(bin) 2> /dev/null),$(info Found `$(bin)`),$(error Missing Dep. Please install `$(bin)`)))
|
||||||
|
|
||||||
|
.PHONY: install
|
||||||
|
|
||||||
|
install:
|
||||||
|
install -D -m755 clipmenu /usr/bin/clipmenu
|
||||||
|
install -D -m755 clipmenud /usr/bin/clipmenud
|
||||||
|
install -D -m755 clipdel /usr/bin/clipdel
|
||||||
|
install -D -m644 init/clipmenud.service /usr/lib/systemd/user/clipmenud.service
|
22
README.md
22
README.md
|
@ -12,11 +12,13 @@ clipmenu is a simple clipboard manager using [dmenu][] (or [rofi][] with
|
||||||
Start `clipmenud`, then run `clipmenu` to select something to put on the
|
Start `clipmenud`, then run `clipmenu` to select something to put on the
|
||||||
clipboard.
|
clipboard.
|
||||||
|
|
||||||
A systemd user service for starting clipmenud is included at
|
A systemd user service for starting clipmenud is installed as part of the project.
|
||||||
[init/clipmenud.service](https://github.com/cdown/clipmenu/blob/develop/init/clipmenud.service).
|
|
||||||
You can then start clipmenud like this:
|
|
||||||
|
|
||||||
systemctl --user start clipmenud
|
If you want to start `clipmenud` immediately via systemd and have it be started when you login, run:
|
||||||
|
|
||||||
|
systemctl --user enable --now clipmenud
|
||||||
|
|
||||||
|
You may wish to bind a shortcut in your window manager to launch `clipmenu`.
|
||||||
|
|
||||||
All args passed to clipmenu are transparently dispatched to dmenu. That is, if
|
All args passed to clipmenu are transparently dispatched to dmenu. That is, if
|
||||||
you usually call dmenu with args to set colours and other properties, you can
|
you usually call dmenu with args to set colours and other properties, you can
|
||||||
|
@ -37,8 +39,16 @@ For a full list of environment variables that clipmenud can take, please see
|
||||||
Several distributions, including Arch and Nix, provide clipmenu as an official
|
Several distributions, including Arch and Nix, provide clipmenu as an official
|
||||||
package called `clipmenu`.
|
package called `clipmenu`.
|
||||||
|
|
||||||
If your distribution doesn't provide a package, you can run the scripts
|
## Installation - Manual
|
||||||
standalone (or better yet, package them!).
|
|
||||||
|
If your distribution doesn't provide a package, you can run the following
|
||||||
|
the commands to install this. (Or better yet, create package for your distribution!).
|
||||||
|
You'll first need to install `xsel` and `clipnotify`. If you'll also need `dmenu` unless
|
||||||
|
you plan to set `CM_LAUNCHER` to a different value, like `rofi`.
|
||||||
|
|
||||||
|
git clone https://github.com/cdown/clipmenu.git
|
||||||
|
cd clipmenu
|
||||||
|
sudo make install
|
||||||
|
|
||||||
# How does it work?
|
# How does it work?
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue