Read Me

PK-Remote
---------

Control Pentax K10D and K20D remotely & download pictures without using a
memory card, just like Pentax Remote Assistant(tm) 3.
Also included is a command line tool, pslr-shoot.

Software requirements
---------------------

GTK+ and libglade required to build the GUI, with development headers. 
PK-Remote requires Linux 2.6. 
The kernel must be compiled with scsi generic support (either builtin or as a module).

Building
--------

Edit the Makefile if you want pkremote installed elsewhere than /usr/local.

Build by typing 'make', then, as root, 'make install'.
'make uninstall' removes the program from your system.
You can build only the CLI by typing 'make cli', useful if your
system does not have a graphic environment.

NOTE: If you run Gentoo Linux, there is an ebuild available (though
not maintained by me); check http://nosuchaddress.net/pkremote/ for
details.

Hotplug support with udev
-------------------------

copy pentax.rules to /etc/udev

For Debian: symlink /etc/udev/rules.d/025_pentax.rules to /etc/udev/pentax.rules

For SuSE: symlink /etc/udev/rules.d/55-pentax.rules to /etc/udev/pentax.rules.

With pentax.rules your camera is recognized, and the device node is
owned by group 'plugdev'. If you want to run pkremote as a normal user
(which is the recommended way), add your user to the plugdev group.
Edit pentax.rules to change to another group if you like.

Quick Intro
-----------

Connect your camera to your PC as usual, using the USB cable. The top
LCD will say nothing but 'Pc' and the battery indicator. When you
start PK-Remote, the top LCD will start displaying exposure
information.

Run the executable 'pkremote' to see the graphic user interface,
or try pslr-shoot --help for help on the CLI.

If your camera is not detected, try (as root) 'modprobe sg'.

Now you can use the camera to take pictures as usual, even though it's
connected to the PC. Each time you take a picture, a preview will
appear in the 'main window', and a thumbnail will be added in the
'buffer window', up until a maximum of 9, after which the camera memory
is full.

To save the pictures to your PC, select one or more thumbnails using
the mouse, and click 'Save as' to get a file dialog. You can also use
the 'Delete' button to delete buffers from the camera memory.

You can also use the sliders and controls in the main window to set
the exposure and other parameters remotely.

The top of the main window displays the same exposure information as
the camera, and also a calculated EV value, based on the selected (by
the camera) aperture, shutter speed and ISO.