mirror of
https://github.com/TheAnachronism/docspell.git
synced 2024-11-13 02:31:10 +00:00
105 lines
5.1 KiB
Markdown
105 lines
5.1 KiB
Markdown
<img align="right" src="./artwork/logo-only.svg" height="150px" style="padding-left: 20px"/>
|
|
|
|
[![Build Status](https://img.shields.io/travis/eikek/docspell/master?style=for-the-badge&logo=travisci)](https://travis-ci.org/eikek/docspell)
|
|
[![Scala Steward badge](https://img.shields.io/badge/Scala_Steward-helping-blue.svg?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAQCAMAAAARSr4IAAAAVFBMVEUAAACHjojlOy5NWlrKzcYRKjGFjIbp293YycuLa3pYY2LSqql4f3pCUFTgSjNodYRmcXUsPD/NTTbjRS+2jomhgnzNc223cGvZS0HaSD0XLjbaSjElhIr+AAAAAXRSTlMAQObYZgAAAHlJREFUCNdNyosOwyAIhWHAQS1Vt7a77/3fcxxdmv0xwmckutAR1nkm4ggbyEcg/wWmlGLDAA3oL50xi6fk5ffZ3E2E3QfZDCcCN2YtbEWZt+Drc6u6rlqv7Uk0LdKqqr5rk2UCRXOk0vmQKGfc94nOJyQjouF9H/wCc9gECEYfONoAAAAASUVORK5CYII=)](https://scala-steward.org)
|
|
[![License](https://img.shields.io/github/license/eikek/docspell.svg?style=for-the-badge&color=steelblue)](https://github.com/eikek/docspell/blob/master/LICENSE.txt)
|
|
[![Docker Pulls](https://img.shields.io/docker/pulls/eikek0/docspell?color=steelblue&style=for-the-badge&logo=docker)](https://hub.docker.com/r/eikek0/docspell)
|
|
[![Gitter chat](https://img.shields.io/gitter/room/eikek/docspell?style=for-the-badge&color=steelblue&logo=gitter)](https://gitter.im/eikek/docspell)
|
|
|
|
# Docspell
|
|
|
|
Docspell is a personal document organizer. You'll need a scanner to
|
|
convert your papers into files. Docspell can then assist in organizing
|
|
the resulting mess :wink:. It is targeted for home use, i.e. families
|
|
and households and also for (smaller) groups/companies.
|
|
|
|
You can associate tags, set correspondends and lots of other
|
|
predefined and custom metadata. If your documents are associated with
|
|
such meta data, you can quickly find them later using the search
|
|
feature. But adding this manually is a tedious task. Docspell can help
|
|
by suggesting correspondents, guessing tags or finding dates using
|
|
machine learning. It can learn metadata from existing documents and
|
|
find things using NLP. This makes adding metadata to your documents a
|
|
lot easier. For machine learning, it relies on the free (GPL)
|
|
[Stanford Core NLP library](https://github.com/stanfordnlp/CoreNLP).
|
|
|
|
Docspell also runs OCR (if needed) on your documents, can provide
|
|
fulltext search and has great e-mail integration. Everything is
|
|
accessible via a REST/HTTP api. A mobile friendly SPA web application
|
|
is the default user interface. An [Android
|
|
app](https://github.com/docspell/android-client) exists for
|
|
conveniently uploading files from your phone/tablet. The [feature
|
|
overview](https://docspell.org/#feature-selection) lists some more
|
|
points.
|
|
|
|
|
|
## Impressions
|
|
|
|
Checkout the short demo videos (<1min), present on the [project
|
|
page](https://docspell.org/#demos). Here are some screenshots:
|
|
|
|
![screenshot-1](website/site/content/docs/webapp/docspell-curate-1.jpg)
|
|
![screenshot-2](website/site/content/docs/webapp/docspell-curate-2.jpg)
|
|
![screenshot-3](website/site/content/docs/webapp/custom-fields-03.png)
|
|
![screenshot-4](website/site/content/docs/webapp/multiedit-04.png)
|
|
![screenshot-5](website/site/content/docs/webapp/mail-item-1.jpg)
|
|
|
|
## Try it
|
|
|
|
Docspell consists of several components. The probably quickest way to
|
|
get started is to use the docker setup as described in the [get started
|
|
page](https://docspell.org/#get-started). This is only three commands
|
|
away:
|
|
|
|
``` shell
|
|
git clone https://github.com/eikek/docspell
|
|
cd docspell/docker
|
|
DOCSPELL_HEADER_VALUE="my-secret-123" docker-compose up
|
|
```
|
|
|
|
Then go to `http://localhost:7880`, sign up and login. Use the same
|
|
name for collective and user for now. More on that can be found
|
|
[here](https://docspell.org/docs/intro/).
|
|
|
|
Other ways are documented
|
|
[here](https://docspell.org/docs/install/quickstart/):
|
|
|
|
- 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/docs/install/installing/#download-unpack-run).
|
|
- Using the [nix](https://nixos.org/nix) package manager as [described
|
|
here](https://docspell.org/docs/install/installing/#nix). A NixOS
|
|
module is available, too.
|
|
|
|
|
|
## Documentation
|
|
|
|
The [project page](https://docspell.org) has lots of information on
|
|
how to [use and setup](https://docspell.org/docs) docspell.
|
|
|
|
|
|
## Contributions/Support
|
|
|
|
Feedback and other contributions are very welcome! There is a [gitter
|
|
room](https://gitter.im/eikek/docspell) for chatting and questions.
|
|
You can also [open an
|
|
issue](https://github.com/eikek/docspell/issues/new) for questions,
|
|
problems and other feedback; or make a mail to `info [at]
|
|
docspell.org`. I'll try to answer in time. You may want to check
|
|
[Contributing.md](Contributing.md) for some starting points, too.
|
|
|
|
If you find this project any useful and want to support it via other
|
|
means, giving a :star: is always encouraging and much appreciated. You
|
|
can also support activity by donating via
|
|
[liberapay](https://liberapay.com/eikek/) or
|
|
[paypal](https://paypal.me/eikek0).
|
|
|
|
Thank you so much!
|
|
|
|
## License
|
|
|
|
Docspell is free software, distributed under the [GPLv3 or
|
|
later](https://spdx.org/licenses/GPL-3.0-or-later.html).
|