File tagging with hard links
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Dantalian README

Project Website:

Dantalian is a Python 3 library to assist file organization and tagging using hard links.

Comprehensive documentation can be found online at


  • Organizes using the plain file system.
  • Extremely flexible (no tag limit, no tag naming restrictions, hierarchical tags, no file naming restrictions, can tag all files and directories).
  • Transparent to other applications, since it works directly with the file system.


Dantalian works on contiguous POSIX-compatible file systems. Specific requirements may vary, but for most Linux users there should not be any problems.


Install using packages from your distribution if available. Otherwise, see below for manual installation.

Arch Linux

Manual installation


Build dependencies:

Installation is simple. Obtain the sources, then run:

$ python install

This will most likely require root, and will install Dantalian globally on the system. Otherwise, you can use virtualenv, or install it for the user:

$ python install --user

By default this will install to ~/.local/bin.

It is recommended to install the man pages as well. The man pages can be built like so:

$ cd doc
$ make man

The man pages can be found in doc/_build/man. How they are installed depends on your system. On Arch Linux, man pages are installed in /usr/share/man as gzipped archives, so you would do the following:

$ cd doc/_build/man
$ gzip ./*
# install ./* /usr/share/man/man1


Dantalian can be used either as a Python library or a standalone program.

Note that using Dantalian separately may be slow due to Python's nature. When performing bulk operations, consider using Dantalian as a library in a Python script instead of invoking Dantalian repeatedly in a shell script.

Check the documentation for more information.