speedie/clipmenu-spmenu
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Improve manual install experience

Browse source 
- 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:
Mark Stosberg 2020-03-12 17:14:50 -04:00
parent bcbe7b1445
commit a3916b8e11
2 changed files with 29 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
Makefile Normal file
View 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
View file

@ -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?