XivAr

Rust

Manage your local scientific library!

This tool is in a very early development stage.

Installation

First, install fzf. (required)

Then install xivar via

bash cargo install xivar

Usage

xivar lets you search publications online at DBLP and arXiv, and open or download them if available. xivar saves the locations of downloaded publications and shows them in your next search.

Search

Search a publication online and local

bash xivar search keyword1 keyword2 ...

Search only locally saved files

bash xivar local keyword1 keyword2 ...

Specify a maximum number of hits (default is 100)

bash xivar search bla bla -n 30

Clean

Clean your database, i.e. remove entries of publications which cannot be found at their saved location.

bash xivar clean

Add

Add a local pdf to the database.

bash xivar add paper.pdf

If xivar finds any metadata in the PDF-file, you can confirm to search the title online. If you can find the matching paper online, all necessary information will be fetched and written to your library. Otherwise, you have to manually enter them.

Configuration

In Linux-based systems, the database is located at ~/.local/share/xivar. Since this is still very much work in progress, the database may be corrupt after updating to a new version!

You can configure the default download location via a configuration file located at ~/.config/xivar/xivar.toml with the following content

toml document_dir = "absolute/path/to/directory"

Roadmap