{
    "info": {
        "author": "Alex DeLorenzo",
        "author_email": "alexdelorenzo@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# \ud83d\udcf8 screenshot: Better macOS screenshots via the Terminal\n\n`screenshot` is a command line utility that lets you specify an *application name* and *window title* in order to take a screenshot of a specific window.\n\nUsing `screenshot`, you can capture windows belonging to an application, or only an application's windows with certain titles.\n\n## Justification and Use Case\nThe macOS `screencapture` utility is not developer friendly. \n\nTo programmatically take a screenshot of an application, or a specific window, you must supply a *window ID* to `screencapture`.\nIn order to find a window's *window ID*, you'll need call out to Quartz.\n\nIn newer versions of macOS, the `screencapture` utility improves the user experience slightly: you can run the command and then click on the window you'd like to capture.\n\nHowever, that necessitates that the user clicks a window each time. You cannot include this as part of an automated pipeline.\n\nTo that end, I use this utility to automatically generate screenshots of web, mobile and desktop applications.\n\n## Example\nTake a screenshot of the current Terminal window and view it with Preview.app:\n```bash\nopen \"`screenshot Terminal`\"\n```\n\nTake a screenshot of the Pycharm application with the *window title* containing \"screenshot\":\n```bash\nscreenshot Pycharm -t screenshot\n```\n\n\n## Installation\nYou will need Python 3.6+. Please install it with `brew` or `ports` if you do not have it already.\n\n### PyPI\n```bash\npip3 install screenshot\n```\n\n### Github Source\nGrab the source, run the following in the source dir:\n```bash\npip3 install -r requirements.txt\n```\n\nthen run\n```bash\npython3 setup.py install\n```\n\n## Usage\n`screenshot --help`\n\n```\nUsage: screenshot [OPTIONS] APPLICATION_NAME\n\nOptions:\n  -w, --window_selection_options TEXT\n                                  Options: all_windows, on_screen_only,\n                                  above_window, below_window, include_window,\n                                  exclude_desktop\n                                  Default: exclude_desktop\n                                  on_screen_only\n  -t, --title TEXT                Title of window from APPLICATION_NAME to\n                                  capture.\n  -f, --filename TEXT             Filename to save the captured PNG as.\n  -a, --all_windows               Capture all windows matching parameters.\n  -o, --output TEXT               Image format to create, default is png\n                                  (other options include pdf, jpg, tiff)\n  -s, --shadow                    Capture the shadow of the window.\n  --help                          Show this message and exit.\n```\n\n## License\nSee `LICENSE`\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/thismachinechills/pyscreencapture",
        "keywords": "screenshot macos osx apple screencapture pyscreencapture",
        "license": "AGPL-3.0",
        "maintainer": "",
        "maintainer_email": "",
        "name": "screenshot",
        "package_url": "https://pypi.org/project/screenshot/",
        "platform": "",
        "project_url": "https://pypi.org/project/screenshot/",
        "project_urls": {
            "Homepage": "https://github.com/thismachinechills/pyscreencapture"
        },
        "release_url": "https://pypi.org/project/screenshot/1.0.0/",
        "requires_dist": [
            "click",
            "pyobjc-framework-Quartz"
        ],
        "requires_python": "",
        "summary": "Take screenshots on macOS",
        "version": "1.0.0"
    },
    "last_serial": 4225143,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0937af65391f8c26927135c03ae32cb9",
                    "sha256": "08fce3e2dc07ebdbfeb61aa34baf44267f64229e2f145733321182c3565dc5c9"
                },
                "downloads": -1,
                "filename": "screenshot-1.0.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "0937af65391f8c26927135c03ae32cb9",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 5332,
                "upload_time": "2018-08-31T05:29:52",
                "url": "https://files.pythonhosted.org/packages/10/13/755aa410267361f40cef938668b48ab443a5ffc0860f0ed293b498f5952e/screenshot-1.0.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "d12621ec89144e4087be6529dcbb12f1",
                    "sha256": "14b1a22f24647ae53684754f19bd374567e0d71377ddad9d13023b6deda4d501"
                },
                "downloads": -1,
                "filename": "screenshot-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "d12621ec89144e4087be6529dcbb12f1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 4711,
                "upload_time": "2018-08-31T05:29:57",
                "url": "https://files.pythonhosted.org/packages/34/90/6f5286b2bb3657176a80706b340627dff1f2139bdbebebf9d5b01de86940/screenshot-1.0.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "0937af65391f8c26927135c03ae32cb9",
                "sha256": "08fce3e2dc07ebdbfeb61aa34baf44267f64229e2f145733321182c3565dc5c9"
            },
            "downloads": -1,
            "filename": "screenshot-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0937af65391f8c26927135c03ae32cb9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 5332,
            "upload_time": "2018-08-31T05:29:52",
            "url": "https://files.pythonhosted.org/packages/10/13/755aa410267361f40cef938668b48ab443a5ffc0860f0ed293b498f5952e/screenshot-1.0.0-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "d12621ec89144e4087be6529dcbb12f1",
                "sha256": "14b1a22f24647ae53684754f19bd374567e0d71377ddad9d13023b6deda4d501"
            },
            "downloads": -1,
            "filename": "screenshot-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "d12621ec89144e4087be6529dcbb12f1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4711,
            "upload_time": "2018-08-31T05:29:57",
            "url": "https://files.pythonhosted.org/packages/34/90/6f5286b2bb3657176a80706b340627dff1f2139bdbebebf9d5b01de86940/screenshot-1.0.0.tar.gz"
        }
    ]
}