The purpose of this library is to provide command line tools that enable content-aware image browsing from the CLI..
lsimg for example ( which is the first implemented application ) should be able to return images which are larger than a specific resolution , that contain faces , that are similar to another one , that are bright ( histograms ) , that have been taken in a specific Longitude/Latitude ( EXIF ) or the same content as some other image file etc..
You can view implemented functionality by issuing "lsimg --help"
To submit bug or feature tickets you can use the github issue system https://github.com/AmmarkoV/AdvancedImageSearch/issues
To get the project issue
git clone git://github.com/AmmarkoV/AdvancedImageSearch.git
cd AdvancedImageSearch
You can also get the project as a zip file by clicking here https://nodeload.github.com/AmmarkoV/AdvancedImageSearch/zip/master or
wget https://nodeload.github.com/AmmarkoV/AdvancedImageSearch/zip/master
unzip master
cd AdvancedImageSearch-master
The program requires libjpeg , libpng , opencv , darknet and gcc to enable all features! It can also operate without problems without darknet and/or opencv but some advanced functionality will not be available. It also requires exif tool for JPG exif functionality that greatly speeds up some operations when just scanning JPEG headers.
To install them issue :
sudo apt-get install cmake build-essential git g++ gcc exif libjpeg-dev libpng12-dev
Libraries that are not available on repositories can be installed using the following instructions. OpenCV should be a version after version 3.0 which went under a very large refactoring and also contain the nonfree/contrib components. This library is not available in repositories and thus has to be downloaded and built from source something that might be tricky for some users. The semantic search features ( which is a really nice feature ) will also require Darknet to be installed in order to be enabled.
Luckily, all of these dependencies can be installed using the script provided in 3dparty/get_third_party_libs.sh which asks you and then downloads, configures and tries to auto-build the dependencies.
In order to run the script and assuming you are on the main directory issuing the command :
3dparty/get_third_party_libs.sh
will download these dependencies and guide you through the procedure, you should also enable the correct CMake switches afterwards. This can be done using console ( cmake -DENABLE_DARKNET=ON -DENABLE_FACEDETECTION=ON -DENABLE_OPENCV=ON -DENABLE_PATTERNRECOGNITION=ON .. ) or a GUI like cmake-gui
In order to make a local copy of the project go to the Project root directory and simply issue
mkdir build && cd build && cmake .. && make
If you wish to make a system persistent installation just issue
mkdir build && cd build && cmake .. && sudo make install
Sample usage of lsimg :
It will move all images smaller than 640x480 to the subdir small!
mv `lsimg --maxDims 640 480 /home/me/Pictures/Wallpapers/Raw` Small/
It will move all images suitable for wallpaper ( larger than 1680x1050 ) to the wallpaper dir!
mv `lsimg --minDims 1680 1050 /home/me/Downloads/` /home/me/Pictures/Wallpapers/Raw/
It will move all images suitable for wallpaper that are "red" ( larger than 1680x1050 ) to the red wallpaper dir!
mv `lsimg --color red --minDims 1680 1050 /home/me/Downloads/` /home/me/Pictures/Wallpapers/Red/
Find all images like ~/me.jpg in ~/Downloads directory
lsimg --like ~/me.jpg ~/Downloads/
Find all images containing the same contents as ~/camel.jpg in ~/Downloads directory
lsimg --semantics ~/camel.jpg 10 ~/Downloads/
Open all the "green" images with gpicview
cd ~/Downloads
lsimg --color green ./ | xargs -n 1 gpicview #
Open all the images with exactly 3 faces with gpicview
./lsimg --minFaces 3 --maxFaces 3 . | xargs -n 1 gpicview