[![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:. You can associate tags, set correspondends, what a document is concerned with, a name, a date and much more. If your documents are associated with such 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. Docspell can help you by suggesting correspondents, guessing tags or finding dates using machine learning techniques. This makes adding metadata to your documents a lot easier. 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 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. ## 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. 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).