File	Date	Author	Commit
chronicon	2010-11-20	Bernd Stramm	[83cbcd] Merge branch 'master' of ssh://pirx.berndnet/gi...
docs	2010-08-03	Bernd Stramm	[0d88d7] more help and bump version
.gitignore	2010-06-11	Bernd Stramm	[3d904a] release version 0.2.1
.gitmodules	2010-05-06	Bernd Stramm	[427fc0] get rid of qoatuh submodule, will be maintained...
COPYRIGHT	2010-05-16	Bernd Stramm	[31dfc8] rpmbuild wants the COPYRIGHT file
Doxyfile	2010-05-21	Bernd Stramm	[e1091f] Merge branch 'master' of ssh://gitrepo@...
LICENSE.txt	2010-08-09	Bernd Stramm	[982fdb] added LICENSE.txt, something needs it
Makefile.in	2010-06-04	Bernd Stramm	[9c0e32] build structure detail, and making oauth more s...
README	2010-05-26	Bernd Stramm	[194248] tell people where the executable is
changelog	2010-06-11	Bernd Stramm	[827bac] change change log
chronicon.desktop	2010-08-06	Bernd Stramm	[24ad42] desktop file to be source from here, not from p...
chronicon.png	2010-08-03	Bernd Stramm	[a7edeb] desktop icon at the top
chronicon.txt	2010-05-02	Bernd Stramm	[97ccc5] initial files and submodule
chrontop.pro	2010-05-15	Bernd Stramm	[70a621] direct messages
configure	2010-08-09	Bernd Stramm	[716ea1] make notify = no the default build
findqmake.sh	2010-05-02	Bernd Stramm	[f997f3] standard set of files
fix_whirlpool.sh	2010-06-02	Bernd Stramm	[04eb94] almost ready to ship 0.1.4
pack.sh	2010-11-20	Bernd Stramm	[83cbcd] Merge branch 'master' of ssh://pirx.berndnet/gi...
push.sh	2010-05-08	Bernd Stramm	[af2024] forgot 1 line

Read Me

Chronicon is a twitter client using Qt and a QOAuth fork

When building from source, the executable is in chronicon/chronicon.

Using OAuth
-----------

By default, chronicon is configured to so Basic Authentication login.
This works for Twitter and StatusNet servers.

To use the new and improved authentication for Twitter called OAuth,
change the configuration:

 - click on Start/Stop
   - click on Configure
   - open up the "network" section
   - edit the "login_type" entry to read "oauth", without the quotes.
   - Save

Link Shortening
---------------

Chronicon will automatically shorten links in your posts if you tell it
your bit.ly user name and key. You can do that in the configuration.


Requirements
------------

To BUILD this, you need a few things:

- Qt 4.6 or later. Yes, Qt 4.5 won't work
- qca2-devel
- libnotify [see "Build Options" below if you don't have it]
- qjson-devel

To RUN this with OAuth, you also need:

- qca-ossl

  it will run with basic authorization without this library.
  It will *build* without this library as well, but if you try
  to use OAuth (web login), it will crash complaining about
  HMAC SHA1 not being supported. That is qca2 giving up.

Of course on your linux distro, library names may be different. 

Build Options
-------------

There are a few optional ways to build Chronicon.

There is a "configure" script, which at present has these options:

  --help  show option list and do nothing

  --prefix=/where/you/want/it   this sets the destination directory of
                                where you want "make install" to copy the
                                executable. Defaults to /usr.

  --nonotify                    compile chronicon without libnotify.
                                When you do that, you don't get
                                popup notification.