IMA(1)

NAME

ima - Image searcher and downloader

SYNOPSIS

ima [-v|--verbose] [-l|--image-link OUTPUT_FORMAT] [-o|--min-score SCORE] [-w|--overwrite] [-p|--no-progress-bar] [-t|--timeout TIMEOUT] [-a|--auto-name] [-n NUM] [-e|--engine ENGINE] [-r|--retries NUM] [-k|--no-color] [--version] [-s|--search-only] [-u|--number-sites NUM] [-i|--ignore-domains DOMAIN] [-m|--image-count NUM] [-q|--less-lines] [-x|--retries-per-sites NUM] [-d|--dest-dir DEST_DIR] [-h|--help] QUERY [..QUERY]

INTRODUCTION

ima is a command line tool used to search and download images on the internet. It uses either Google, Duckduckgo, or Yahoo to requests for links and then follow those links to extract images. ima has multiple options you may want to use especially when it fails to give reasonable results.

Mandatory arguments to long options are mandatory for short options too.

  -q, --less-lines

Wipe download progress bar after download has finished

  -m, --image-count NUM

Set NUM as maximum number of image links to be extracted from a website.

  -h, --help

Print this help text and exit.

  -x, --retries-per-sites NUM

Number of retries per sites if any connection fails.

  -d, --dest-dir DEST_DIR

Specify the destination directory were downloaded files will be stored, default to the current working directory of the executing program.

  --version

Print program version and exit.

  -s, --search-only

Query search engine and output search results only. This option is in conflict with the `-l' option.

  -i, --ignore-domains DOMAIN

A comma separated list of domains to ignore on search results.

  -u, --number-sites NUM

The number of websites to visit.

  -r, --retries NUM

Number of retries before giving up if any connection fails.

  -k, --no-color

Disable ANSI colors

  -v, --verbose

Print status messages to the standard output.

  -n NUM

Print NUM results obtained from the `-s' or `-i' option or download NUM images when neither of these options were specified.

  -a, --auto-name

Auto generate a new file name if a file name already exist in filesystem.

  -t, --timeout TIMEOUT

Set connection timeout.

  -e, --engine ENGINE

Comma separated list of search engines to use, possible search engines are duckduckgo, google, and yahoo. Engine defaults to "google". If more than one search engine is specified, cycle through when connection fails too much.

  -o, --min-score SCORE

Define mininum score for images. This option should not be used with the `-s' option.

  -p, --no-progress-bar

Disable progress bar for downloads.

  -w, --overwrite

Overwrite existing files, This option is in conflict with the `-a' option.

  -l, --image-link OUTPUT_FORMAT

Output image links instead of downloading them. You can use the following specifiers to format output:`{s}' represents the score of the given image, `{d}' its description, `{l}' its url, `{e}' its file extension and `{w}' the url from which the image link was extracted e.g: we can for example format our output as such -->"image {l} has score {s}".

Examples

1.  In in this context, use ‘ima’ to perform a simple search with google and dump out the results.

    ima -s 'OpenBSD'

2.  Use google engine to search and download 5 pics of Richard Stallman, 1 from each sites it founds.

    ima -n 5 -m 1 -a 'Richard stallman'

3.  Use Duckduckgo to search and download 10 pics of Sia, each pic having a minimum score of 1, save them at '~/artists/sia'.

    ima -e duckduckgo -d ~/artists/sia -n 10 -m 2 -o 1 'artists sia'

4.  Search and pip download link list of pics of sexy girls to ‘xargs’.

    ima -l '{l}' 'sexy girls' | xargs wget

AUTHORS

tcheukueppo <tcheukueppo@tutanota.com>

BUGS

Presumably. Report them or discuss them at:

https://github.com/tcheukueppo/ima/issues

COPYRIGHT

License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.