Skip to content
Switch branches/tags
Go to file

Latest commit

Added -tiff option, update ICDeviceDelegate implementation

Git stats


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


scanline is a command-line scanning utility for MacOS X. It was originally built for my own quirky archiving system, where I scan every document (bills, tax forms, etc.) and categorize them into folders. Rather than use a traditional scanning program that requires time consuming pointing and clicking, I wanted something where I could easily scan from a command prompt.

scanline has evolved to support many different purposes and options. Some of the things you can do with scanline are:

  • Run scanline as part of a script
  • Scan batches of documents
  • Scan from the document feeder or flatbed
  • Scan in various formats, sizes, and modes all driven from command line options
  • Provide defaults in a config file (~/.scanline.conf)

Here are some example command lines:

scanline -duplex taxes
   ^-- Scan 2-sided and place in /Users/klep/Documents/Archive/taxes/
scanline bills dental
   ^-- Scan and place in /Users/klep/Documents/Archive/bills/ with alias in /Users/klep/Documents/Archive/dental/

You can see all of scanline's options by typing:

scanline -help

Swift Rewrite

In December, 2017, the Swift rewrite of scanline was merged into master. Let me know if you experience any new issues.

Installing scanline

You can download the latest binary from:

Note that you may need to chmod it so it's executable:

cd [directory where you want it]
chmod a+x scanline
./scanline -help

Contributing to scanline

scanline was a quick and dirty first project. While portions of the code have been rewritten more recently, a lot of it displays some pretty unevolved style. I welcome your pull requests, but please know what you're getting yourself into!

You can also contact me with any questions or suggestions and I'll do my best to work them in eventually.