Papis

Description

Papis is a powerful and highly extensible command-line based document and bibliography manager.

Learn more:

Take a look at the documentation!
The folks at OSTechNix have dedicated us a review, you may also check it out here.
A review in Spanish is also available at ubunlog.

Main features

Synchronizing of documents: put your documents in some folder and synchronize it using the tools you love: git, dropbox, rsync, OwnCloud, Google Drive ... whatever.
Share libraries with colleagues without forcing them to open an account, nowhere, never.
Download directly paper information from DOI number via Crossref.
(optional) scihub support, use the example papis script examples/scripts/papis-scihub to download papers from scihub and add them to your library with all the relevant information, in a matter of seconds, also you can check the documentation here.
Import from Zotero and other managers using the script in examples/scripts/papis-zotero (doc).
Create custom scripts to help you achieve great tasks easily (doc).
Export documents into many formats (bibtex, yaml..)
Command-line granularity, all the power of a library at the tip of your fingers.

Contributing

Contributions are very welcome! Take a look at the files CONTRIBUTING.md for general rules, ROADMAP.md for possible contribution topics and HACKING.md for additional code-related information.

Super quick start

Install papis with pip3

sudo pip3 install papis

Let us download a couple of documents

wget http://www.gnu.org/s/libc/manual/pdf/libc.pdf
wget http://www.ams.org/notices/201304/rnoti-p434.pdf

Now add them to the (defaultly created) library

papis add libc.pdf --author "Sandra Loosemore" --title "GNU C reference manual" --confirm
# Get paper information automatically via de DOI
papis add --from-doi 10.1090/noti963 rnoti-p434.pdf

Now open one for example

papis open

Or edit them and export them to bibtex

papis edit
papis export --all --bibtex > mylib.bib

find help messages in all commands:

papis -h
papis add -h

AND MUCH, MUCH MORE!

Installing on Other Platforms

NixOS

If you are running NixOS or you have the nix package manager installed, you can install papis by running:

nix-env -i papis

If you like papis, just clone the repository

git clone git@github.com:papis/papis.git
cd papis

and start hacking it with:

nix-shell --expr 'with import <nixpkgs> {}; papis.overrideDerivation (drv: { src = ./.; })'

This command will provide you a shell with all the dependencies required.

Authors

See the AUTHORS list for a list of authored commits.

nico202/papis