sideku
The Other Side of the World
Champaign-Urbana Bus Routes
Home Projects  Resume About Me

sideku

Sideku allows you to send and receive Jaikus right through the Windows Sidebar interface. Current features include:
  • Send Jaikus to your contacts with location and icon support
  • Post to Jaiku channels
  • View up to 30 of your last Jaikus
  • Sound notifications of new Jaikus
  • Customizable auto-refresh times
This guide should give you a good idea how to use the features of the gadget and give you a general overview of how it works.

Installation

Click the latest version in the "Download Details" bubble to the right.
Choose "Open" on the File Download prompt:
Download prompt
Choose "Install" at the Windows Sidebar installation prompt:
Sidebar installation
Sideku now appears in the Windows Sidebar:
sidebar

Reading

When the gadget first runs, you will be presented with a login screen, allowing you to enter your Jaiku username and your "API Key" which you will use instead of your password to log in. It looks like this:
Login
If there is a new version of sideku available, sideku will alert you with a link to the latest version:
Update alert
Since you probably don't know your API Key off the top of your head, I've provided a link to the site on Jaiku.com that will tell you your API Key. If you are logged in, the API Key for the account that you are currently logged in as will be displayed. If you'd like to use a different account, log out and go to http://api.jaiku.com/key. If you weren't logged in to begin with, you will be prompted to log in to Jaiku when the browser opens.

OK, so now that you've got your API Key, click "Log In" and the last three Jaikus you've received should be displayed to you like this:
Main
Jaikus should be colored blue while comments are colored yellow, like this:
Comment
Use the buttons on the side to scroll up and down if the posts are cut off or use your mouse scroll wheel. If you'd like to go straight to the top of your Jaikus, click the to top button.

Writing

Now you've been reading about what's up with your friends but you'd probably like to be able to post your own thoughts too, right? Well, you can do that by clicking the "Send a Jaiku" button at the top of the gadget and you'll get something like this:

Presence Update

Flyout
Enter what you'd like to post in the top box and, if you'd like, enter the location that you're sending from or choose one of your five most recent locations then click "Send!". If you write in a new location AND choose a recent one for some reason, the new location will be the one entered in the Jaiku. The post will be sent and the flyout should close itself after it has finished sending.If you'd like to include an icon in the Jaiku, click the "+ Icon" button and select the icon you'd like. You can change this at any time or remove the icon by selecting "None." If you decide you'd rather not send a Jaiku, just click the X button and the flyout will close.

Channel post

Flyout
If you'd like to post to a channel from sideku, click the "To a Channel" tab. Enter your post and add an image just like a presence update. Then enter the name of the channel you'd like to post to in the "Channel name..." box. This can include the # before the channel name or not - whichever you prefer. Click "Send!" to post the message.

Options

To access the options menu, hover your mouse over the gadget and click on the wrench that appears in the right-hand corner underneath the 'x' to close the gadget:

Once you have opened the options menu, you will be presented with a few different choices:
sidebar
You may re-enter your username or API Key if you have made a mistake or you would like to change users. This update will be applied immediately when you click "OK".

You may enable or disable sound notifications for new Jaikus. If you enable this option, a "ding" will play every time a new Jaiku is detected.

If sounds are enabled, you may turn on the hush feature to quiet the "ding" sounds between two specified times.

You may set the refresh time between checking for new Jaikus. If you don't like being bugged every minute, you can set this value to something higher.

Finally, you can set how many Jaikus will be displayed by sideku. This number must be between 1 and 30.

Changelog

v1.5

  • Fixed bug where closing settings before log in would cause login weirdness
  • Added ability to show/hide comments in feed
  • Changed default number of Jaikus to display to 10 for better usability

v1.4

  • Added ability to post to channels
  • Revamped send jaiku window
  • Clickable user images (takes you to their homepage)
  • Added rollover link details for all links
  • Fixed problems when sending Jaikus with special characters
  • Fixed bug where gadget would not scroll down

v1.3

  • Added ability to hush sounds between certain times
  • Added "to top" button
  • Added channel that channel posts come from to details
  • Ported updates from XML to JSON - should be faster and easier for future development
  • Fixed some grammar issues

v1.2

  • Fixed a bug where Windows Vista sidebar would cache the RSS feed and sideku wouldn't be updated
  • Added icon support
  • Fixed bug where jaikus would be incorrectly classified as comments
  • Stability improvements - Less collisions with XMLHttpRequests

v1.1

  • Added notifications for new updates
  • Better explanation for what an API Key is via a rollover popup
  • Customizable number of Jaikus to display (up to 30)
  • Re-did Settings layout
  • Added character counter to send flyout
  • Added "Recent locations" feature
  • Fixed scrolling bug where if mouse cursor was inbetween Jaikus, the mouse wheel wouldn't work. Also expanded scrollable area to the entire gadget.
  • Fixed some bugs where requests would get stuck in loops
  • Error checking for sending Jaikus
  • Default refresh time set to 3 minutes instead of 1
  • Added a new loading animation to indicate when sideku is being refreshed

v1.0

Updates from beta 2:
  • Now has mouse wheel support.
  • Settings stick from session to session.
  • Tweaked interface layout
Updates from beta 1:
  • Direct links to poster's homepage and the jaiku
  • Avatar no longer overlaps details on short posts
  • Tweaked interface layout