tagfile 0.1.0

Description:

tagfile 0.1.0

Search, index and tag your files and find duplicates.
The goal of tagfile is to manage and organize documents, downloads,
music, pictures and videos in a way that is not tied to any file browser
program, filesystem or operating system.
The metadata that tagfile creates and uses to keep track of these
files should be portable for use in multiple computer systems and be
independent from any persistent mount points, filepaths or filenames.

Features

index files with their checksums
find duplicate files
scan all files in a directory recursively
ignore files according to rules in user config

Features to be implemented in later versions:

remove duplicate files in the same directory
remove duplicate files interactively across directories
add user defined tags to files (using checksums, independent from filenames)

Ideas that may or may not be implemented in later versions:

ability to filter files using tags to create listings to use with
other programs
ability to use tags to create directory structures of symlinked content



Quick Manual
Open a terminal and cd to a directory to be scanned for files:
$ cd ~/Music
$ tagfile scan
Now, you can see stats, search for files by string and find duplicate
files using the following commands:
$ tagfile stats
$ tagfile find radiohead
$ tagfile same
You can add directories without cd’ing to it first with the add command:
$ tagfile add ~/Videos


Installing tagfile
Tagfile is a command-line end-user application written in Python that
is dependant on packages from PyPI. You can install it using pip. But
using pipx (https://pypa.github.io/pipx/) is recommended because it
avoids dependency problems and/or clashes with python packages from your
system’s package manager in the future.
Install tagfile:
$ pipx install tagfile
To build and install from source you can use:
$ make install
This will auto-install flit (build tool) and pipx if not found.
To upgrade or uninstall tagfile in the future you can use:
$ pipx upgrade tagfile
$ pipx uninstall tagfile


Status
Current version: v0.1.0
Tagfile has been written in a short time and used by me sporadically for
8 years after that. All code was contained in a single file script in
~/bin, available from Github only.
Starting in March 2023 I’ve decided to properly release it to PyPI and
flesh out the current project structure, command interface and database
handling before working on new features so it may live up to its name.
Since at this moment in time, you cannot tag your files yet :)
Tagfile adheres to Semantic Versioning. Until
a stable version 1.0.0 is ready, the API, CLI and config settings are
subject to change from 0.x version to 0.x version, likely without
offering migrations.
Prerequisites:

Python 3.7 or later

Dependencies (automatically installed with pipx / pip):

Peewee ORM (https://peewee.readthedocs.org/en/latest/)
PyYAML (https://pyyaml.org/)
ansicolors (https://pypi.python.org/pypi/ansicolors/)
pycommand (https://babab.github.io/pycommand/)



Software license
Copyright (c) 2015-2023 Benjamin Althues <benjamin at babab . nl>
tagfile is open source software, licensed under a BSD-3-Clause license.
See the LICENSE
file for the full license text.