This command will try its best to find a source in the internet for the document at hand.

If the document has an URL key in its info.yaml file, it will use this URL to open it in a browser. Also if it has a doc_url key, or a DOI, it will try to compose URLs out of these to open it.

If none of the above work, then it will try to use a search engine with the document’s information (using the browse-query-format configuration option). You can select which search engine you want to use with the search-engine setting.


By default, it will use the configuration option browse-key to try and form an URL to browse. You can bypass this option using the -k flag issuing the command

papis browse -k doi einstein

This will form an URL through the DOI of the document. Similarly,

papis browse -k isbn

will form an URL through the ISBN of the document using It can also use

papis browse -k ads

to form an URL using the great ADS service and there you can check for similar papers, citations, references and much more. Please note that for this to work the document should have a DOI attached to it. Using

papis browse -k whatever

will consider the key whatever from the document to be a valid URL, assuming at this point that you’ll know what you’re doing. Finally, the default

papis browse -k search-engine

will do a search-engine search with the data of your paper and hopefully you’ll find it there.

Command-line Interface

Open document’s url in a browser

papis browse [OPTIONS] [QUERY]


-h, --help

Show this message and exit.

--sort <FIELD>

Sort documents with respect to the FIELD


Reverse sort order

-k, --key <key>

Use the value of the document’s key to open in the browser, e.g. doi, url, doc_url …

-n, --print

Just print out the url, do not open it with browser

-a, --all

Apply action to all matching documents

--doc-folder <doc_folder>

Document folder on which to apply action



Optional argument