aboutsummarylogtreecommitdiffstats
path: root/README.md
blob: f31ce5bf8c0997f61d9d710008c156ef5a9ae6f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# purple-gnome-keyring

Plugin for your purple based instand messenger like Pidgin or Finch.
This plugin seemlessly integrates the Gnome Keyring with your instant messanger. Therefore your password are stored securely - since Pidgin itself stores passwords in plaintext.

## Usage
### Installation
- Clone repo
- Call `make`
- Call `make install` (Currently installs plugin locally)

### Integration
- Go to plugin page in the menu: `Tools->Plugins` or `with Ctrl+U`
- Enable plugin `Gnome Keyring Plugin`
- Optional: Configure plugin, e.g. to use with a separate keyring
- To move all currently active passwords to the keyring, hit
    - `Save all passwords to keyring` in menu: `Tools->Gnome Keyring Plugin`

## Progress
### Features
- Store passwords in an abitrary keyring
- Load passwords when plugin loaded
- Move or delete all passwords to / from Gnome Keyring at once
    - Actions are available in menu: `Tools->Gnome Keyring Plugin`
- Signal handling when account is created / deleted
    - If enabled in preferences, passwords of new accounts are automatically stored in the Gnome Keyring

### TODO
- Create Keyring if given keyringname does not exists
- Signal handling when account password was changed

### Testing
- Tested with Pidgin without any issues
- Tested with Finch without any issues

## Known issues
### Prevent issues
- Make sure that Gnome Keyring is running
- Make sure thad DBUS in running