TwittAmiga

Short:        Twitter client
Author:       Oliver Urbann
Uploader:     oliver.urbann()gmail.com
Type:         comm/misc
Version:      4.3
Requires:     util/libs/mui38usr.lha; dev/mui/MCC_Lamp.lha;
dev/mui/MCC_TextEditor-15.37.lha; dev/mui/MCC_TheBar-26.8.lha;
comm/www/OpenURL-7.14-lha ;AmiSSL >= 3.6 (AmigaOS)
Architecture: m68k-amigaos >= 3.0; ppc-morphos; ppc-amigaos


     OVERVIEW
     ********

Twitter client with many features:     

 * Multiple user accounts
 * Account data stored without password
 * Preview of linked images
 * Update of status (send new tweets)
 * Load list of mentions
 * Show user information and related tweets
 * Search function (user and tweets)
 * Follow / Unfollow
 * Retweet
 * Avatars by datatype
 * MUI interface
 * OAuth support
 * URLs opened in browser (via OpenURL.library or via native URL:)
 
twittAmiga uses libcurl, libssl and others (see license folder for 
copyright information), therefore the executable is quite large. You should 
have at least 6 MB RAM. 

The GUI should be self-explanatory for twitter users. However, here a short 
description of the buttons in the toolbar:

 * Pred: Loads the previous page of the timeline.
 * Next: Loads the next page of the timeline.
 * Reload: Reloads the current page.
 * Home: Goes to the first page of the home timeline.
 * Send: Sends a new tweet (enter text into text editor above).
 * Tweet: Searches for tweets with the string entered in the text editor above.
 * User: Searches for user containing the string entered in the text editor
above.
 * Mentions: Shows tweets mentioning you.
 

You can retweet by clicking the double arrow icon on the left side of the tweet.

By clicking the question mark icon of a user you can see detailed informations
about
him/her. You can also follow/unfollow him/her by clicking the corresponding icon
above the tweet. 

User accounts are now stored by just saving the twitter key. It is
therefore no more required to save the password anywhere and it is asked only
once to retrieve the key by twitter. This can be done for multiple users. You 
can switch between multiple accounts by clicking the corresponding menu item.
A new window will be opened with a list of saved user accounts. Click on the
desired name and close the window. The user is then switched. To delete a user
you can edit the file keys.dat that is stored in the same directory as
twittAmiga. Just delete the line with the user to be removed. Deleting this
file will remove all users.

The configuration is done via tooltypes of the twittamiga.info. These are:

 * ACCOUNT: Your E-Mail address that you use for login. Can be empty.
            If you have multiple accounts this is the default account
            at startup.
 * TWEETS_PER_PAGE: The number of tweets that are shown on one page.
 * THEME: The name of the theme for the timeline. This is the name of a 
          directory within the twittAmiga directory. To use the default
          background type default.
 * CACHE: Path to a dir to store caching files. An / or : must be appended.
          Downloaded images are also stored here.
 * VIEWER: Name of executable (including path and options) to view images

     FAQ
     ***
Question: It can't login or login fails, what can I do?
Solution: You can use your email address for login or the twitter username
          which is usually displayed with a leading (). If you use your
          username do not enter the (). If you are not asked for name and
          password try to delete keys.dat which is located in the folder
          where you have stored twittAmiga.

Question: It does not start and does not show anything. What is happening?
Solution: Maybe there are missing libraries. Check the list above carefully.
          Sometimes also the MUI classes have dependencies that are not met.
          To check this, go to the settings page of this class and see if
          it works correctly.
         
Question: twittAmiga crashes when I push any button, is there a bug?
Solution: twittAmiga uses floating point integers for calculating the
          progress bar. Maybe you need a fpu library. I suggest:
          util/sys/Mu680x0Libs.lha from Aminet. If this does not solve
          the problem please continue to the next question.
                  
Question: I have problem XYZ. How can I solve it?
Solution: Try to start twittAmiga from a shell by typing:

          stack 102400
          twittamiga debug
                  
          You will see a long log of everything what is happening. Maybe
          there are error messages that can help you.
                  
Question: Where can I get news and help?
Solution: Follow me on twitter: twittAmiga or search the web for forum
          threads.
                                    
Question: The icons look crappy, what can I do?
Solution: Try another PNG datatype. All icons (except toolbar) and
          user images are displayed using datatypes.

Question: My window does not fit onto screen, what can I do?
Solution: You can configure the MUI for this window. Select "TheBar"
          and choose to view images only.

                  
         CHANGELOG
         *********
         
Please note that I allow distribution in software bundles, on media or on
download sites. However, I personally only upload to Aminet and thus other
sources may contain old versions. Make sure to check Aminet for the newest
version.
         
4.3
Many thanks to the donator who made the intensive work on the AmigaOS 4.1 FE
version possible.

Features:
- On OS 4.1 the native command OpenURL is used to open web browser
  instead of the separately installed library.
- OS 4.1 uses different charset, while OS 3.x always uses something similar
  to ISO-8859-1. On OS 4.1 thus the current charset is selected. 
- Retweets are now marked as <User> retweeted <User>
- Click on image preview loads image in full resolution and views it
  using the configured viewer. Image can be found in CACHE folder.
- Viewing all images provided in a single tweet.
- Showing who is retweeting and who is retweeted
Fixes:
- Tweets with many returns exceeded text gadget height,
  now height increased for every return in tweet
- HTML entities now converted to unicode
- You cannot add yourself to followers
- OS 4.1: Disabling a TheBar button seems to crash if mouse is over bar, now
          using sleep flag.
- Twitter API change, passwords must now be URL escaped before encryption
- Possible crash on exit fixed
- URL encoding of searches was wrong. Entered text with special 
  characters like # or % led to errors after pressing "Search" or "Send"  

4.2.2
Bugfix release with following changes:
- Fix in error handling, missing MUI classes error message
- Loading of thumbnails instead of small size as the latter
  increased (change in Twitter API) and is maybe still small 
  for a mobile phone but not for a classic Amiga. 
- Additionally layout changed to view it.
- Another Twitter API change to more characters per tweet 
  but must be loaded differently.
- Map removed as Google changed API completely and now requires
  an API key. Too much work for this small feature.
- Window width can be changed again.

4.2.1
- Amiga OS 3 version is back (without ixemul)
- Linked against OpenSSL 1.0.0a and libcurl 7.46.0
- Fix in GUI viewing tweets and small OS 3 specific code changes

4.2
- Deactivated SSL certificate check as sometimes this check fails
  when sending a tweet.
- Fixed version string.
- Pointing to MorphOS preferences instead of OpenURL settings.
- Fix in button press handling if no timeline was loaded before.
  
4.1
- Twitter now requires cookie for retrieving PIN. Cookie will be only
  used for this and never saved anywhere.
- Dialog for asking username and/or password if ACCOUNT and/or PASSWORD
  is empty in the tooltypes. Dialog only displayed once for retrieving
  PIN and is usually not needed afterwards.
- Password cannot be stored anymore.
- ACCOUNT tooltype selects the default user that is loaded on startup.
  Additionally, it is now optional. If it is not set, the first user in
  list is used.
- Dialog for switching user accounts.
- Currently no update for OS 3.x as libcurl is too old for this OS.
 
4.0
- Native AmigaOS 4 version
- Fix in translating time to current time zone
- Removed HTMLView (due to too many bugs)
- Added native view for tweets
- Fix in "View Map" menu
- URLs now opened via openurl.library

3.0
- Added map view
- Added search on map
- Added caching for maps and city search
- Added menu strip 
- Fixed many memory issues related to MUI
- Fixed progress bar
- Bug fix: Sent tweets are now converted to correct character encoding
- Bug fix: Multiple links in one tweet now handled correctly
- Bug fix: Links are now correct even if tweet contains unicode characters
         
2.1
- Bug fix: last references to xml2.library removed
- Bug fix: Retweet working again.

2.0
- Partially rewritten for new twitter API 1.1
- Uses now JSON instead of XML
- HTTPS instead of HTTP  
- Native MorphOS version
         
1.49
- Bugfix in search function
- Error messages fixed
- Icons now better for plain AOS 3
- Search for user added

1.47
- Search
- Follow/unfollow
- User timeline
- Mentions
- Bugfixes in time handling
         
1.35
- Changed from libxml2 to xml2.library, no more ixemul!
- Less RAM needed
- Debug output optional 

     BUGS
     ****
     
There is an issue about the libcurl. On some systems twittAmiga can be started
from a shell only a few times until it stops showing images. If this happens,
start it from workbench or restart the shell.