{
    "info": {
        "author": "Henri-Louis Girard",
        "author_email": "hl.girard@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# Simplabel\n[![PyPI version](https://badge.fury.io/py/simplabel.svg)](https://pypi.org/project/simplabel/)\n[![Travis CI status](https://travis-ci.com/hlgirard/Simplabel.svg?branch=master)](https://travis-ci.com/hlgirard/Simplabel/branches)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://github.com/hlgirard/Simplabel/blob/master/LICENSE)\n\nGraphical tool to manually label images in distinct categories to build training datasets.\nSimply pass a list of categories, a directory containing images and start labelling.\nSupports multiple users, reconciliation and keyboard bindings to label even faster!\n\n![screenshot](docs/screenshot_190404.png)\n\n## Installation\n\n### Install with pip\n\nSimplabel is on PyPI so it can be installed with pip\n\n```\npip install simplabel\n```\n\n### Install from source\n\nClone the repository to your computer\n\n```\ngit clone https://github.com/hlgirard/Simplabel.git\n```\n\nand install with pip \n\n```\ncd Simplabel\npip install .\n```\n\n## Usage\n\n### Quick start\n\nSimplabel can be started from the command line without any argument:\n```\nsimplabel\n```\nYou will be prompted to select a directory containing images to label. Add labels with the '+' button and start labeling. Number keys correspond to labels and can be used instead.\n\nThe target directory and/or labels can also be passed directly from the command line:\n```\nsimplabel --labels dog cat bird --directory path/to/image/directory\n```\n\nAfter the first use, labels are stored in `labels.pkl` and the `--labels` argument is ignored.\n\n### Command line arguments\n\n- `-d, --directory <PATH/TO/DIRECTORY>` sets the directory to search for images and save labels to. Defaults to the current working directory.\n- `-l, --labels <label1 label2 label3 ...>` sets the categories for the labelling task. Only passed on the first use in a given directory.\n- `-u, --user <USERNAME>` sets the username. Defaults to the OS login name if none is passed.\n- `-r, --redundant` does not display other labelers selections for independent labelling. Reconciliation and Make Master are unavailable in this mode.\n- `-v, --verbose` increases the verbosity level.\n- `--remove-label <LABEL>` tries to safely remove a label from the list saved in `labels.pkl` (must also pass `-d`)\n- `--reset-lock` overrides the lock preventing the same username from being used multiple times simultaneously.\n- `--delete-all` removes all files created by simplabel in the directory (must also pass `-d`)\n\n### Multiuser\n\nThe app relies on the filesystem to save each user's selection and display other user's selections. It works best if the working directory is on a shared drive or in a synced folder (Dropbox, Onedrive...). The Reconcile workflow allows any user to see and resolve conflicts. The Make Master option can be used to create and save a master dictionary - `labeled_master.pkl` - containing all labeled images (after reconciliation).\n\n### Import saved labels\n\nThe app saves a `labeled_<username>.pkl` file that contains a pickeled dictionary {image_name: label}. To import the dictionary, use the following sample code:\n\n```python\nimport pickle\n\nwith open(\"labeled_user1.pkl\",\"rb\") as f:\n    label_dict = pickle.load(f)\n```\n\n## Advanced usage\n\n### Utilities\n\nOnce you are done labelling, use the flow_to_directory tool to copy images to distinct directories by label\n\n```\nflow_to_directory --input-directory data/labeled --output-directory data/sorted\n```\n\n### Python object\n\nThe Tkinter app can also be started from a python environment\n\n```python\nfrom simplabel import ImageClassifier\nimport tkinter as tk\n\nroot = tk.Tk() \ndirectory = \"data/raw\"\ncategories = ['dog', 'cat', 'bird']\nMyApp = ImageClassifier(root, directory, categories)\ntk.mainloop()\n```\n\n## License\n\nThis project is licensed under the GPLv3 License - see the [LICENSE.md](LICENSE.md) file for details.\n\n## Acknowledgements\n\nTesting of tkinter GUI is based on ivan_pozdeev's answer at Stackoverflow:\n\nhttps://stackoverflow.com/questions/4083796/how-do-i-run-unittest-on-a-tkinter-app\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/hlgirard/Simplabel",
        "keywords": "",
        "license": "GPLv3",
        "maintainer": "",
        "maintainer_email": "",
        "name": "simplabel",
        "package_url": "https://pypi.org/project/simplabel/",
        "platform": "",
        "project_url": "https://pypi.org/project/simplabel/",
        "project_urls": {
            "Homepage": "https://github.com/hlgirard/Simplabel"
        },
        "release_url": "https://pypi.org/project/simplabel/0.1.5/",
        "requires_dist": [
            "pillow (>=6.0.0)"
        ],
        "requires_python": "",
        "summary": "Simple tool to manually label images in disctinct categories.",
        "version": "0.1.5"
    },
    "last_serial": 5382010,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "19de7fbf5c1a083a1e71abb311414b35",
                    "sha256": "c3c3c98c8a43657b40ee6ef99f345ecb212738d19da3a1069975eefdc507314a"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "19de7fbf5c1a083a1e71abb311414b35",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 18517,
                "upload_time": "2019-02-27T19:54:58",
                "url": "https://files.pythonhosted.org/packages/7e/18/a6c62f08c03578c610fc539be374211c4d7364dc14c8e75b1d6ee9925ecb/simplabel-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "9178450e52895ae39c06312f448d9eaf",
                    "sha256": "6976e0ff79dc7c0f4c88558c4ed5cca78422b2af26c8a07424c37843a04ac73d"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "9178450e52895ae39c06312f448d9eaf",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5310,
                "upload_time": "2019-02-27T19:55:00",
                "url": "https://files.pythonhosted.org/packages/1e/bd/e406052e984eda85f694ebf816a24d4a9682f4e5b039f8eff99d25130607/simplabel-0.0.1.tar.gz"
            }
        ],
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b97f27a24efc151be50991bc5c65459a",
                    "sha256": "fc7619a14b78570615a4c5d3e7ed0a4a6d7724aceb3d776223514d463ebb41cf"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b97f27a24efc151be50991bc5c65459a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 19671,
                "upload_time": "2019-02-27T21:47:03",
                "url": "https://files.pythonhosted.org/packages/a6/3c/d57b0da48a981961eb31575abb61259cabc60463c41a81ac868aee03a95a/simplabel-0.0.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "21676947bb806b5cd79fb2158568d330",
                    "sha256": "47f038e8657aecf9d6a2ba61218687d065a285d2f4a7e40e6cf559ca262a191b"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "21676947bb806b5cd79fb2158568d330",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5933,
                "upload_time": "2019-02-27T21:47:05",
                "url": "https://files.pythonhosted.org/packages/18/65/f67d3af0b4ecde3a2cff2ffa1f56369ad446ab175132f338e2baea01d02e/simplabel-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c9f97ea268ede4ce0729d683ec0998b7",
                    "sha256": "f5a9bd5d0c63cf44cfcb22a8caf89d47798a39f3cd570193850eed012ac21437"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c9f97ea268ede4ce0729d683ec0998b7",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 19714,
                "upload_time": "2019-02-27T22:00:38",
                "url": "https://files.pythonhosted.org/packages/aa/c5/f078f90f01a83bc47acd22a3a1fe5e6934a07945578360032223f6b4048b/simplabel-0.0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "7b4fe588595401e575adaef7535fc479",
                    "sha256": "d3303c73afac39f1ea8c9a02783d2e2969c8e51adcb1b1026a246ef0e8d1bcc9"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "7b4fe588595401e575adaef7535fc479",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5971,
                "upload_time": "2019-02-27T22:00:41",
                "url": "https://files.pythonhosted.org/packages/42/e2/221aa38276459eca048cfb47900d815ac5321751c35552f675dbc9f60849/simplabel-0.0.3.tar.gz"
            }
        ],
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c34cde4b56b755297f83a1e620ffd909",
                    "sha256": "e6ce17560cf4aa011e11c1749352a337fbf7adc3ff0172de88989b634caede6f"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c34cde4b56b755297f83a1e620ffd909",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 20893,
                "upload_time": "2019-02-28T18:29:32",
                "url": "https://files.pythonhosted.org/packages/af/3e/47777aa7e4c9ae6ec7b6013af3fad6c4d03df313e8cb1c104ac7114a2acc/simplabel-0.0.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "c525dfb8aa7585679f4b3f379446586e",
                    "sha256": "1c8742f1b4acec273e0539534279ffaa4d7dc3c71f9bdf419b4205efd72e058d"
                },
                "downloads": -1,
                "filename": "simplabel-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "c525dfb8aa7585679f4b3f379446586e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7179,
                "upload_time": "2019-02-28T18:29:35",
                "url": "https://files.pythonhosted.org/packages/07/3c/831a6591ae0ceb7348649757613777e39d66d23e789ccaa3524844f3c492/simplabel-0.0.4.tar.gz"
            }
        ],
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e7902725fdc9f76f48a7690bf7f04b6e",
                    "sha256": "529de55c152a835b8773512de326e8ef0f2ef51e625af93df553fa3f479ff97f"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e7902725fdc9f76f48a7690bf7f04b6e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 27589,
                "upload_time": "2019-04-04T20:44:48",
                "url": "https://files.pythonhosted.org/packages/de/53/b11b437fb7043779a92d33692898780271962491e78b723f654d0939df6e/simplabel-0.1.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "f6027aabf76d679b58399a4b2adbcfc6",
                    "sha256": "d15f30eacca71206168e2fbf6bc25973bedeb6e82f080082b1cebeeb8c71ac99"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "f6027aabf76d679b58399a4b2adbcfc6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15135,
                "upload_time": "2019-04-04T20:44:52",
                "url": "https://files.pythonhosted.org/packages/59/1c/94164e8592ca687d69ccda265d8392944b12090868b32e144552e441bc58/simplabel-0.1.0.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0b760d35937378eb8ffdced935ede379",
                    "sha256": "1f3d15ba75e2226820d3d887584357f065b5bfac67c03bf0d1edc88a6b410020"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "0b760d35937378eb8ffdced935ede379",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 28119,
                "upload_time": "2019-04-17T15:51:41",
                "url": "https://files.pythonhosted.org/packages/b1/ff/c614c3791dc56ce3e5408a3b38235be274dc636eeab440846ed3608b76b7/simplabel-0.1.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "049e778ff896ac45fe6f27f98939d798",
                    "sha256": "f14d8d8f2a6be9e1b306d199ba8a1ba6644ca6dec6a3a9d893653f1f1984d1c6"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "049e778ff896ac45fe6f27f98939d798",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15579,
                "upload_time": "2019-04-17T15:51:45",
                "url": "https://files.pythonhosted.org/packages/75/e1/1fc630fee4cb1e03910b2b28276ffa9d0282e94c7745d6556989cca8ec18/simplabel-0.1.1.tar.gz"
            }
        ],
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5f2e8e72f23de9e812a2ab305cab5cca",
                    "sha256": "dc479548683e8b797418e34100447f87da2d5ab6e06be5c314a9194227ccff48"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "5f2e8e72f23de9e812a2ab305cab5cca",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 28299,
                "upload_time": "2019-04-30T15:55:16",
                "url": "https://files.pythonhosted.org/packages/0a/b3/cfeaaebcaf381f90d6bcd7e4f3a0242e9bf9589c0ac3fe0c1fd6d550beb2/simplabel-0.1.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "43c8b7f93c71669a52819db9a0d23ff0",
                    "sha256": "0a08f5b9a4f48ab74c38f8f9238190a7afb10c081986e481cb5fa54fa4dbd130"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "43c8b7f93c71669a52819db9a0d23ff0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15790,
                "upload_time": "2019-04-30T15:55:29",
                "url": "https://files.pythonhosted.org/packages/a0/8e/218e2e6e289f5346526ee24f151d650c93a6f72a5d4a1681d92caf216838/simplabel-0.1.2.tar.gz"
            }
        ],
        "0.1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "98ddb4e0f06ecf77828edbd589081465",
                    "sha256": "0e7e9df07198f45378c0504dd5712bfdda2832d3e99d150cda617cefa60637e4"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "98ddb4e0f06ecf77828edbd589081465",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 29117,
                "upload_time": "2019-05-03T16:25:21",
                "url": "https://files.pythonhosted.org/packages/49/50/f65b9b62a895e144e79527e566087dc218aa39ce88a7a039c5390e8360be/simplabel-0.1.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "709ebff67227b5736a1c512ad315287a",
                    "sha256": "5355b7a6baf2aad544e3998da4c817636df208fec2f094dd9e7e6a852e66b81a"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "709ebff67227b5736a1c512ad315287a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18180,
                "upload_time": "2019-05-03T16:25:28",
                "url": "https://files.pythonhosted.org/packages/f0/61/4c819dae564ae7455613dc35d7179e117915a9a5483d17db0c13ce8b838e/simplabel-0.1.3.tar.gz"
            }
        ],
        "0.1.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3e620ef907d5d963c02cef3e04bcabb1",
                    "sha256": "f011ca845162530ff83b5a570a175bf580110ca7d99c0bb5292d2709a082fc2f"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "3e620ef907d5d963c02cef3e04bcabb1",
                "packagetype": "bdist_wheel",
                "python_version": "3.7",
                "requires_python": null,
                "size": 29396,
                "upload_time": "2019-05-05T21:20:59",
                "url": "https://files.pythonhosted.org/packages/e0/06/30c7a0f83abbd5e00b1baea3daa9f023af42bca82e49522bbfbb5b31555b/simplabel-0.1.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4eb7f12b2e58db7f3c9ebe42d62a627b",
                    "sha256": "376931524be13965da698de8adfced8f857cc530a5490b5de2508bda1945fd8a"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.4.tar.gz",
                "has_sig": false,
                "md5_digest": "4eb7f12b2e58db7f3c9ebe42d62a627b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18569,
                "upload_time": "2019-05-05T21:20:57",
                "url": "https://files.pythonhosted.org/packages/1a/46/9d3c0572d0f679a719b4705f942c6d64cca36cf54be0ddfd2176b2e9f4c5/simplabel-0.1.4.tar.gz"
            }
        ],
        "0.1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "4ef6ab38f9a727011f4d96b0f2f4df04",
                    "sha256": "dd580e29267420c5da55c47ea8d55aedd442030eb8b5ca6ab9f29387f222970f"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "4ef6ab38f9a727011f4d96b0f2f4df04",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 29654,
                "upload_time": "2019-06-10T15:56:42",
                "url": "https://files.pythonhosted.org/packages/d9/5c/dd5ad125b33257d56d71415e22e3f67eafef646397b875e1880ea71d825c/simplabel-0.1.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4bf6c6d7babcf56e23a5914e404fc960",
                    "sha256": "b0bf6d634ca7bc6dd774bba910e739bbcc3cc43b3d28226a6c83e53f11648e3c"
                },
                "downloads": -1,
                "filename": "simplabel-0.1.5.tar.gz",
                "has_sig": false,
                "md5_digest": "4bf6c6d7babcf56e23a5914e404fc960",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18691,
                "upload_time": "2019-06-10T15:56:49",
                "url": "https://files.pythonhosted.org/packages/24/4e/bfabd81bb5fe391f4506dd71e5b7cefd988e7b74d8aee675d3b013a3e3ca/simplabel-0.1.5.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "4ef6ab38f9a727011f4d96b0f2f4df04",
                "sha256": "dd580e29267420c5da55c47ea8d55aedd442030eb8b5ca6ab9f29387f222970f"
            },
            "downloads": -1,
            "filename": "simplabel-0.1.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4ef6ab38f9a727011f4d96b0f2f4df04",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 29654,
            "upload_time": "2019-06-10T15:56:42",
            "url": "https://files.pythonhosted.org/packages/d9/5c/dd5ad125b33257d56d71415e22e3f67eafef646397b875e1880ea71d825c/simplabel-0.1.5-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "4bf6c6d7babcf56e23a5914e404fc960",
                "sha256": "b0bf6d634ca7bc6dd774bba910e739bbcc3cc43b3d28226a6c83e53f11648e3c"
            },
            "downloads": -1,
            "filename": "simplabel-0.1.5.tar.gz",
            "has_sig": false,
            "md5_digest": "4bf6c6d7babcf56e23a5914e404fc960",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 18691,
            "upload_time": "2019-06-10T15:56:49",
            "url": "https://files.pythonhosted.org/packages/24/4e/bfabd81bb5fe391f4506dd71e5b7cefd988e7b74d8aee675d3b013a3e3ca/simplabel-0.1.5.tar.gz"
        }
    ]
}