Is there documentation/user manual for this?

The only current documentation is "gkeyring --help".

If you want to use gkeyring features from a Python script, just have a look at the "gnomekeyring" module. Because gkeyring is nothing but a shell wrapper to gnomekeyring module. gnomekeyring will provide you with everything you might need and it will be easier for you to use.

Have a look at gkeyring's source code to see some examples how to use gnomekeyring module. It's quite easy when you get the basics how Gnome Keyring works. Unfortunately the documentation of gnomekeyring is really scarce, usually you have to read the C library documentation.

Thanks. Where can I find Python docs for that module? All i can find is C.

I usually use ipython to import the keyring and inspect the methods available, it at least shows the number of arguments and their names. Not much, I know. The rest of it you must read up from C documentation (and bend it a little to cover the Python's differences).

I will try ipython. I have no knowledge of C whatsoever.