2019-07-22 22:53:30 +00:00
|
|
|
<img align="right" src="./artwork/logo-only.svg" height="150px" style="padding-left: 20px"/>
|
|
|
|
|
|
2020-04-21 21:33:15 +00:00
|
|
|
[](https://travis-ci.org/eikek/docspell)
|
2020-08-22 11:00:22 +00:00
|
|
|
[](https://scala-steward.org)
|
|
|
|
|
[](https://github.com/eikek/docspell/blob/master/LICENSE.txt)
|
2020-09-02 19:44:13 +00:00
|
|
|
[](https://hub.docker.com/r/eikek0/docspell)
|
2020-08-22 11:00:22 +00:00
|
|
|
[](https://gitter.im/eikek/docspell)
|
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
|
2020-08-25 18:53:01 +00:00
|
|
|
convert your papers into files. Docspell can then assist in
|
2019-07-22 22:53:30 +00:00
|
|
|
organizing the resulting mess :wink:.
|
|
|
|
|
|
2020-01-11 21:12:51 +00:00
|
|
|
You can associate tags, set correspondends, what a document is
|
2020-11-30 00:07:46 +00:00
|
|
|
concerned with, a name, a date and much more. If your documents are
|
2020-11-29 01:17:06 +00:00
|
|
|
associated with such meta data, you should be able to quickly find
|
2020-01-11 21:12:51 +00:00
|
|
|
them later using the search feature. But adding this manually to each
|
2020-11-29 01:17:06 +00:00
|
|
|
document is a tedious task. Docspell can help you by suggesting
|
|
|
|
|
correspondents, guessing tags or finding dates using machine learning
|
2020-11-30 00:07:46 +00:00
|
|
|
techniques. This makes adding metadata to your documents a lot easier.
|
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
|
2020-11-30 00:07:46 +00:00
|
|
|
is provided as the user interface and an [Android
|
|
|
|
|
app](https://github.com/docspell/android-client) for conveniently
|
|
|
|
|
uploading files from your phone/tablet. The [feature
|
|
|
|
|
overview](https://docspell.org/#feature-selection) has a more complete
|
|
|
|
|
list.
|
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:
|
|
|
|
|
|
2020-11-14 21:46:32 +00:00
|
|
|
|
|
|
|
|
|
2020-11-30 00:07:46 +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
|
2020-09-24 11:30:23 +00:00
|
|
|
cd docspell/docker
|
2020-08-21 22:18:56 +00:00
|
|
|
DOCSPELL_HEADER_VALUE="my-secret-123" docker-compose up
|
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.
|
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]
|
|
|
|
|
docspell.org`. I'll try to answer in time.
|
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
|
2020-11-29 01:17:06 +00:00
|
|
|
[liberapay](https://liberapay.com/eikek/).
|
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
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
## License
|
2020-03-27 18:47:55 +00:00
|
|
|
|
2020-08-15 08:33:22 +00:00
|
|
|
Docspell is free software, distributed under the [GPLv3 or
|
|
|
|
|
later](https://spdx.org/licenses/GPL-3.0-or-later.html).
|
