twitterpunch 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ba9e98cad4bdd2f862bae14d2748481537a86969
+  data.tar.gz: bfeeb93d6c2d9123c116411c341fc7bb7d9570c4
+SHA512:
+  metadata.gz: ee6ab95ecaacb496975e50752219257aa21cc540ddbb8c33278da800f60371a0e6978b11741bfd2af624a52b890fcd9c30bb0f8aea863d3c7960230f9f15599e
+  data.tar.gz: 13b3444517740d22b3332922a64082d0a604d5e83de7628b2abb5d90c91e47ff6cd6bf4cea64816e46084a100a49c6ad29e30015d825c4945f0245b327593bfa

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2014 Ben Ford <binford2k@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,110 @@
+Twitterpunch
+===============
+
+Twitterpunch is designed to work with PhotoBooth and OS X Folder Actions.
+When this script is called with the name of an image file, it will post the
+image to Twitter, along with a message randomly chosen from a list and a
+specified hashtag.
+
+If you call the script with the --stream argument instead, it will listen
+for tweets to that hashtag and download them to a specified directory. If
+the tweet came from another user, Twitterpunch will speak it aloud.
+
+Configuration
+===========
+
+Configure the program via the `~/.twitterpunch.yaml` YAML file. This file should
+look similar to the example below.
+
+    ---
+    :twitter:
+      :consumer_key: <consumer key>
+      :consumer_secret: <consumer secret>
+      :access_token: <access token>
+      :access_token_secret: <access secret>
+    :messages:
+    - Hello there
+    - I'm a posting fool
+    - minimally viable product
+    :hashtag: BestHalloweenPartyEver
+    :handle: FassFord
+    :photodir: ~/Pictures/twitterpunch/
+    :logfile: /Users/ben/.twitterpunch.log
+    :sendsound: /System/Library/PrivateFrameworks/ToneLibrary.framework/Versions/A/Resources/AlertTones/tweet_sent.caf
+
+A skeleton configuration file, with access tokens from Twitter, can be generated
+by running the program with the `--genconfig` flag.
+
+Usage 
+==========
+
+### Using OS X PhotoBooth
+
+1. Start PhotoBooth at least once to generate its library.
+1. Install the Twitterpunch Folder Action
+    * `twitterpunch --install`
+    * It may claim that it could not be attached, fear not.
+1. Profit!
+    * _and by that, I mean take some shots with PhotoBooth!_
+
+#### Troubleshooting.
+
+1. Make sure the folder action is installed properly
+    1. Use the Finder to navigate to `~/Pictures/`
+    1. Right click on the `Photo Booth Library` icon and choose _Show Package Contents_.
+    1. Right click on the `Pictures` folder and choose `Services > Folder Actions Setup`
+    1. Make sure that the `Twitterpunch` action is attached.
+1. Install the folder action
+    1. Open the `resources` folder of this gem.
+        * Likely to be found in `/Library/Ruby/Gems/2.0.0/gems/twitterpunch-#{version}/resources/`.
+    1. Double click on the `Twitterpunch` folder action and install it.
+        * It may claim that it could not be attached, fear not.
+
+### Using something else
+
+Configure the program you are using for your photo shoot to call Twitterpunch
+each time it snaps a photo. Pass the name of the new photo as a command line
+argument.  Alternatively, you could batch them, as Twitterpunch can accept
+multiple files at once.
+
+    [ben@ganymede] ~ $ twitterpunch photo.jpg
+
+### Viewing the Twitter stream
+
+Currently Twitterpunch doesn't display photos directly. It simply downloads them
+and stuffs them into the configured `:photodir`. Twitterpunch will run on OS X or
+Windows equally well. Simply configure it on the computer that will act as the 
+Twitter display and then run in streaming mode. Tweets that come from any other
+user will be spoken aloud.
+
+    [ben@ganymede] ~ $ twitterpunch --stream
+
+There are currently two decent viewing options I am aware of.
+
+* Windows background image:
+    * Configure the Windows background to randomly cycle through photos in a directory.
+    * Hide desktop icons.
+    * Hide the taskbar.
+    * Disable screensaver and power savings.
+    * Drawbacks: You're using Windows and you have to install Ruby & RubyGems manually.
+* OS X screensaver:
+    * Choose one of the sexy screensavers and configure it to show photos from the `:photodir`
+    * Set screensaver to a super short timeout.
+    * Disable power savings.
+    * Drawbacks: The screensaver doesn't reload dynamically, so I have to kick it
+      and you'll see it reloading each time a new tweet comes in.
+
+Limitations
+===========
+
+* It currently requires manual setup for Folder Actions.
+* It currently requires an external viewer, such as a screensaver.
+
+
+Contact
+=======
+
+* Author: Ben Ford
+* Email: binford2k@gmail.com
+* Twitter: @binford2k
+* IRC (Freenode): binford2k

data/bin/twitterpunch

@@ -0,0 +1,82 @@
+#! /usr/bin/env ruby
+
+require 'rubygems'
+require 'twitter'
+require 'optparse'
+require "net/http"
+require 'yaml'
+
+require 'twitterpunch'
+
+configfile = File.expand_path('~/.twitterpunch.yaml')
+config     = YAML.load_file(configfile) rescue {}
+
+optparse = OptionParser.new { |opts|
+  opts.banner = "Usage : twitterpunch [--debug] [--stream] [--install] [--version] [filename]
+
+    Twitterpunch is designed to work with PhotoBooth and OS X Folder Actions.
+    When this script is called with the name of an image file, it will post the
+    image to Twitter, along with a randomly chosen message and a hashtag.
+
+    If you call the script with the --stream argument instead, it will listen
+    for tweets to that hashtag and download them to a specified directory. If
+    the tweet came from another user, Twitterpunch will speak it aloud.
+
+"
+
+  opts.on("-d", "--debug", "Choose an alternate provisioning backend.") do
+    config[:debug] = true
+  end
+
+  opts.on("-s", "--stream", "Stream tweets from the specified hashtag.") do
+    config[:action] = :stream
+  end
+
+  opts.on("-g", "--genconfig", "Create a default configuration file.") do
+    config[:action] = :configure
+  end
+
+  opts.on("-i", "--install", "Install the Folder Action workflow (OS X only).") do
+    config[:action] = :install
+  end
+
+  opts.on("-v", "--version", "Display version information.") do
+    puts "Twitterpunch v#{Twitterpunch::VERSION}"
+    exit 0
+  end
+
+  opts.separator('')
+
+  opts.on("-h", "--help", "Displays this help") do
+    puts opts
+    exit
+  end
+}
+optparse.parse!
+
+config[:resources] = File.expand_path("#{File.dirname(__FILE__)}/../resources")
+config[:action] = :post if ARGV.size > 0 and config[:action].nil?
+
+case config[:action]
+when :stream
+  require 'twitterpunch/streamer'
+  client = Twitterpunch::Streamer.new(config)
+  client.stream
+
+when :post
+  require 'twitterpunch/poster'
+  client = Twitterpunch::Poster.new(config)
+  client.post(ARGV)
+
+when :configure
+  require 'twitterpunch/configuration'
+  cfg = Twitterpunch::Configuration.new(configfile).save
+  puts "Please edit #{configfile} to configure."
+
+when :install
+  system('open', "#{config[:resources]}/Twitterpunch.workflow")
+
+else
+  puts "Run twitterpunch --help for usage."
+  exit 1
+end

data/lib/twitterpunch.rb

@@ -0,0 +1,3 @@
+module Twitterpunch
+  VERSION = '0.0.1'
+end

data/lib/twitterpunch/configuration.rb

@@ -0,0 +1,67 @@
+require 'rubygems'
+require 'oauth'
+require 'yaml'
+
+module Twitterpunch
+  class Configuration
+
+    def initialize(file)
+      @configfile = file
+
+      puts "Set up your application at https://twitter.com/apps/"
+      puts "then enter your 'Consumer key' and 'Consumer secret':"
+
+      print "Consumer key: "
+      @consumer_key = STDIN.readline.chomp
+      print "Consumer secret: "
+      @consumer_secret = STDIN.readline.chomp
+
+      consumer = OAuth::Consumer.new(
+        @consumer_key,
+        @consumer_secret,
+        {
+          :site   => 'https://api.twitter.com/',
+          :scheme => :header,
+        })
+
+      request_token = consumer.get_request_token
+
+      puts "Visit #{request_token.authorize_url} in your browser to authorize the app"
+      # if we're on a Mac, open the page automatically
+      system("open #{request_token.authorize_url} 2>/dev/null")
+
+      print "Please enter the PIN you are given: "
+      pin = STDIN.readline.chomp
+
+      @access_token = request_token.get_access_token(:oauth_verifier => pin)
+    end
+
+    def save
+      config = YAML.load_file(@configfile) rescue defaults
+
+      config[:twitter] = {
+        :consumer_key        => "#{@consumer_key}",
+        :consumer_secret     => "#{@consumer_secret}",
+        :access_token        => "#{@access_token.token}",
+        :access_token_secret => "#{@access_token.secret}"
+      }
+
+      File.open(@configfile, 'w') {|f| f.write(config.to_yaml) }
+    end
+
+    def defaults
+      {
+        :messages => [
+          "Hello there",
+          "I'm a posting fool",
+          "minimally viable product"
+        ],
+        :hashtag   => "BestHalloweenPartyEver",
+        :handle    => "fassford",
+        :photodir  => "~/Pictures/twitterpunch/",
+        :logfile   => '/var/log/twitterpunch',
+        :sendsound => "/System/Library/PrivateFrameworks/ToneLibrary.framework/Versions/A/Resources/AlertTones/tweet_sent.caf",
+      }
+    end
+  end
+end

data/lib/twitterpunch/logger.rb

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'colorize'
+require 'logger'
+require 'fileutils'
+
+module Twitterpunch
+  class Logger
+    def initialize(config)
+      @options = config
+      @logger  = ::Logger.new(config[:logfile])
+
+      @logger.level = config[:debug] ? ::Logger::DEBUG : ::Logger::INFO
+    end
+
+    def error(message)
+      puts message.red
+      @logger.error(message)
+    end
+
+    def debug(message)
+      return unless @options[:debug]
+      puts message.yellow
+      @logger.debug(message)
+    end
+
+    def info(message)
+      puts message.green unless @options[:quiet]
+    end
+
+    def log(username, message)
+      @logger.info(sprintf("%15s: %s", username, message))
+    end
+  end
+end

data/lib/twitterpunch/poster.rb

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'twitter'
+
+module Twitterpunch
+  class Poster
+    def initialize(config)
+      @config = config
+      @client = Twitter::REST::Client.new(config[:twitter])
+    end
+
+    def post(files)
+      files.each do |img|
+
+        message = "#{@config[:messages].sample} ##{@config[:hashtag]}"
+        @client.update_with_media(message, File.new(File.expand_path(img)))
+
+        system("afplay #{@config[:sendsound]}")
+      end
+    end
+  end
+end

data/lib/twitterpunch/streamer.rb

@@ -0,0 +1,63 @@
+require 'rubygems'
+require 'yaml'
+require 'twitter'
+require "net/http"
+
+require 'twitterpunch/logger'
+
+module Twitterpunch
+  class Streamer
+    def initialize(config)
+      @config = config
+      @client = Twitter::Streaming::Client.new(config[:twitter])
+      @logger = Twitterpunch::Logger.new(config)
+      @output = File.expand_path(config[:photodir])
+
+      FileUtils.mkdir_p(@output) unless File.directory?(@output)
+    end
+
+    def stream
+      begin
+        @client.filter(:track => @config[:hashtag]) do |tweet|
+          if tweet.is_a?(Twitter::Tweet)
+            @logger.info(tweet.text)
+            @logger.log(tweet.user.screen_name, tweet.text)
+
+
+            unless tweet.user.screen_name == @config[:handle]
+              message = "#{tweet.user.name} says #{tweet.text.gsub(/ http\S*/,'').gsub(/#\S*/,'')}"
+
+              case RUBY_PLATFORM
+              when /mingw|cygwin/
+                system('cscript', "#{@config[:resources]}/say.vbs", message)
+              when /darwin/
+                system('say', message)
+              end
+            end
+
+            if tweet.media?
+              uri      = tweet.media.first.media_uri
+
+              http     = Net::HTTP.new(uri.host, uri.port)
+              request  = Net::HTTP::Get.new(uri.request_uri)
+              response = http.request(request)
+
+              File.open("#{@output}/#{File.basename uri.path}", 'wb') do |file|
+                file.write(response.body)
+              end
+
+              # OS X screensaver doesn't reload images dynamically. This kinda sucks.
+              if RUBY_PLATFORM =~ /darwin/
+                system('osascript', '-e', 'tell application "System Events" to stop current screen saver')
+                system('osascript', '-e', 'tell application "System Events" to start current screen saver')
+              end
+            end
+          end
+        end
+      rescue Interrupt => e
+        @logger.error "Exiting: #{e.message}"
+      end
+    end
+
+  end
+end

data/resources/Twitterpunch.workflow/Contents/Info.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AMFolderAction</key>
+	<string>AMAddingFolderItems</string>
+</dict>
+</plist>

data/resources/Twitterpunch.workflow/Contents/document.wflow

@@ -0,0 +1,194 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AMApplicationBuild</key>
+	<string>409</string>
+	<key>AMApplicationVersion</key>
+	<string>2.5</string>
+	<key>AMDocumentVersion</key>
+	<string>2</string>
+	<key>actions</key>
+	<array>
+		<dict>
+			<key>action</key>
+			<dict>
+				<key>AMAccepts</key>
+				<dict>
+					<key>Container</key>
+					<string>List</string>
+					<key>Optional</key>
+					<true/>
+					<key>Types</key>
+					<array>
+						<string>com.apple.cocoa.string</string>
+					</array>
+				</dict>
+				<key>AMActionVersion</key>
+				<string>2.0.3</string>
+				<key>AMApplication</key>
+				<array>
+					<string>Automator</string>
+				</array>
+				<key>AMParameterProperties</key>
+				<dict>
+					<key>COMMAND_STRING</key>
+					<dict/>
+					<key>CheckedForUserDefaultShell</key>
+					<dict/>
+					<key>inputMethod</key>
+					<dict/>
+					<key>shell</key>
+					<dict/>
+					<key>source</key>
+					<dict/>
+				</dict>
+				<key>AMProvides</key>
+				<dict>
+					<key>Container</key>
+					<string>List</string>
+					<key>Types</key>
+					<array>
+						<string>com.apple.cocoa.string</string>
+					</array>
+				</dict>
+				<key>ActionBundlePath</key>
+				<string>/System/Library/Automator/Run Shell Script.action</string>
+				<key>ActionName</key>
+				<string>Run Shell Script</string>
+				<key>ActionParameters</key>
+				<dict>
+					<key>COMMAND_STRING</key>
+					<string>twitterpunch "$@"
+</string>
+					<key>CheckedForUserDefaultShell</key>
+					<true/>
+					<key>inputMethod</key>
+					<integer>1</integer>
+					<key>shell</key>
+					<string>/bin/bash</string>
+					<key>source</key>
+					<string></string>
+				</dict>
+				<key>BundleIdentifier</key>
+				<string>com.apple.RunShellScript</string>
+				<key>CFBundleVersion</key>
+				<string>2.0.3</string>
+				<key>CanShowSelectedItemsWhenRun</key>
+				<false/>
+				<key>CanShowWhenRun</key>
+				<true/>
+				<key>Category</key>
+				<array>
+					<string>AMCategoryUtilities</string>
+				</array>
+				<key>Class Name</key>
+				<string>RunShellScriptAction</string>
+				<key>InputUUID</key>
+				<string>DB163A54-D2F3-40DB-B7F7-9D384EF50448</string>
+				<key>Keywords</key>
+				<array>
+					<string>Shell</string>
+					<string>Script</string>
+					<string>Command</string>
+					<string>Run</string>
+					<string>Unix</string>
+				</array>
+				<key>OutputUUID</key>
+				<string>B8E24806-125F-40F8-8545-355BF4B1F0BA</string>
+				<key>UUID</key>
+				<string>CD6A48B8-845B-4B58-ACB1-DB6A5FDEAAB9</string>
+				<key>UnlocalizedApplications</key>
+				<array>
+					<string>Automator</string>
+				</array>
+				<key>arguments</key>
+				<dict>
+					<key>0</key>
+					<dict>
+						<key>default value</key>
+						<integer>0</integer>
+						<key>name</key>
+						<string>inputMethod</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>0</string>
+					</dict>
+					<key>1</key>
+					<dict>
+						<key>default value</key>
+						<string></string>
+						<key>name</key>
+						<string>source</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>1</string>
+					</dict>
+					<key>2</key>
+					<dict>
+						<key>default value</key>
+						<false/>
+						<key>name</key>
+						<string>CheckedForUserDefaultShell</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>2</string>
+					</dict>
+					<key>3</key>
+					<dict>
+						<key>default value</key>
+						<string></string>
+						<key>name</key>
+						<string>COMMAND_STRING</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>3</string>
+					</dict>
+					<key>4</key>
+					<dict>
+						<key>default value</key>
+						<string>/bin/sh</string>
+						<key>name</key>
+						<string>shell</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>4</string>
+					</dict>
+				</dict>
+				<key>isViewVisible</key>
+				<true/>
+				<key>location</key>
+				<string>309.000000:253.000000</string>
+				<key>nibPath</key>
+				<string>/System/Library/Automator/Run Shell Script.action/Contents/Resources/English.lproj/main.nib</string>
+			</dict>
+			<key>isViewVisible</key>
+			<true/>
+		</dict>
+	</array>
+	<key>connectors</key>
+	<dict/>
+	<key>workflowMetaData</key>
+	<dict>
+		<key>folderActionFolderPath</key>
+		<string>~/Pictures/Photo Booth Library/Pictures</string>
+		<key>workflowTypeIdentifier</key>
+		<string>com.apple.Automator.folderAction</string>
+	</dict>
+</dict>
+</plist>

data/resources/say.vbs

@@ -0,0 +1,4 @@
+'say.vbs
+set s = CreateObject("SAPI.SpVoice")
+s.Speak Wscript.Arguments(0), 3
+s.WaitUntilDone(10000)

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: twitterpunch
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ben Ford
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: twitter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "Twitterpunch\n===============\n\nTwitterpunch is designed to work with
+  PhotoBooth and OS X Folder Actions.\nWhen this script is called with the name of
+  an image file, it will post the\nimage to Twitter, along with a message randomly
+  chosen from a list and a\nspecified hashtag.\n\nIf you call the script with the
+  --stream argument instead, it will listen\nfor tweets to that hashtag and download
+  them to a specified directory. If\nthe tweet came from another user, Twitterpunch
+  will speak it aloud.\n\nConfiguration\n===========\n\nConfigure the program via
+  the `~/.twitterpunch.yaml` YAML file. This file should\nlook similar to the example
+  below.\n\n    ---\n    :twitter:\n      :consumer_key: <consumer key>\n      :consumer_secret:
+  <consumer secret>\n      :access_token: <access token>\n      :access_token_secret:
+  <access secret>\n    :messages:\n    - Hello there\n    - I'm a posting fool\n    -
+  minimally viable product\n    :hashtag: BestHalloweenPartyEver\n    :handle: FassFord\n
+  \   :photodir: ~/Pictures/twitterpunch/\n    :logfile: /Users/ben/.twitterpunch.log\n
+  \   :sendsound: /System/Library/PrivateFrameworks/ToneLibrary.framework/Versions/A/Resources/AlertTones/tweet_sent.caf\n\nA
+  skeleton configuration file, with access tokens from Twitter, can be generated\nby
+  running the program with the `--genconfig` flag.\n\nUsage \n==========\n\n### Using
+  OS X PhotoBooth\n\n1. Start PhotoBooth at least once to generate its library.\n1.
+  Install the Twitterpunch Folder Action\n    * `twitterpunch --install`\n    * It
+  may claim that it could not be attached, fear not.\n1. Profit!\n    * _and by that,
+  I mean take some shots with PhotoBooth!_\n\n#### Troubleshooting.\n\n1. Make sure
+  the folder action is installed properly\n    1. Use the Finder to navigate to `~/Pictures/`\n
+  \   1. Right click on the `Photo Booth Library` icon and choose _Show Package Contents_.\n
+  \   1. Right click on the `Pictures` folder and choose `Services > Folder Actions
+  Setup`\n    1. Make sure that the `Twitterpunch` action is attached.\n1. Install
+  the folder action\n    1. Open the `resources` folder of this gem.\n        * Likely
+  to be found in `/Library/Ruby/Gems/2.0.0/gems/twitterpunch-#{version}/resources/`.\n
+  \   1. Double click on the `Twitterpunch` folder action and install it.\n        *
+  It may claim that it could not be attached, fear not.\n\n### Using something else\n\nConfigure
+  the program you are using for your photo shoot to call Twitterpunch\neach time it
+  snaps a photo. Pass the name of the new photo as a command line\nargument.  Alternatively,
+  you could batch them, as Twitterpunch can accept\nmultiple files at once.\n\n    [ben@ganymede]
+  ~ $ twitterpunch photo.jpg\n\n### Viewing the Twitter stream\n\nCurrently Twitterpunch
+  doesn't display photos directly. It simply downloads them\nand stuffs them into
+  the configured `:photodir`. Twitterpunch will run on OS X or\nWindows equally well.
+  Simply configure it on the computer that will act as the \nTwitter display and then
+  run in streaming mode. Tweets that come from any other\nuser will be spoken aloud.\n\n
+  \   [ben@ganymede] ~ $ twitterpunch --stream\n\nThere are currently two decent viewing
+  options I am aware of.\n\n* Windows background image:\n    * Configure the Windows
+  background to randomly cycle through photos in a directory.\n    * Hide desktop
+  icons.\n    * Hide the taskbar.\n    * Disable screensaver and power savings.\n
+  \   * Drawbacks: You're using Windows and you have to install Ruby & RubyGems manually.\n*
+  OS X screensaver:\n    * Choose one of the sexy screensavers and configure it to
+  show photos from the `:photodir`\n    * Set screensaver to a super short timeout.\n
+  \   * Disable power savings.\n    * Drawbacks: The screensaver doesn't reload dynamically,
+  so I have to kick it\n      and you'll see it reloading each time a new tweet comes
+  in.\n\nLimitations\n===========\n\n* It currently requires manual setup for Folder
+  Actions.\n* It currently requires an external viewer, such as a screensaver.\n\n\nContact\n=======\n\n*
+  Author: Ben Ford\n* Email: binford2k@gmail.com\n* Twitter: @binford2k\n* IRC (Freenode):
+  binford2k\n"
+email: binford2k@gmail.com
+executables:
+- twitterpunch
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/twitterpunch
+- lib/twitterpunch.rb
+- lib/twitterpunch/configuration.rb
+- lib/twitterpunch/logger.rb
+- lib/twitterpunch/poster.rb
+- lib/twitterpunch/streamer.rb
+- resources/Twitterpunch.workflow/Contents/Info.plist
+- resources/Twitterpunch.workflow/Contents/QuickLook/Thumbnail.png
+- resources/Twitterpunch.workflow/Contents/document.wflow
+- resources/say.vbs
+homepage: http://binford2k.com
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A simple tool to automate the posting and streaming of PhotoBooth shots over
+  Twitter.
+test_files: []