Metadata-Version: 2.1
Name: sittagger
Version: 0.6.2
Summary: Image viewer with user-labels tag database
Project-URL: Homepage, https://indigo.re/sit-tagger/
Project-URL: Project, https://github.com/hydrargyrum/sit-tagger
Project-URL: PyPI, https://pypi.org/project/sittagger/
Author-email: Hg <dev@indigo.re>
License-Expression: WTFPL
License-File: COPYING.WTFPL
Keywords: browser,database,image,label,labelling,photo,python,tag,tagging,viewer
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: Public Domain
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Desktop Environment :: File Managers
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Requires-Python: >=3.4
Requires-Dist: pyqt5
Requires-Dist: pyxdg
Requires-Dist: vignette
Description-Content-Type: text/x-rst

SIT-Tagger
==========

SIT-Tagger is an app for browsing tagged files.

For now, it consists in an image browser app, that allows to set custom text tags
on any image file, and then list image files matching checked tags.
The tags are saved in a local SQLite database.

Other apps reusing the same database will be added, and support for video files
will be added.

.. image:: docs/shot-dirview.jpg
.. image:: docs/shot-tagview.jpg

It also comes with a command-line too to manipulate the tag database.

Command-line tool
-----------------

SIT-Tagger comes with a command-line tool to manipulate the tag database.

These 2 commands set tag foo and unset tag bar on some/file.jpg::

    sit-tagger-cli set +foo some/file.jpg
    sit-tagger-cli set -bar some/file.jpg

Combined in a single command::

    sit-tagger-cli set +foo -bar some/file.jpg

It's possible to query the list files tagged foo::

    % sit-tagger-cli query foo
    /tmp/some/file.jpg

Or show the tags of a file::

    % sit-tagger-cli show some/file.jpg
    /tmp/some/file.jpg = [foo]

List all tags::

    % sit-tagger-cli list-tags
    foo

Rename a tag::

    sit-tagger-cli rename-tag foo foonew

List all files::

    % sit-tagger-cli list-files
    /tmp/some/file.jpg

Remove all tags from a file::

    sit-tagger-cli untrack-files some/file.jpg

Install
-------

Using ``pip install sittagger``.

<https://pypi.org/project/sittagger/>
