{"id":19725030,"url":"https://github.com/seanpianka/pysee","last_synced_at":"2026-05-13T18:13:42.432Z","repository":{"id":49984270,"uuid":"55371682","full_name":"seanpianka/PySee","owner":"seanpianka","description":"Screenshot sharing for MacOS and Linux","archived":false,"fork":false,"pushed_at":"2023-10-18T01:48:53.000Z","size":139,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-24T06:52:01.651Z","etag":null,"topics":["clipboard","gui","imgur","linux","python","region","screenshot","tkinter","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seanpianka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-03T22:13:03.000Z","updated_at":"2022-12-08T01:06:16.000Z","dependencies_parsed_at":"2024-11-11T23:29:40.917Z","dependency_job_id":"42283d3a-38bb-41d6-991a-a6b6d2ded875","html_url":"https://github.com/seanpianka/PySee","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanpianka%2FPySee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanpianka%2FPySee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanpianka%2FPySee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanpianka%2FPySee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seanpianka","download_url":"https://codeload.github.com/seanpianka/PySee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241045801,"owners_count":19899727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clipboard","gui","imgur","linux","python","region","screenshot","tkinter","wrapper"],"created_at":"2024-11-11T23:27:56.456Z","updated_at":"2026-05-13T18:13:42.402Z","avatar_url":"https://github.com/seanpianka.png","language":"Python","funding_links":["https://ko-fi.com/A80049AF'"],"categories":[],"sub_categories":[],"readme":"# PySee\n\nA free and open source screenshot sharing tool, built in Python 3, for Linux and Mac OS X.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/Ttocjp7.png\" alt=\"A screenshot showing PySee\"\u003e\n\u003c/p\u003e\n\n#### Requires\n* imgurpython\n* pyperclip\n* requests\n* `xsel` or `xclip`\n\n## Installation\n```bash\n    $ pip install pysee\n    ✨🍰✨\n```\n\nPer [`pyperclip`](https://github.com/asweigart/pyperclip) module documentation:\n\u003e On Linux, this module makes use of the `xclip` or `xsel` commands, which should come with the os. Otherwise run \"`sudo apt-get install xclip`\" or \"`sudo apt-get install xsel`\" (Note: `xsel` does not always seem to work.)\n\n\u003ca href='https://ko-fi.com/A80049AF' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://az743702.vo.msecnd.net/cdn/kofi4.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n## Usage\n```bash\nusage: pysee.py [-h] [--init] [--mode mode] [--image-host host]\n                [--screenshot-tool tool] [--save-directory dir] [--upload]\n                [--logging] [--clipboard] [--save] [--gui]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --init                Initialize PySee and its configuration file\n                        information.\n  --mode mode, -m mode  Set the mode to take a screenshot in. Ensure you have\n                        a screenshot tool installed which supports the desired\n                        mode.\n  --image-host host, -i host\n                        Image host name to upload the screenshot to.\n  --screenshot-tool tool, -t tool\n                        Name of screenshot program to use.\n  --save-directory dir, -d dir\n                        Where to locally save the screenshot.\n  --upload, -u          Upload screenshot to an image host after capture.\n  --logging, -l         Output any logged information to the terminal.\n  --clipboard, -c       Copy image URL to system clipboard after capture.\n  --save, -s            Save screenshot locally after capture.\n  --gui                 Start PySee in GUI mode.\n\n```\n  \nAfter opening the graphical user interface, select your image host (default is to locally save screenshots), edit the configuration file (optional, auto-generated version will suffice for uploading to [imgur.com](https://imgur.com/)), and take a screenshot! If the screenshot is uploaded to a image host, the URL to the image will be copied to the system clipboard (unless disabled).\n\n## Code Example\n```python\n    \u003e\u003e\u003e from pysee import PySee\n    \u003e\u003e\u003e pysee = PySee()\n    \u003e\u003e\u003e pysee.main('imgur', 'scrot', 'region')\n    [+] Screenshot capture: \"2018-05-16-17-36-56.png\" was saved in \"/home/sean/Pictures/\".\n    [+] Image upload: \"2018-05-16-17-36-56.png\" was uploaded to \"imgur\" at \"https://i.imgur.com/GZHVJsL.png\".\n    [+] Clipboard copy: \"https://i.imgur.com/GZHVJsL.png\" has been copied to your system clipboard.\n    'https://i.imgur.com/GZHVJsL.png'\n```\n\n## Uninstallation\n```bash\n    $ pip uninstall pysee\n```\n\nand remove the `~/.config/pysee/` directory in your home (`~`) directory.\n\n## Support\n\n* Capture Tools\n  * Mac OS X:\n     * `screencapture`\n  * Linux\n     * `gnome-screenshot`\n     * `shutter`\n     * `scrot`\n     * `xfce4-screenshot`\n* Image Hosts\n  * [x] [Imgur](https://imgur.com/)\n  * [ ] [ImageShack](https://imageshack.us)\n  * [ ] [TinyPic](http://tinypic.com/)\n  * [ ] [Flickr](https://www.flickr.com/)\n  * [ ] [Photobucket](http://s5.photobucket.com/)\n  * [ ] [Google Photos (Picasa)](https://photos.google.com/)\n  * [ ] [Twitter](https://twitter.com/)\n  * [ ] [vgy.me](https://vgy.me/)\n  * [ ] [SomeImage.com](https://someimage.com/)\n  * [ ] [imgland.net](http://imgland.net/)\n\n\nFuture Functionality of PySee\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n\nCapturing Screenshots:\n~~~~~~~~~~~~~~~~~~~~~~\n* Fullscreen\n* Active window\n* Active monitor\n* Window menu\n* Monitor menu\n* Region (possibly with added annotation, possibly text annotiation or picture?)\n* Polygon (custom shape for the screenshot as opposed to rectangular)\n* Freehand (draw a shape for the screenshot with the cursor, then use that)\n* Last region (take a screenshot of the region that was last captured, same shape)\n* Custom region (allowing for separated regions to be all captured in one file)\n* Screen recording (either saved as a .mp4 or .gif/.webm)\n* Automatic/timed capture\n\n\nAfter Capture Tasks:\n~~~~~~~~~~~~~~~~~~~~\n* Add image effects or watermarks\n* Open in image editor\n* Copy image to clipboard\n* Print image\n* Save image to file /as/ (allow for custom file naming)\n* Copy file or file path to clipboard\n* Upload to image host\n* Delete file locally\n\n\nAfter Upload Tasks:\n~~~~~~~~~~~~~~~~~~~\n* Upload file or directory\n* Upload from clipboard\n* Upload from url (given a url of a picture, upload that to specified host)\n* Watch directory for new files added, upload to host when found\n\n\nSupporting Image Hosts:\n~~~~~~~~~~~~~~~~~~~~~~~\n* Imgur\n* ImageShack\n* TinyPic\n* Flickr\n* Photobucket\n* Google Photos (Picasa)\n* Twitter\n* vgy.me\n* someimage.com\n* imgland.net\n\n\nURL Shorteners:\n~~~~~~~~~~~~~~~\n* bit.ly\n* goo.gl\n* is.gd\n* v.gd\n* tinyurl.com\n* adf.ly\n* turl.ca\n* coinurl.com\n* qr.net\n* vurl.com\n* 2.gp\n\n\nTools:\n~~~~~~\n* Color picker\n* Screen color picker\n* Image editor\n* Image effects\n* Hash check\n* DNS changer\n* QR code generator\n* Ruler\n* FTP client\n* Tweet message\n* Monitor test\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanpianka%2Fpysee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseanpianka%2Fpysee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanpianka%2Fpysee/lists"}