2019-07-22 22:53:30 +00:00
|
|
|
|
<img align="right" src="./artwork/logo-only.svg" height="150px" style="padding-left: 20px"/>
|
|
|
|
|
|
|
2020-03-26 17:26:00 +00:00
|
|
|
|
[](https://travis-ci.org/eikek/docspell)
|
|
|
|
|
|
[](https://scala-steward.org)
|
|
|
|
|
|
|
2019-07-22 22:53:30 +00:00
|
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
# Docspell
|
2019-07-22 22:53:30 +00:00
|
|
|
|
|
|
|
|
|
|
Docspell is a personal document organizer. You'll need a scanner to
|
|
|
|
|
|
convert your papers into PDF files. Docspell can then assist in
|
|
|
|
|
|
organizing the resulting mess :wink:.
|
|
|
|
|
|
|
2020-01-11 21:12:51 +00:00
|
|
|
|
You can associate tags, set correspondends, what a document is
|
|
|
|
|
|
concerned with, a name, a date and some more. If your documents are
|
|
|
|
|
|
associated with this meta data, you should be able to quickly find
|
|
|
|
|
|
them later using the search feature. But adding this manually to each
|
|
|
|
|
|
document is a tedious task. What if most of it could be done
|
|
|
|
|
|
automatically?
|
|
|
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
It is provided as a REST server and a web application.
|
|
|
|
|
|
|
2020-01-11 21:12:51 +00:00
|
|
|
|
## How it works
|
|
|
|
|
|
|
|
|
|
|
|
Documents have two main properties: a correspondent (sender or
|
|
|
|
|
|
receiver that is not you) and something the document is about. Usually
|
|
|
|
|
|
it is about a person or some thing – maybe your car, or contracts
|
|
|
|
|
|
concerning some familiy member, etc.
|
|
|
|
|
|
|
|
|
|
|
|
1. You maintain a kind of address book. It should list all possible
|
|
|
|
|
|
correspondents and the concerning people/things. This grows
|
|
|
|
|
|
incrementally with each *new unknown* document.
|
|
|
|
|
|
2. When docspell analyzes a document, it tries to find matches within
|
|
|
|
|
|
your address book. It can detect the correspondent and a concerning
|
|
|
|
|
|
person or thing. It will then associate this data to your
|
|
|
|
|
|
documents.
|
|
|
|
|
|
3. You can inspect what docspell has done and correct it. If docspell
|
|
|
|
|
|
has found multiple suggestions, they will be shown for you to
|
|
|
|
|
|
select one. If it is not correctly associated, very often the
|
|
|
|
|
|
correct one is just one click away.
|
|
|
|
|
|
|
|
|
|
|
|
The set of meta data, that docspell uses to draw suggestions from,
|
|
|
|
|
|
must be maintained manually. But usually, this data doesn't grow as
|
|
|
|
|
|
fast as the documents. After a while there is a quite complete address
|
|
|
|
|
|
book and only once in a while it has to be revisited.
|
|
|
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
|
2020-03-31 20:54:09 +00:00
|
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
|
|
- Install the [provided](https://github.com/eikek/docspell/releases)
|
|
|
|
|
|
`deb` file at your debian based system.
|
|
|
|
|
|
- Download [provided](https://github.com/eikek/docspell/releases) zip
|
|
|
|
|
|
file and run the script in `bin/`, as [described
|
|
|
|
|
|
here](https://docspell.org/getit#using-zip-files).
|
|
|
|
|
|
- Using the [nix](https://nixos.org/nix) package manager as [described
|
|
|
|
|
|
here](https://docspell.org/doc/nix). A a NixOS module is
|
|
|
|
|
|
available, too.
|
|
|
|
|
|
- Using Docker, as [described
|
|
|
|
|
|
here](https://docspell.org/getit#docker).
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-01-12 12:56:50 +00:00
|
|
|
|
## Documentation
|
|
|
|
|
|
|
2020-03-28 15:35:28 +00:00
|
|
|
|
The [documentation site](https://docspell.org) provides more
|
|
|
|
|
|
information.
|
2020-02-08 17:05:21 +00:00
|
|
|
|
|
|
|
|
|
|
Check the feature list and the quickstart guide to try it out:
|
|
|
|
|
|
|
2020-03-28 15:35:28 +00:00
|
|
|
|
- [Features](https://docspell.org/features)
|
|
|
|
|
|
- [Quickstart](https://docspell.org/getit)
|
2020-03-01 13:19:24 +00:00
|
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
|
2020-03-01 13:19:24 +00:00
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
Here are some (outdated) screenshots, for getting a first impression
|
|
|
|
|
|
of the web ui.
|
|
|
|
|
|
|
2020-03-01 13:19:24 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
