
 Dianara - A Pump.io client
 Copyright 2012-2014  JanKusanagi <janjabber@gmail.com>

===============================================================================

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the
   Free Software Foundation, Inc.,
   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.

   Or visit http://www.gnu.org/licenses/

===============================================================================


Dianara is a Pump.io application for the desktop.
With it, you can access your Pump.io account without using a web browser.


If you only got the source code, see the INSTALL file for instructions on
how to build it.

Dianara looks best under Plasma Desktop, preferably using a very complete
iconset, like the Oxygen icons, but these are not requirements, just a
recommendation.
You can make the program look nicer in other environments by using 'qtconfig'.

Press F1 (or click on the Help menu) from Dianara's main window to check out
the basic help.



What it does
===============================================================================

 - Posting text (with some HTML formatting), to Followers, Public,
   custom person lists or specific people.

 - Uploading pictures, audio, video and general files.

 - Receiving different timelines, with configurable number of posts per page,
   and moving forward and backward in pages.

 - Liking, commenting, sharing, editing and deleting posts.

 - Liking, editing and deleting comments.

 - Contact listing, following and unfollowing, either by entering their
   webfinger address or through buttons in the lists and in the avatar menus.

 - Editing your profile, changing your avatar.

 - Watch the 'minor feed' of activities, a.k.a. "the Meanwhile", and opening
   related posts and following people from there.

 - Filtering or highlighting posts, according to a set of configurable rules.

 - Popup notifications when there are new posts, or new "Meanwhile" activities.

 - And more!



Some usage tips
===============================================================================

 - There are tooltips everywhere, so if you hover over a button or a text
   field with your mouse, you'll probably see some extra information.
   This is specially useful in the "Meanwhile" column.

 - When publishing a note or posting a comment, you can send using the
   keyboard, by pressing Control+Enter.

 - You can use Control+Up/Down/PgUp/PgDown/Home/End to scroll the timeline.

 - You can set "public posting" as the default in the Configuration window.

 - You can click on the avatar of a post's author to get some options.
   This also works in the comments, and in the Meanwhile feed.

 - If a post is of "image" type, you can click on the image to see it full size.

 - You can hide/show the side panel by pressing F9.
   Some items in the "Meanwhile" column have a "+" button to open the
   referenced post.

 - Adding titles to your posts will make the "Meanwhile" feed a lot more useful!

 - Resizing the window to half the screen width usually looks better, even though
   you can use it maximized, or in full screen mode, of course.

 - You can change the main window's icon and the icon used in system
   notifications by placing a 64x64 PNG image called dianara.png
   into /usr/share/icons/hicolor/64x64/apps/

 - If you connecto to the Internet through a proxy, you can set it up in the
   program Settings.


See the BUGS and TODO files for a list of known issues.



Command line parameters
===============================================================================

 - You can use the --config command line parameter to specify that a different
   configuration file be used.
   For example, if you run "dianara --config myotheraccount", the config file
   in use will be "Dianara_myotheraccount.conf" instead of the usual
   "Dianara.conf". This way, you can switch between different accounts easily.
   You can even run two instances of Dianara at the same time.

 - You can use the --debug command line parameter to have detailed debugging
   information on what the program is doing.



Languages
===============================================================================

Dianara is available in English, Catalan, Spanish and Italian languages.
There are polish and german translations in the works.

If you're interested in translating it to your language, let me know.
It's quite easy and it would be appreciated!




Visit http://jancoding.wordpress.com/dianara for more information.

Get the latest source from http://gitorious.org/dianara
