{"id":17767263,"url":"https://github.com/jcarizza/drosh","last_synced_at":"2025-08-22T08:12:26.961Z","repository":{"id":50188347,"uuid":"97324639","full_name":"jcarizza/drosh","owner":"jcarizza","description":"📷 Autogenerate Dropbox shared links for your screenshots","archived":false,"fork":false,"pushed_at":"2022-12-08T05:14:11.000Z","size":42,"stargazers_count":5,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T15:22:58.063Z","etag":null,"topics":["dropbox","link","productivity","python","screenshot","share","shutter","upload"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jcarizza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-15T15:28:03.000Z","updated_at":"2025-01-16T10:28:33.000Z","dependencies_parsed_at":"2023-01-24T12:01:00.032Z","dependency_job_id":null,"html_url":"https://github.com/jcarizza/drosh","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jcarizza/drosh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarizza%2Fdrosh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarizza%2Fdrosh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarizza%2Fdrosh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarizza%2Fdrosh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jcarizza","download_url":"https://codeload.github.com/jcarizza/drosh/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcarizza%2Fdrosh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271606595,"owners_count":24788979,"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","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dropbox","link","productivity","python","screenshot","share","shutter","upload"],"created_at":"2024-10-26T20:44:41.147Z","updated_at":"2025-08-22T08:12:26.926Z","avatar_url":"https://github.com/jcarizza.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.com/jcarizza/drosh.svg?branch=master)](https://travis-ci.com/jcarizza/drosh)\n\n# Drosh\nUse your favourite screenshot tool and let Drosh script upload it to Dropbox and create a shared link\n\n\n![Example](https://www.dropbox.com/s/2vz4xuksyoaqu4a/screencast.gif?dl=0\u0026raw=true)\n\n# Requirements\n\n- inotify\n- dropbox\n- Something to daemonize the script\n\n# Setup\n\n## Create Dropbox App\n\nCreate a Dropbox App in https://www.dropbox.com/developers/apps with *full access* then in the OAuth2 section create your private access token and configure the script.\n\n## Quick start\n```\npip install -r requirements.txt\n\nexport DROSH_DROPBOX_TOKEN='\u003cyour-dropbox-token\u003e'\nexport DROSH_DROPBOX_FOLDER='\u003cyour-dropbox-screehshots-folder\u003e'\nexport DROSH_SCREENSHOT_FOLDER='\u003cyour-system-screenshot-folder\u003e'\n(env) python drosh.py\n```\n\n## Setup with supervisor\n\n### Environment variables\n```\nDROSH_DROPBOX_TOKEN - OAuth2 token generated in the Dropbox App\nDROSH_DROPBOX_FOLDER - Web site Dropbox folder\nDROSH_SCREENSHOT_FOLDER - Full path to your Dropbox folder where you save screenshots\nUSER - Your username\nHOME - Your home path\nLOGNAME - Your username\nDISPLAY - Your X Server screen, \":0.0\" by default. https://askubuntu.com/questions/432255/what-is-display-environment-variable  \n```\n\n\n### Use in console for upload one file\n```\npython drosh.py --upload screenshot.png\n\nShare this link!\nhttps://www.dropbox.com/s/8uzja12dawdadfpdci91fi/screenshot.png?dl=0\n\n```\n\n### Supervisor script to run on watch mode\n```\n[program:drosh]\ncommand=\u003cfull-path-virtualenv\u003e/bin/python \u003cpath-to-drosh\u003e/drosh.py --watch\nuser=\u003cyour-username\u003e\nautostart=true\nautorestart=true\nstderr_logfile=/var/log/drosh-stderr.log\nstdout_logfile=/var/log/drosh-std.log\nenvironment=DROSH_DROPBOX_TOKEN='\u003cyour-dropbox-token\u003e',DROSH_DROPBOX_FOLDER='\u003cyour-dropbox-screehshots-folder\u003e',DROSH_SCREENSHOT_FOLDER='\u003cyour-system-screenshot-folder\u003e',USER=\u003cyour-username\u003e,HOME=\u003cyour-home-folder\u003e,LOGNAME=\u003cyour-username\u003e,DISPLAY=\":0.0\"\n```\n\n\n### Contributors\n- [zamoroka](https://github.com/zamoroka)\n\n\n### Troubleshooting\n\n#### The notification does not appear on my desktop\nThere is some problem with the env var `DISPLAY` or check the permision of your supervisorfile. You can see the discussion on this thread https://github.com/jcarizza/drosh/issues/3\n\n\n#### Pyperclip could not find a copy/paste mechanism for your system\n\nMaybe you need some extra requirements, Pyperclip uses gtk or PyQt4 to access the paper clim. https://github.com/asweigart/pyperclip/blob/master/docs/introduction.rst\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcarizza%2Fdrosh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjcarizza%2Fdrosh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcarizza%2Fdrosh/lists"}