Quick screen capture sharing utility for Mac OS X.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 2 commits ahead of csexton:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Quick screen capture and sharing for Mac OS X.

Note: I have switched my efforts to working on a native Mac version of Captured, which is avaliable on the Mac App Store. I recomend it over the ruby version because it is faster, lighter on system resources, and has a slightly diffrent feature set. The native version is a paid app (only 99¢), and the ruby version will always be free and open source. Thanks, Chris

Screen Capture Sharing Tool

I made captured because I wanted to customize and extend screen capture sharing programs, it is really intended for the commandline savvy.

So, I am making some assumptions about the environment that captured runs in. In particular it expects:

  • A decent understanding of installing ruby gems
  • That Growl is installed

With that said, once things are installed and configured it really is handy.


To install captured:

$ sudo gem install captured
$ captured --install

When you install an example config file to ~/.captured.yml, which has a few examples of possible configuration types.

Using Captured

The main use is to upload a screen shot taken using OS X's built in screen capture.

  1. Press ⌘-⇧-4 to capture
  2. Paste the link

Captured can also be used from the command line to easily share files.

  1. Run captured path/to/file
  2. Paste the link


By default captured uses Imgur as the default host, but you can configure it to upload and share images by other services.

To edit the configuraiton:

$ open -e ~/.captured.yml

Type: Imgur

The simple image sharer. The default option.

  type: imgur

Type: Rackspace Cloud Files

Use Rackspace's awesome Cloud Files.

  type: cloud_files
  username: username
  api_key: your_api_key
  url: "http://example.com/captured/"
  container: "your_container"

Type: Imageshack

This service is a little slower, but is free and easy.

  type: imageshack

Type: scp

If you have you own web server scp is a very handy way to host your own captures.

  • user - optional if your remote user is the same as your local user
  • password - optional if you have setup key pair authentication
  • host - the remote host name
  • url - the public url to the remote host+path
  • path - the remote path to upload to
  type: scp
  user: user
  password: secret
  host: example.com
  path: path/to/captured/
  url: "http://example.com/captured/"


Icons from the Crystal Clear icon set by Everaldo Coelho. – The icons are licensed under the GNU Lesser General Public License (LGPL).

The Logo was made from the fantastic Vector Wood Signs by DragonArt under the Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License.


Copyright (c) 2010 Christopher Sexton. See LICENSE for details.