README.md
1# Plasma Pass
2
3Plasma Pass is a Plasma applet to access password from [pass, the standard UNIX password manager](https://www.passwordstore.org).
4
5More details and a video in [my blog post about Plasma Pass](https://www.dvratil.cz/2018/05/plasma-pass/).
6
7You don't need the *pass* utility installed on your system in order for Plasma Pass to work,
8only GnuPG is needed in order to be able to decrypt the password.
9
10Plasma Pass looks for the password directory by default in `$HOME/.password-store`, but
11it can be customized through `PASSWORD_STORE_DIR` environment variable.
12
13## Build Instructions
14
151) Install necessary dependencies
16
17Fedora:
18
19 dnf install qt5-qtbase-devel qt5-qtdeclarative-devel kf5-plasma-devel kf5-ki18n-devel kf5-kitemmodels-devel
20
21Debian/Ubuntu:
22
23 apt-get install qtbase5-dev qtdeclarative5-dev libkf5plasma-dev libkf5i18n-dev libkf5itemmodels-dev
24
252) Clone source code:
26
27 git clone https://anongit.kde.org/plasma-pass.git
28
293) Compile:
30
31 cd plasma-pass
32 mkdir build
33 cd build
34 cmake -DCMAKE_INSTALL_PREFIX=YOURPREFIX ..
35 make
36 make install
37
38(replace `YOURPREFIX` with where your Plasma is installed)
39
404) Restart Plasma:
41
42 kquitapp5 plasmashell
43 plasmashell &
44
45
46Alternatively you can also view the applet with `plasmoidviewer`:
47
48 plasmoidviewer -a org.kde.plasma.pass
49
50