Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Minimalistic document management system

Project description

NOTE: Tidy is still in its pre-alpha (development) stage.

Tidy is a document manager written in Python 3. The command line interface for Tidy is tid. See tid –help for usage info.

Getting started

To start managing your documents, first create a __collection__. A collection consists of a directory for all the files, an sqlite database for the metadata, and a collection description file collection.json.

To create an empty new collection, run `bash $ tid init CollectionName `


Each collection is assigned a [UUID]( (universally unique identifier).

## Adding files

Tidy manages documents added to it by putting them into the Inbox and assigning a UUID for each file.

`bash $ tid add [CollectionName] files `

If no collection name is given, Tidy will put the files into the global inbox at $TIDY_HOME/Inbox.


Tidy can be customized through a configuration file at $XDG_CONFIG_HOME/tidy/config, where $XDG_CONFIG_HOME defaults to be $HOME/.config.

$TIDY_HOME defaults to be $HOME/.tidy.


It is not recommended that collections be synced directly with cloud drives like Nextcloud or Dropbox unless you are comfortable with resolving potential database conflicts manually.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Tidy, version 2018.5
Filename, size File type Python version Upload date Hashes
Filename, size Tidy-2018.5a.tar.gz (18.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page