commit d0ef9dfccff0060aeb804001fd0e9f3dca83611c
parent bcbe7b144598db4a103f14e8408c4b7327d6d5e1
Author: Chris Down <chris@chrisdown.name>
Date: Tue, 24 Mar 2020 20:04:07 +0000
Merge pull request #120 from markstos/make-install
Improve manual install experience
Diffstat:
2 files changed, 29 insertions(+), 6 deletions(-)
diff --git a/Makefile b/Makefile
@@ -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
diff --git a/README.md b/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
clipboard.
-A systemd user service for starting clipmenud is included at
-[init/clipmenud.service](https://github.com/cdown/clipmenu/blob/develop/init/clipmenud.service).
-You can then start clipmenud like this:
+A systemd user service for starting clipmenud is installed as part of the project.
- 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
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
package called `clipmenu`.
-If your distribution doesn't provide a package, you can run the scripts
-standalone (or better yet, package them!).
+## Installation - Manual
+
+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?
