# The &kflickr; Handbook

## Introduction

&kflickr; is a standalone flickr.com uploader for KDE. It allows for easy upload of your favourite photos to the Flickr site. &kflickr; also allows you to easily edit most of a photo's attributes locally before they are sent to flickr thus making it easier then ever to share your photos online.

Please report any problems or feature requests to the &kflickr; mailing lists.

## Using &kflickr;

Here's a screenshot of &kflickr; Screenshot

### More &kflickr; features

In order to make &kflickr; easy to use it is constantly being added to and improved however the core features remain the same:

- Clean and easy to use interface

- Drag-n-Drop support to add and sort photos

- Easily edit the most common photo attributes

- Batch edit several photos at one time

- Support for multiple user identities

- Ability to specify photo upload size and orientation

- Upload photos directly to a new or existing photo set

- Assign one of many Flickr supported licenses to each photo

- Select tags from your existing tag list or easily create a new tag

- Session backup and restore

The photo list is the heart of &kflickr;. Drag-n-Drop your photos from any kde application, such as konqueror or digikam, onto the list to add them to &kflickr;. Drag-n-Drop a photo in the list to change the order of the photos will be sent to Flickr. Left click on a photo to select it for editing or removal. Pressing the control key while left clicking on photos will allow you to select several photos for batch editing or removal. The list also provides you with a global view of each photo loaded into &kflickr; and what it's attributes are set to. Depending on what is present in the list and what is selected you will notice that the various buttons found on the main &kflickr; window will be disabled or enabled according to which actions are available.

The photo properties dialog will present you with the necessary tools to change the photo attributes to what you want them to be. Here you will be able to set the photo title, description, privacy level, upload size and photo tags. You may also do basic photo enhancements such as rotation. The properties dialog may be invoked for a single photo or for several photos (known as batch mode). When in batch mode the dialog will have no attributes set. Setting an attribute will result in that attribute being applied to all photos in the batch. Leaving an attribute blank will result in no changes to that attribute for the photos in the batch.

## Command Reference

### The main &kflickr; window

The main window for &kflickr; is broken up into four areas: the photo list viewer, properties editor, main menubar and status bar. The menu is described in detail in the Command Reference chapter.

#### The File Menu

TBD

#### The Help Menu

&help.menu.documentation;

## Questions and Answers

What if I accidentally exit &kflickr; before uploading my photographs?

Relax, &kflickr; session management has you covered. &kflickr; automatically creates a backup of your session at keys times, such as just before you start an upload or you exit &kflickr;. Just ensure you don't rename or move any of the files used in your session and next time you start &kflickr; your session will be restored.

Why is &kflickr; giving me connection errors?

This is usually due to the fact that you are attempting to connect through a proxy server and have not setup your global KDE proxy server settings. In order to setup your connection properly edit the settings found on the Proxy configuration page in the Konqueror configuration panel.

Why is &kflickr; giving me connection errors as soon as I start it?

&kflickr; attempts to retrieve user information from Flickr when it first starts such as available bandwidth and user tags. Should your computer not be connected to the Internet or experiencing network problems &kflickr; will report connection errors. You may continue to use &kflickr; even after receiving the errors however you will notice some data, such as you Flickr tags, will be missing and it will still be necessary to establish a connection to the Internet before attempting to upload the photos.

Why can't &kflickr; upload my photo no matter how many times I try?

When uploads fail &kflickr; tries to report the exact error that caused the problem to you such that you can correct the situation and try again. However, in some cases the error reported is not correct or nearly useless. This is often not the fault of &kflickr; but rather Flickr.com as most of the error messages originate from there. In any case should you run into this issue please send an email to the &kflickr; support site such that the error handling can be improved.

With bigger and better digital cameras on the market more photos are exceding the flickr.com supported file size (5MB for a free account, 10MB for a pro account) and this just happens to be one of the cases in which the flickr.com returned error is useless, so should you be having issues this is one of the first things you should check on is are your photos too big?

## Credits and License

&kflickr;

Program copyright 2007 M. Asselstine asselsm@gmail.com

Documentation copyright 2007 M. Asselstine asselsm@gmail.com

&underFDL; &underGPL;
&documentation.index;