1. Davide Alberani
  2. imdbpygw

Overview

HTTPS SSH
   IMDb gateway
   ============

NOTE: to use the IMDb's web site and data, you've to accept the conditions
      listed here: http://www.imdb.com/conditions
      See also the "DISCLAIMER.txt" file in the documentation of the
      IMDbPY package.

This is a simple gateway to the IMDb site, based on the IMDbPY package;
it can be used to access IMDb's data from a simple low-band terminal,
as a mobile phone with WAP support.

You've to copy the 'imdbsearch.py' and 'showitem.py' files that you can
find in the ./cgi-bin directory to the directory of the CGI of your web
server (e.g.: /usr/lib/cgi-bin/, on some systems).

Then you've to copy the './ig' directory under the root directory of
your web server.
The 'index.php' file is a php page, used to select the right page
for the requiring browser (it can be a wap terminal, or a normal
browser).
The 'html_index' file is the main page for html/http browsers, while
the 'wml_index' file is the main page for wml/wap/mobile browsers.

Remember that you've to modify:
1. the 'html_index' file, so that the "action" attribute of the "form"
   element points to the 'imdbsearch.py' cgi.
2. if you want wap/mobile access, modify the 'wml_index', changing
   the "href" attribute of the "go" element to the path of the
   'imdbsearch.py' cgi.
3. the first lines of the 'imdbsearch.py' and 'showitem.py' scripts
   contain the SHOWITEM_PATH and MAIN_PAGE variables; these should
   point, respectively, to the path of the 'showitem' cgi and to the
   path of the main search page.
4. you can set a web proxy, which will be used to access the IMDb
   site, modifying the HTTP_PROXY variable in the 'imdbsearch.py' and
   'showitem.py' scripts (leave it to 'None' and no proxy will be used).
5. in the 'index.php' file you can uncomment the first block of code
   to log web accesses (you've also to create the ../../data/ directory)


  NOTES FOR MOBILE USERS
  ======================

The 'imdbsearch.py' and the 'showitem.py' cgi output is always HTML, but
it's should be easily converted by your gateway/proxy; if this's not
the case, try using the html2wml script/cgi.


  LICENSE
  =======

The code is covered by the GPL license.


  AUTHOR
  ======

You can contact me at Davide Alberani <da@erlug.linux.it>
My homepage: http://erlug.linux.it/~da/

Feel free to contact me for any ideas, bug reports and everything else. :-)


  HISTORY
  =======

- version 1.0 (24 Dec 2008)
  - support for episodes.
  - fix for the new 'plot' and 'biography' texts.

- version 0.9 (08 Jun 2008)
  - support for companies.

- version 0.8 (15 Nov 2007)
  - updated to be compatible with character pages (supported!).

- version 0.7 (26 Sep 2006)
  - fixed unicode-related bugs.


  CREDITS
  =======

I'd like to thank the following people:
- Tudza, for many bug reports.