2019-07-22 22:53:30 +00:00
|
|
|
<img align="right" src="./artwork/logo-only.svg" height="150px" style="padding-left: 20px"/>
|
|
|
|
|
|
2020-12-14 14:01:50 +00:00
|
|
|
[](https://scala-steward.org)
|
|
|
|
|
[](https://github.com/eikek/docspell/blob/master/LICENSE.txt)
|
2021-08-15 00:18:08 +00:00
|
|
|
[](https://hub.docker.com/u/docspell)
|
2020-12-14 14:01:50 +00:00
|
|
|
[](https://gitter.im/eikek/docspell)
|
2019-07-22 22:53:30 +00:00
|
|
|
|
2021-03-01 08:36:59 +00:00
|
|
|
# Docspell - Document Management System (DMS)
|
2019-07-22 22:53:30 +00:00
|
|
|
|
2021-03-01 08:36:59 +00:00
|
|
|
Docspell is a personal document organizer. Or sometimes called a
|
|
|
|
|
"Document Management System" (DMS). You'll need a scanner to convert
|
|
|
|
|
your papers into files. Docspell can then assist in organizing the
|
|
|
|
|
resulting mess :wink:. It can unify your files from scanners, emails
|
|
|
|
|
and other sources. It is targeted for home use, i.e. families,
|
|
|
|
|
households and also for smaller groups/companies.
|
2021-01-19 23:59:35 +00:00
|
|
|
|
|
|
|
|
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).
|
2020-01-11 21:12:51 +00:00
|
|
|
|
2020-11-29 01:17:06 +00:00
|
|
|
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
|
2021-01-19 23:59:35 +00:00
|
|
|
is the default user interface. An [Android
|
|
|
|
|
app](https://github.com/docspell/android-client) exists for
|
2021-07-30 14:45:38 +00:00
|
|
|
conveniently uploading files from your phone/tablet and a
|
|
|
|
|
[cli](https://github.com/docspell/dsc). The [feature
|
2021-01-19 23:59:35 +00:00
|
|
|
overview](https://docspell.org/#feature-selection) lists some more
|
|
|
|
|
points.
|
2020-01-11 21:12:51 +00:00
|
|
|
|
2020-03-27 18:47:55 +00:00
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
## Impressions
|
|
|
|
|
|
|
|
|
|
Checkout the short demo videos (<1min), present on the [project
|
|
|
|
|
page](https://docspell.org/#demos). Here are some screenshots:
|
|
|
|
|
|
2022-02-03 22:04:55 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
|
|
|
|
|
## 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
|
2021-10-25 12:06:29 +00:00
|
|
|
cd docspell/docker/docker-compose
|
|
|
|
|
docker-compose up -d
|
2020-08-15 08:33:22 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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/).
|
|
|
|
|
|
2020-08-21 22:18:56 +00:00
|
|
|
Other ways are documented
|
2020-08-15 08:33:22 +00:00
|
|
|
[here](https://docspell.org/docs/install/quickstart/):
|
2020-03-31 20:54:09 +00:00
|
|
|
|
|
|
|
|
- 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
|
2020-08-01 18:36:27 +00:00
|
|
|
here](https://docspell.org/docs/install/installing/#download-unpack-run).
|
2020-03-31 20:54:09 +00:00
|
|
|
- Using the [nix](https://nixos.org/nix) package manager as [described
|
2020-08-01 18:36:27 +00:00
|
|
|
here](https://docspell.org/docs/install/installing/#nix). A NixOS
|
|
|
|
|
module is available, too.
|
2023-04-09 20:19:26 +00:00
|
|
|
- Use the [Kubernetes](./kubernetes/README.md) configuration.
|
2020-03-31 20:54:09 +00:00
|
|
|
|
|
|
|
|
|
2020-01-12 12:56:50 +00:00
|
|
|
## Documentation
|
|
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
The [project page](https://docspell.org) has lots of information on
|
|
|
|
|
how to [use and setup](https://docspell.org/docs) docspell.
|
2020-02-08 17:05:21 +00:00
|
|
|
|
|
|
|
|
|
2020-11-29 01:17:06 +00:00
|
|
|
## 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]
|
2021-01-10 08:56:39 +00:00
|
|
|
docspell.org`. I'll try to answer in time. You may want to check
|
|
|
|
|
[Contributing.md](Contributing.md) for some starting points, too.
|
2020-03-01 13:19:24 +00:00
|
|
|
|
2020-11-29 01:17:06 +00:00
|
|
|
If you find this project any useful and want to support it via other
|
2020-11-30 00:07:46 +00:00
|
|
|
means, giving a :star: is always encouraging and much appreciated. You
|
|
|
|
|
can also support activity by donating via
|
2021-01-03 12:11:53 +00:00
|
|
|
[liberapay](https://liberapay.com/eikek/) or
|
|
|
|
|
[paypal](https://paypal.me/eikek0).
|
2020-03-27 18:47:55 +00:00
|
|
|
|
2020-11-30 00:07:46 +00:00
|
|
|
Thank you so much!
|
2020-03-01 13:19:24 +00:00
|
|
|
|
2021-02-14 17:37:57 +00:00
|
|
|
## Tech Stack
|
|
|
|
|
|
|
|
|
|
**Backend**
|
|
|
|
|
|
|
|
|
|
The servers is written in Scala in a pure functional style, based on
|
|
|
|
|
libraries from the [typelevel](https://typelevel.org) stack: Cats,
|
|
|
|
|
FS2, Doobie, Http4s, Circe and Pureconfig.
|
|
|
|
|
|
|
|
|
|
There are more libraries and technologies used, of course. Docspell is
|
|
|
|
|
only a orchestration of great tools and libs. One important is the
|
|
|
|
|
[Stanford-NLP](https://nlp.stanford.edu/software/), that provides the
|
|
|
|
|
ML features. Furthermore, file processing relies on external tools
|
|
|
|
|
like tesseract, unoconv and ocrmypdf. All dependencies can be looked
|
|
|
|
|
up in `project/Dependencies.scala`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Frontend**
|
|
|
|
|
|
|
|
|
|
The web frontend is a SPA written in [Elm](https://elm-lang.org). The
|
|
|
|
|
UI framework in use is [tailwind](https://tailwindcss.com).
|
|
|
|
|
|
|
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
## License
|
2020-03-27 18:47:55 +00:00
|
|
|
|
2021-09-22 09:55:56 +00:00
|
|
|
Docspell is free software, distributed under the [AGPLv3 or
|
|
|
|
|
later](https://spdx.org/licenses/AGPL-3.0-or-later.html).
|
