docspell/README.md

66 lines
3.2 KiB
Markdown
Raw Normal View History

<img align="right" src="./artwork/logo-only.svg" height="150px" style="padding-left: 20px"/>
2020-03-26 17:26:00 +00:00
[![Build Status](https://travis-ci.org/eikek/docspell.svg?branch=master)](https://travis-ci.org/eikek/docspell)
[![Scala Steward badge](https://img.shields.io/badge/Scala_Steward-helping-blue.svg?style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAQCAMAAAARSr4IAAAAVFBMVEUAAACHjojlOy5NWlrKzcYRKjGFjIbp293YycuLa3pYY2LSqql4f3pCUFTgSjNodYRmcXUsPD/NTTbjRS+2jomhgnzNc223cGvZS0HaSD0XLjbaSjElhIr+AAAAAXRSTlMAQObYZgAAAHlJREFUCNdNyosOwyAIhWHAQS1Vt7a77/3fcxxdmv0xwmckutAR1nkm4ggbyEcg/wWmlGLDAA3oL50xi6fk5ffZ3E2E3QfZDCcCN2YtbEWZt+Drc6u6rlqv7Uk0LdKqqr5rk2UCRXOk0vmQKGfc94nOJyQjouF9H/wCc9gECEYfONoAAAAASUVORK5CYII=)](https://scala-steward.org)
2020-03-27 18:47:55 +00:00
# Docspell
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-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
![screenshot-1](https://raw.githubusercontent.com/eikek/docspell/master/modules/microsite/src/main/resources/microsite/img/docspell-curate-1.jpg)
![screenshot-2](https://raw.githubusercontent.com/eikek/docspell/master/modules/microsite/src/main/resources/microsite/img/docspell-curate-2.jpg)
![screenshot-3](https://raw.githubusercontent.com/eikek/docspell/master/modules/microsite/src/main/resources/microsite/img/processing-queue.jpg)