quiteconfused / CatImageInfo

Image Recognition through known Social Media also known as "Search by Image or Google Goggles". Tools to dynamically identify and rename images based on image content in a directory or in a tcpdump'ish fashion

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CatImageInfo
************
This project contains test tools that gather information on image content (not strings or meta information) and use that information in a dynamic and applied fashion.
The initial release of the program uses Google Search by Image capability in order to gauge the image content.
Some example tools developed include a direct Google Search by Image accessor program from the command line (postimage), a dynamic image dereferencing or "viewer" program and namesake (catimageinfo), and finally a program to dynamically rename all image in a directory based on their content (rename_directory.sh).


Compiling
*********

gcc -o catimageinfo catimageinfo.c -lpcap -lcurl -pthread
gcc -o postimage postimage.c -lcurl
gcc -o echo_server echo_server.c

OR

make 

:)


**Tested and compiled on Ubuntu 12.04

**Required libraries: libpcap, libcurl-dev, pthread


to run:
*********** VIEWER *******************
This tool provides a constant running view of all images downloaded to your computer (in a tcpdump'ish method)
*note not responsible for usage of catimageinfo and users acknowledge that this will report information gleaned from images downloaded to server and port of choice if used... use responsibly. This tool just like postimage below uses Google Search by Image to faciliate the image dereference.

(as root) ./catimageinfo [eth0] [-s <echo server ip> <echo server port>]



*********** POSTIMAGE ACCESSOR **********
This tool is a direct usage of post image, it will upload desired image to Google and report the desired level of verbosity for the image.   

./postimage <desired info> <imagepath> [<echo server ip> <echo server port>]
Desired Info - Description
0            - only report positive results
1            - report positive results OR simliar links
2            - report positive results AND similar links

**note this can be used with Driftnet -> driftnet -a | xargs --min-lines=1 ./postimage 0 



*********** IMAGE BINNING UTILITY *****
This tool renames all images within a directory. For instance if you wish to rename a directory of 10000 images in a single directory to content appropriate meanings run this tool. For example ~/Pictures/IMG_XXXX.jpg -> ~/newpicutres/epcot.jpg

**note this tool also reports home to the echo_server tool

./rename_directory.sh <directory of destination images> <directory of source images> <echo server ip> <echo server port>
*note, cwd IS important, dont change



*********** Frequency analysis ********
This is just a small tool to group and sort the content provided in a different way, may or may not be useful .. we'll see later :)
./identify_popular_terms.sh <results.txt>
*note, cwd IS important, dont change





About

Image Recognition through known Social Media also known as "Search by Image or Google Goggles". Tools to dynamically identify and rename images based on image content in a directory or in a tcpdump'ish fashion


Languages

Language:C 96.3%Language:Shell 3.7%