mutnemucod

Mut'Ne Mucod

Mut'Ne Mucod (or mutnemucod for easier typing) is a very simple tag-based document manager.

---

How it works

First you upload (PDF only, for now) documents and affect them "tags", which are basically strings: words, expressions, whole sentences, whatever you like really.

Then you can sort and download your uploaded documents using those tags through a sate-of-the-art user-friendly fully-responsive shiny web interface. Or you like curl and you can use the json api, cuz that's how swag I am. Is that 3.0 enough or what ?

Say I have for example a Picard supermarket (advertisers, please contact me to have your brand written here instead) facture from january 2009 that you want to keep. First you scan it and make a PDF out of it, I don't care much how.

Then you go to your mutnemucod instance, enter some tags such as month january, year 2009, Picard, facture, supermarket, food, cold stuff, money I spend or whatever, you click the big "+" floating button, upload your document, and voilà! Cool, huh?

How can I use it

This is a Python3 Django application, that currently depends only on the django python module. If you know how to host a django webapp, just go ahead.

Otherwise, the supported hosting method is Docker, using jwilder's nginx-proxy container image.

You can build the container image using the 'Dockerfile.prod' file, or directly use the prebuilt lertsenem/mutnemucod image on Dockerhub. The container image hosts the application using uwsgi. Data is stored in a volume mounted on '/usr/src/app/data'.

$> docker run -d jwilder/nginx-proxy
$> docker run -d -v /srv/mutnemucod-data:/usr/src/app/data \
$                -e VIRTUAL_HOST=mutnemucod.example.com \
$                   lertsenem/mutnemucod

The django SECRET_KEY is generated at run time (see 'docker_cmd.sh') using pwgen.

Features and limitations

As I said, it's very simple and limited for now. You can:

• Upload and download PDF documents
• Add and remove tags from documents
• Search by tags
• Search by no-tags (meaning you're searching for documents not containing some tag)

And that's about it. Not much, but hey, I'm only starting

What will or can be done

A lot of stuff, really. Here's a short list:

• Add documents by mail (rather than using the wonderful web interface)
• Remove documents
• Add documents as images rather than PDF
• Parse the PDF documents to get some infos automatically
• Use OCR
• Encrypt everything
• Integrate with a LDAP server
• Share documents through temporary links
• Add some permissions to restrict user access to documents
• Create an Android app to upload documents through the camera while keeping a locally synced cache of all documents and tags to use when there's no connectivity
• And more...

If you want to add any of those features, or even something else, feel free to do so. You can get in touch with me by mail or on [Mastodon][https://mastodon.lertsenem.com/@lertsenem].