sittagger


Namesittagger JSON
Version 1.1.0 PyPI version JSON
download
home_pageNone
SummaryImage viewer with user-labels tag database
upload_time2024-12-17 12:16:49
maintainerNone
docs_urlNone
authorNone
requires_python>=3.4
licenseNone
keywords browser database image label labelling photo python tag tagging viewer
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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.

![sit-tagger window with a directory tree pane and the list of files (with thumbnails) from the selected dir](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-dirview.jpg)

![sit-tagger window with a tags list pane (with a checkbox for each tag) and the list of files (with thumbnails) matching the checked tags](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-tagview.jpg)

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

## Captions

SIT-Tagger lets you write text captions for files. In addition, any `#hashtags` you write in the caption are transformed into actual file tags. This makes tagging files easier while letting you comment your files.

![sit-tagger window with the list of files (with thumbnails) and a caption editor pane (showing a user-entered caption with #hashtags in it)](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-caption.jpg)

## 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

Install with [`pipx install sittagger`](https://pypi.org/project/sittagger/).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sittagger",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.4",
    "maintainer_email": null,
    "keywords": "browser, database, image, label, labelling, photo, python, tag, tagging, viewer",
    "author": null,
    "author_email": "Hg <dev@indigo.re>",
    "download_url": "https://files.pythonhosted.org/packages/9b/87/fc0593af8e48bf7a2cdb5088739909e898f68a85165092b160d0616e2db1/sittagger-1.1.0.tar.gz",
    "platform": null,
    "description": "# SIT-Tagger\n\nSIT-Tagger is an app for browsing tagged files.\n\nFor now, it consists in an image browser app, that allows to set custom\ntext tags on any image file, and then list image files matching checked\ntags. The tags are saved in a local SQLite database.\n\nOther apps reusing the same database will be added, and support for\nvideo files will be added.\n\n![sit-tagger window with a directory tree pane and the list of files (with thumbnails) from the selected dir](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-dirview.jpg)\n\n![sit-tagger window with a tags list pane (with a checkbox for each tag) and the list of files (with thumbnails) matching the checked tags](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-tagview.jpg)\n\nIt also comes with a command-line tool to manipulate the tag database.\n\n## Captions\n\nSIT-Tagger lets you write text captions for files. In addition, any `#hashtags` you write in the caption are transformed into actual file tags. This makes tagging files easier while letting you comment your files.\n\n![sit-tagger window with the list of files (with thumbnails) and a caption editor pane (showing a user-entered caption with #hashtags in it)](https://raw.githubusercontent.com/hydrargyrum/sit-tagger/master/docs/shot-caption.jpg)\n\n## Command-line tool\n\nSIT-Tagger comes with a command-line tool to manipulate the tag\ndatabase.\n\nThese 2 commands set tag foo and unset tag bar on some/file.jpg:\n\n    sit-tagger-cli set +foo some/file.jpg\n    sit-tagger-cli set -bar some/file.jpg\n\nCombined in a single command:\n\n    sit-tagger-cli set +foo -bar some/file.jpg\n\nIt\\'s possible to query the list files tagged foo:\n\n    % sit-tagger-cli query foo\n    /tmp/some/file.jpg\n\nOr show the tags of a file:\n\n    % sit-tagger-cli show some/file.jpg\n    /tmp/some/file.jpg = [foo]\n\nList all tags:\n\n    % sit-tagger-cli list-tags\n    foo\n\nRename a tag:\n\n    sit-tagger-cli rename-tag foo foonew\n\nList all files:\n\n    % sit-tagger-cli list-files\n    /tmp/some/file.jpg\n\nRemove all tags from a file:\n\n    sit-tagger-cli untrack-files some/file.jpg\n\n## Install\n\nInstall with [`pipx install sittagger`](https://pypi.org/project/sittagger/).\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Image viewer with user-labels tag database",
    "version": "1.1.0",
    "project_urls": {
        "Homepage": "https://indigo.re/sit-tagger/",
        "Project": "https://gitlab.com/hydrargyrum/sit-tagger",
        "PyPI": "https://pypi.org/project/sittagger/"
    },
    "split_keywords": [
        "browser",
        " database",
        " image",
        " label",
        " labelling",
        " photo",
        " python",
        " tag",
        " tagging",
        " viewer"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e2bb7c0fa1de35e9a9caa15d1b3d6f7df8ad730408a1b1567596369228aeae67",
                "md5": "c41e642f03d5b44879d023e999e30f35",
                "sha256": "4501fa0b276001eef126b1cc73472cea910694a5973002b72f7e1f5493e7388b"
            },
            "downloads": -1,
            "filename": "sittagger-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c41e642f03d5b44879d023e999e30f35",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.4",
            "size": 41939,
            "upload_time": "2024-12-17T12:16:47",
            "upload_time_iso_8601": "2024-12-17T12:16:47.702687Z",
            "url": "https://files.pythonhosted.org/packages/e2/bb/7c0fa1de35e9a9caa15d1b3d6f7df8ad730408a1b1567596369228aeae67/sittagger-1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9b87fc0593af8e48bf7a2cdb5088739909e898f68a85165092b160d0616e2db1",
                "md5": "9ec3787527c3533a5c53523e9363cd60",
                "sha256": "74aee50fdd2612aa1b90a1fce041f44b4a02034598c25d19392b5e0d32000336"
            },
            "downloads": -1,
            "filename": "sittagger-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "9ec3787527c3533a5c53523e9363cd60",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.4",
            "size": 34382,
            "upload_time": "2024-12-17T12:16:49",
            "upload_time_iso_8601": "2024-12-17T12:16:49.056246Z",
            "url": "https://files.pythonhosted.org/packages/9b/87/fc0593af8e48bf7a2cdb5088739909e898f68a85165092b160d0616e2db1/sittagger-1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-17 12:16:49",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "hydrargyrum",
    "gitlab_project": "sit-tagger",
    "lcname": "sittagger"
}
        
Elapsed time: 0.43471s