Distributions

1. Windows: no requirements, everything is included on the installer
2. Generic Linux
3. Debian
4. SuSE
5. Gentoo
6. Mandrake
7. Red Hat
8. KRUD

Generic

These instructions apply to all GNU/Linux systems.

Requirements:

• Python - Download here.
• Python development files.

  That is, you either need python installed from the official source tarball or the package from your distribution that provides Python header files. Specifically, Python.h, which should be located at /usr/include/python2.2/

• PyQT 3.5 - Download here.
• QT 3.x
• QT development files or ImageMagick and development files.

Optional requirements (but highly recommended):

• ImageMagick library and development files - Download here.

  If detected during installation, imgSeek will support over 87 image formats.

• Python Imaging Library - Download here.

If detected during installation, IPTC metadata extraction and Transform tools will be enabled.

All GNU/Linux distributions provide these requirements. Use your distribution's .deb/.rpm/.ebuild/etc... If you have any problem installing imgSeek, feel free to email me or the users mailing list.

Source Install

Untar the downloaded archive:

$ tar -zxvf imgSeek-0.6.tar.gz

The contents will be placed on a directory called "imgSeek".

If you have ImageMagick library and development files, make sure you also have "Magick++-config" (this is installed by ImageMagick, and is used to determine compile flags and header files location)

If you don't have or don't want to install ImageMagick, then you will need QT 3.x development files installed. If this is the case, make sure the QTDIR environment variable is properly set to the correct location where QT was installed to.
Type "echo $QTDIR" to see what it is pointing to.
You can set it with "export QTDIR=/usr/lib/qt", where you should change /usr/lib/qt to the proper location.

To install, enter the imgSeek directory where archive contents were extracted to and type, as root:

# python setup.py install

Install problems

If the error message you keep getting is related to PyQt, please check this entry on the FAQ doc. 

If your errors are related to compile errors while building the extension module:
Make sure that you also have QT development files or ImageMagick development files installed.

Also make sure you have the python-dev package on your distribution and try the install step above again.

If you don't succeed, you may have to compile the extension module manually:

To do so, get into the imgSeek-0.6.1/imgSeekLib/ directory.

If you have QT development files on your machine, enter these commands:

• g++ -DNDEBUG -fPIC -I/usr/qt/3/include -I/usr/include/python2.2/ -c imgdb.cpp -o imgdb.o
• g++ -DNDEBUG -fPIC -I/usr/qt/3/include -I/usr/include/python2.2 -c haar.cpp -o haar.o
• g++ -shared imgdb.o haar.o -L/usr/qt/3/lib -lqt-mt -o imgdb.so

Making sure that you change the following to suit your system: "/usr/qt/3/include" should be replaced with the proper place where qt header files (*.h) are installed which could be /usr/share/qt/include on some distributions. "/usr/qt/3/lib" with the place where QT libraries are and; "/usr/include/python2.2/" with the directory where Python development header files (Python.h) are.

If you have ImageMagick development files on your machine, enter these commands:

• g++ -DNDEBUG -fPIC -DImMagick `Magick++-config --cxxflags --cppflags` -I/usr/include/python2.2/ -c imgdb.cpp -o imgdb.o
• g++ -DNDEBUG -fPIC -DImMagick `Magick++-config --cxxflags --cppflags` -I/usr/include/python2.2 -c haar.cpp -o haar.o
• g++ -shared imgdb.o haar.o `Magick++-config --ldflags --libs` -o imgdb.so

Making sure that you change the following to suit your system: "/usr/include/python2.2/" with the directory where Python development header files (Python.h) are.

Also make sure that the program "Magick++-config" is available

After building the module, you will have a file "imgdb.so" on the imgSeekLib dir, which you should copy to /usr/lib/python2.2/site-packages/imgSeekLib/ or if /usr/lib/python2.2 doesn't exist: /usr/local/lib/python2.2/site-packages/imgSeekLib/ (you will have to become root to do so)

Running

To run imgSeek type:

$ imgSeek

imgSeek executables will be installed to /usr/bin/ by default.

Debian

Some users reported that PyQt 3.7 crashes when doing drag&drop actions on Debian SID, so you may wanna try downgrading it to 3.5.

If you run Debian SID, you should check this thread for the new official PyQt-3.5 packages. 
More about PyQt and imgSeek on SID here

PyQt and related Debian packages may be found here.

Thanks Tobias Kunze Briseño for the following info:

• - setup.py (on the root dir of imgSeek source tarball) needs these directories set on the beginning of setup.py: (standard Debian locations)

  qtdir=["/usr/share/qt/"]
  python_dir="/usr/include/python2.2"
  

• - Required packages
  Name Version
  ========================-========================
  libqt3 3.1.1+cvs.20021220-1
  libqt3-dev 3.1.1+cvs.20021220-1
  libqt3-helper 3.1.1+cvs.20021220-1
  libqt3-mt 3.1.1+cvs.20021220-1
  qt3-tools 3.1.1+cvs.20021220-1
  python2.2 2.2.2-5
  python2.2-dev 2.2.2-5
  python2.2-qt3 3.4-1
  python2.2-sip-qt3 3.4-1
  

• - Probably Required packages
  python2.2-tk 2.2.2-5
  python2.2-imaging 1.1.3-4
  python2.2-optik 1.4-3
  

• - If the C++ build process fails, check the INSTALL file for instructions on how to do it manually.

On Sid, python2.2-qt3_3.5-1_i386.deb and co. seems to be broken.

In order to avoid "Undefined symbols" errors caused by incompatible libraries, you may have to use the same version of gcc that was used to build the libqt3 and PyQT3/sip-qt3 packages.

Python Imaging Library corresponds to the "python-imaging" package.

SuSE

Requirements:

• python-2.2
• python-imaging-1.1.2
• python-devel-2.2
• python-xml-2.2
• PyQt-3.5
• PyQt-devel-3.5
• Qt-3.x

Please note that if install fails due to PyQt errors, you may need to build/install PyQt from SIP and PyQt development snapshots, specially if you have the latest Qt version (3.1.2)

Optional requirements (but highly recommended):

• ImageMagick library and development files (ImageMagick and ImageMagick-devel packages) - Download here.

  If detected during installation, imgSeek will support over 87 image formats.

  Package names:

  • ImageMagick-5.4.2-96
  • ImageMagick-Magick++-5.4.2-96
  • ImageMagick-devel-5.4.2-96
• Python Imaging Library - Download here.

If detected during installation, IPTC metadata extraction and Transform tools will be enabled.

If you didn't succeed installing PyQT using official packages, try those provided here. (You may need to install all of them)

For SuSE 8.1, you may try the RPM snapshot packages provided here

If for some reason you have to build PyQt and it's dependencies from source, you may need (SuSE 7.3 for example) to replace tmake for qmake in the *.py build scripts, otherwise it doesn't work (tmake v1.7 seems to be broken).
You may find more information regarding PyQt install here.

Requirements (For SuSE 7.3):

• qt3 (official packages and it's requirements)
• QT development files (qt3-devel)or ImageMagick and development files.
• Python 2.2 (SuSE)
• PyQt 3.5 is not (yet) provided by SuSE so visit this site.
  Don't forget to install numeric as is listed on the site. go through the entire routine (I didn't upgrade qt3 though).
  So you will have to build: numeric, sip, PyQt
  But first before building do: "export QTDIR=where_is_your_qt3" in SuSE that probably is:
  "export QTDIR=/usr/lib/qt3"
  Check every build.py or setup.py for "Tmake" and replace it with "qmake"
  Now you can build.
  When building stops for something like: "qt or qt-mt ....-l option" use the latter: "-l qt-mt" qt-mt comes with qt3-devel
  When all this is done, make sure QTDIR still points to the correct QT location ("/usr/lib/qt3" probably) and install imgSeek with:
  # python setup.py install
  
  good luck !
  

If the RPM didn't work for you, you may have to install the source tarball. In this case, you'll need these official packages:

• libqt3-devel (if the supplied RPM doesn't work) or ImageMagick and devel packages
• python-devel > 2.2 (official packages and it's requirements)

Thanks Ivo Kroone and Piet Roorda for the info.

Gentoo

Since imgSeek is part of the portage tree, all you have to do is:

# emerge media-gfx/imgseek

If you don't have ACCEPT_KEYWORDS="~x86" (or your architecture) on your /etc/make.conf, you may need to try this instead:

# ACCEPT_KEYWORDS="~x86" emerge imgseek

These will be emerged automatically as dependencies:

• dev-lang/python
• dev-python/PyQt
• x11-libs/qt

Optional requirements (but highly recommended):

• dev-python/Imaging
• media-gfx/imagemagick

Mandrake

imgSeek has been recently added to the contrib repository, so if you have a recent Mandrake version, you can add a contrib mirror to your urpmi sources list and then type the following (as root) and you are done.

urpmi imgSeek
		

Check here for Cooker RPMs.

The official PyQt (and dependencies) RPM's from Mandrake 9.1 seem to be broken (Unable to import libsip, and after a few tweaks and using RPM's from Cooker, all I got was "undefined symbol: _ZNK9QSGIStyle9classNameEv").

So you may want to try the PyQt RPM's for MDK 9.1 provided here or here or here.

If all else fails, you may have to compile PyQt and/or Qt from source. Check this thread and the instructions below.

Requirements:

• libqt3-mt (official packages and it's requirements)
• python > 2.2 (official packages and it's requirements)
• sip-3.4
• libsip9-3.4
• libsip9-devel-3.4
• PyQt-3.4
• PyQt-devel-3.4

Optional requirements (but highly recommended):

• ImageMagick library and development files - Download here.

  If detected during installation, imgSeek will support over 87 image formats.

• Python Imaging Library - Download here.

If detected during installation, IPTC metadata extraction and Transform tools will be enabled.

You may need to search for PIL RPM's at rpmfind.

If you didn't succeed installing PyQT using official packages, try those provided here. (You may need to install all of them)

In case you have to install imgSeek from sources, you'll need these official packages:

• libqt3-devel or ImageMagick and development packages.(ImageMagick and ImageMagick-devel packages)
• python-devel > 2.2 (official packages and it's requirements)

If building from source succeeded but you get "Unresolved symbols" errors when running imgSeek, you may have to build QT from official sources and manually copy binary libraries (lib*.so) to the destination qt library dir (/usr/share/qt or similar). Somehow Mandrake's "make install" strips the libraries in a way that makes them useless or results in C++ linking errors. After you have pure QT libraries on the proper place, you should build PyQt from sources too. 
This way you will make sure all QT related libs and wrappers are compatible since they were built with the same compiler and common libs.

Thanks cognite|at|zianet.com for helping me test and provide info on Mandrake 9.0

KRUD

Since KRUD tracks Red Hat and is updated every month, the requirements for it should be the same.

Thanks Sean Reifschneider for the RPM's below:

Binary RPM's and dependencies.

Source RPM's

Red Hat

Requirements:

• libqt3-mt (official packages and it's requirements)
• python > 2.2 (official packages and it's requirements)
• sip-3.4
• libsip9-3.4
• libsip9-devel-3.4
• PyQt-3.4

Optional requirements (but highly recommended):

• ImageMagick library and development files - Download here.

  If detected during installation, imgSeek will support over 87 image formats.

• Python Imaging Library - Download here.

If detected during installation, IPTC metadata extraction and Transform tools will be enabled.

You may need to search for PIL RPM's at rpmfind.

If you didn't succeed installing PyQT using official packages, try those provided here

If the RPM didn't work for you, you may have to install the source tarball. In this case, you'll need these official packages:

• libqt3-devel (if the supplied RPM doesn't work) or ImageMagick and development packages.(ImageMagick and ImageMagick-devel packages)
• python-devel > 2.2 (official packages and it's requirements)