Skip to content
This repository has been archived by the owner before Nov 9, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



This is a launchd.plist for moving screenshots to Dropbox and copying the public URL.

In 2013 Dropbox added the ability to save your screenshots in Dropbox This is an awesome feature that I've used almost daily since it was announced.

One problem with this feature is that the URL copied to your clipboard is for an HTML landing page like This makes it difficult to paste directly into places like GitHub Issues that need a real image URL.

Another issue I've had is after using this feature for 2.5 years, my ~/Dropbox/Screenshots directory has around 1000 files in it, making it difficult to browse in Finder or upload file dialogs.

This plist is meant to replace Dropbox's screenshot sharing feature. It watches for new screenshots created in ~/Desktop (the default on OS X), and moves them to ~/Dropbox/Public/Screenshots/YYYY-MM (where YYYY is the current 4-digit year and MM is the current 2-digit month). A public URL is copied to your clipboard and can be pasted directly into GitHub Issues or elsewhere, eg:


  1. You need a Dropbox Public Folder. If you have an account created before October 4, 2012, you should already have one. If your account was created after this date, you need a Pro or Business account to enable a Public folder. If you should have a Public folder and don't see it, you can enable it here.

  2. Disable the Dropbox screenshot sharing feature. Option+Click on the Dropbox icon in the OS X menubar and click Preferences. Click the Import tab, then uncheck "Share screenshots using Dropbox".

  3. Find your Dropbox user ID. This can be done by copying the URL to a file under ~/Dropbox/Public via Finder and grabbing the /u/DROPBOXID section of the URL (see this super user post).


Homebrew installation

$ DROPBOX_ID=12345 brew install --HEAD itspriddle/brews/dropbox-screenshots-plist [--with-terminal-notifier]
$ ln -sfv $(brew --prefix)/opt/dropbox-screenshots-plist/*.plist ~/Library/LaunchAgents
$ launchctl load ~/Library/LaunchAgents/net.nevercraft.dropbox-screenshots.plist

Manual installation

$ git clone
$ cd dropbox-screenshots-plist
$ DROPBOX_ID=12345 rake install
$ launchctl load ~/Library/LaunchAgents/net.nevercraft.dropbox-screenshots.plist

By default the plist will use terminal-notifier if it is installed (brew install terminal-notifier to install). Clicking the notification will open the URL in your browser. To disable notifications install with the NO_TERMINAL_NOTIFIER flag:

$ NO_TERMINAL_NOTIFIER=1 DROPBOX_ID=12345 rake install


To uninstall:

$ launchctl unload ~/Library/LaunchAgents/net.nevercraft.dropbox-screenshots.plist
$ rm ~/Library/LaunchAgents/net.nevercraft.dropbox-screenshots.plist


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


DEPRECATED - Move screenshots to Dropbox and copy the public image URL






No releases published


No packages published