Skip to content
Switch branches/tags

Latest commit


Git stats


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


GNU Public License v3

Copyright © 2012 Aurélien PIERRE - aurelien[at]

Scan2Thunderbird is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see

Plateform : GNU/Linux Tested on : Ubuntu 12.04 - Ubuntu 13.04

To run, this script needs this packages : sane (command scanimage), imagemagick (command convert), gzip, thunderbird, evince & coreutils (command shred).

Aim of the script

This program is designed for people who have to scan single ou multiple pages files in order to send them by email. It is usefull for those who don't care about several options and complicated settings. It is simple, fast and efficient.

Running the script (Through source-code)

In a shell, type :

$ cd script-directory

$ sh

That's it !

You can optionnaly make a launcher with gnome-menu, for example. In this case, don't forget to check "Shell application" option.

Running the script (Through .deb package)

Juste launch the Scan2Thunderbird shortcut in your dash/panel/menu.


At the beginning of the script, you can choose :

  • the name of the file
  • the number of pages to scan,
  • color or black & white outpout.

All the rest is automatic.

At the end, you can save a copy of the generated PDF file in your Home.


The outpout generated by the programm is a PDF file compressed at maximum with gzip. It is directly returned as attachment in Thunderbird after processing.

For multiple pages documents, all images are gathered in the same PDF.

The images are encoded in JPEG, 300 DPI resolution and compressed at 90% quality by default.

If the compressed PDF file weights more than 5 Mo (common mail privider restriction), the script asks you if you want to compress it again : the first recompression converts images to 150 DPI resolution, the next recompressions decreases quality of 1 % each time.

You can recompress outpout PDF much as it is necessary.

Support and suggestions

Every idea to improve the script is welcome. Send me an email at : aurelien[at]

For support and help, go to Github repository, section "Issues" :

Thanks and good scans !


From your scanner to your contacts faster than ever !



No packages published