71
edits
Changes
Jump to navigation
Jump to search
Ready for 0.3.2 release (download link broken till then)
Line 2:
Line 2:
+WiiTweet launches your Internet Channel and you get your PIN there. You have to go back to WiiTweet and select the corresponding profile to enter the PIN. Slow but useful to people with no access to an external device at the time.+ +
+
+
+
+
+
+
+= Browsing =
−WiiTweet is built around what I call a "river" which is a stack of "units" (which are either profiles, tweets or users) you can interact with. Units have a foreground and a background, to see the background of a unit place the cursor on it and hold B.
−If you want to browse to the previous river (page) you loaded press (-). Press (+) to browse to the next one.
−Another thing that could trick you a little is: when clicking on a Tweet, if you click the profile picture (the leftmost 70 pixels) you will browse to the author's timeline, if you click anywhere else the brief tweet prompt will appear.
−
| title = WiiTweet
| title = WiiTweet
| author = [[User:Aruskano|Pedro Aguiar]]
| author = [[User:Aruskano|Pedro Aguiar]]
−| version = 0.3.1
+| version = 0.3.2
−| download = http://wiitweet.googlecode.com/files/wiitweet%200.3.1.zip
+| licence = GPL
−| source = http://wiitweet.googlecode.com/files/wiitweet%200.3.1-src.zip
+| download = http://wiitweet.googlecode.com/files/wiitweet%200.3.2.zip
+| source = http://code.google.com/p/wiitweet/source/checkout
| peripherals = {{Wiimote}} {{FrontSDHC}} {{USBMSD}}
| peripherals = {{Wiimote}} {{FrontSDHC}} {{USBMSD}}
| hbb = yes
| hbb = yes
}}
}}
−WiiTweet is a Twitter client for the Nintendo Wii that allows you to interact with your friends from your Wii.
+WiiTweet is a Twitter client that allows you to interact with your friends right from your Wii.
It follows Twitter's security guidelines by implementing [http://dev.twitter.com/docs/auth/pin-based-authorization PIN-based authorization] and using HTTPS in every request. Read [[WiiTweet#Authorization_Flow|Authorization Flow]] below to get a more detailed explanation of how and why WiiTweet gets authorized by you.
It follows Twitter's security guidelines by implementing [http://dev.twitter.com/docs/auth/pin-based-authorization PIN-based authorization] and using HTTPS in every request. Read [[WiiTweet#Authorization_Flow|Authorization Flow]] below to get a more detailed explanation of how and why WiiTweet gets authorized by you.
'''IMPORTANT:''' Modified (scam) versions of this application are easy to build so I encourage you to download WiiTweet only from the link provided at this page or using the [[Homebrew Browser]].
'''IMPORTANT:''' Modified (scam) versions of this application are easy to build so I encourage you to download WiiTweet only from the link provided at this page or using the [[Homebrew Browser]].
+
+'''Note to developers:''' This page is intended to have user-level information. For developer-level information check the [http://code.google.com/p/wiitweet/ project page].
= Features =
= Features =
Line 27:
Line 30:
= Authorizing WiiTweet =
= Authorizing WiiTweet =
−WiiTweet authorizes itself using the [http://dev.twitter.com/docs/auth/pin-based-authorization PIN-based authorization] as suggested by Twitter and gives you three ways of doing so: visiting an URL using an external device, visiting an URL using the Internet Channel and providing your Twitter username/password. Read [[WiiTweet#Authorization_Flow|Authorization Flow]] below to get a more detailed explanation of how and why WiiTweet gets authorized by you.
+WiiTweet authorizes itself using, as suggested by Twitter, [http://dev.twitter.com/docs/auth/pin-based-authorization PIN-based authorization]. You do '''not''' need to provide your Twitter password to start using WiiTweet! Read [[WiiTweet#Authorization_Flow|Authorization Flow]] below to get a more detailed explanation of how and why WiiTweet gets authorized by you.
+There are three ways of authorizing this application: visiting an URL using an external device, visiting an URL using the Internet Channel and providing your Twitter username/password.
=== Using an external device ===
=== Using an external device ===
Line 33:
Line 38:
=== Using the Internet Channel ===
=== Using the Internet Channel ===
−Internet Channel is launched and you get your PIN there. You have to go back to WiiTweet and select the corresponding profile to enter the PIN. Slow but useful to people with no access to an external device at the time.
−=== Providing your username and password ===
=== Providing your username and password ===
You are asked for your Twitter username and password and WiiTweet authorizes itself. This is still PIN-based authorization but WiiTweet gets and reads the PIN automatically. '''Your password is not stored and you will not need it again to use WiiTweet'''.
You are asked for your Twitter username and password and WiiTweet authorizes itself. This is still PIN-based authorization but WiiTweet gets and reads the PIN automatically. '''Your password is not stored and you will not need it again to use WiiTweet'''.
Line 42:
Line 47:
=== Encryption ===
=== Encryption ===
−Your OAuth credentials are saved at your SD/USB. If you do not set a local password they will be stored in plain text. If you set a local password your credentials will be encrypted.
+Your OAuth credentials are saved at your SD/USB. If you do not set a local password they will be stored in plain text. If you set a local password your credentials will be encrypted.
+*These [[WiiTweet#Authorization_Flow|credentials]] do '''not''' include your Twitter password (even if you authorized WiiTweet providing your Twitter username and password).
+= Browsing Twitter =
+After logging in you will be presented with your home timeline in a screen similar to this one:
+[[File:Wt_toolbar.png|frame|center]]
+=== Toolbar ===
+You can invoke the toolbar by pointing the cursor to the upper area of the screen or pressing the home button.
+The toolbar has icons for the following actions:
+*Home: Loads your home timeline
+*Mentions: Loads tweets you are mentioned in
+*Search: Search tweets or users
+*Log out: Change profile
+*Credits: Loads WiiTweet's credits
+*Tweet: Update your status
+=== Tweet boxes ===
+Tweets are displayed within boxes. You interact with tweets by clicking on them or by holding B (which shows additional options) and clicking a corresponding button.
+[[File:Wt_tweetbox.png|frame|center]]
+If you click on a tweet box it will perform different actions deppending on where you click.
+*If you click its leftmost area (see picture below) you will load the author's timeline directly.
+*Clicking anywhere else you will display the brief tweet prompt.
+[[File:Wt_invisbuttons.png|frame|center]]
+=== User boxes ===
+Users are also displayed within boxes. You interact with users by clicking on them (which loads the user's timeline) or by holding B and clicking a corresponding button.
+[[File:Wt_userbox.png|frame|center]]
+=== Brief tweet ===
+This window is basically an user box and a tweet box in the same window, slightly different formatted. Hashtags and mentions are added as buttons at the bottom of the window.
+[[File:Wt_brieftweet.png|frame|center]]
+=== Controls ===
+{| class="wikitable" style="left;text-align:center;"
+|-
+! {{Wiimote}} !! Action
+|-
+| {{WiimoteAim}} || Cursor
+|-
+| {{WiimoteDPadUp}}/{{WiimoteDPadDown}} || Scroll
+|-
+| {{WiimoteAButton}} || Click button
+|-
+| {{WiimoteBButton}} (held) || Show the background of the pointed unit
+|-
+| {{WiimoteMinusButton}}/{{WiimotePlusButton}} || Go back/forward one page
+|-
+| {{WiimoteHomeButton}} || Show toolbar
+|-
+| {{WiimoteHomeButton}} (Brief tweet window) || Close the window
+|-
+| {{WiimoteHomeButton}} (held) || Exit to loader
+|}
−= Keyboard =
= Keyboard =
Keyboard layouts are configurable/remappable allowing you to use any character included in the font WiiTweet uses. WiiTweet comes with a keyboard map with some unicode icons to show this feature off.
Keyboard layouts are configurable/remappable allowing you to use any character included in the font WiiTweet uses. WiiTweet comes with a keyboard map with some unicode icons to show this feature off.
Line 75:
Line 129:
=== Using custom keyboard maps ===
=== Using custom keyboard maps ===
−*Keyboard map files must be placed in the '''/apps/wiitweet/kbmaps/''' folder of your loading device.
+*Keyboard map files must be placed in the '''/apps/wiitweet/kbmaps/''' folder of your loading device (SD/USB).
*The file must be named '''keyboardmapX''' where X is the position you want it to be.
*The file must be named '''keyboardmapX''' where X is the position you want it to be.
*If you place a '''keyboardmap0''' file it will overwrite the default keyboard.
*If you place a '''keyboardmap0''' file it will overwrite the default keyboard.
Line 85:
Line 139:
= Authorization Flow =
= Authorization Flow =
'''''Note:''' This is intended to be a simplified explanation of what happens during authorization.''
'''''Note:''' This is intended to be a simplified explanation of what happens during authorization.''
− ''Consider reading [http://dev.twitter.com/docs/auth/using-oauth Using OAuth] at the Twitter developers site or the [http://tools.ietf.org/html/draft-ietf-oauth-v2 OAuth 2 specification] for more technical information.''
+ ''Read [http://dev.twitter.com/docs/auth/using-oauth Using OAuth] at Twitter developers site or the [http://tools.ietf.org/html/draft-ietf-oauth-v2 OAuth 2 specification] for more technical information.''
Twitter uses OAuth to provide authorized access to its content because it does not require users to share their passwords with 3rd party applications (such as WiiTweet), increasing account security.
Twitter uses OAuth to provide authorized access to its content because it does not require users to share their passwords with 3rd party applications (such as WiiTweet), increasing account security.
−=== How OAuth works ===
+=== How OAuth/PIN-based authorization works ===
−When registering WiiTweet Twitter gave me two random, unique strings to identify it. Such strings are used as signatures. When a new user wants to authorize WiiTweet it sends a ''"Somebody wants to authorize me"'' message to Twitter and signs it, letting Twitter know WiiTweet sent the message. Twitter answers with a ''"Prove me that's true"'' message containing an URL WiiTweet must ask the user to visit.
+When I registered WiiTweet Twitter gave me two random, unique strings to identify it. Such strings are used as signatures. When a new user wants to authorize WiiTweet it sends a ''"Somebody wants to authorize me"'' message to Twitter and signs it, letting Twitter know WiiTweet sent the message. Twitter answers with a ''"Prove me that's true"'' message containing an URL WiiTweet must ask the user to visit.
Line 99:
Line 153:
=== Revoking an authorization ===
=== Revoking an authorization ===
−Changing your Twitter password will '''not''' terminate your relationship with any application you authorized using OAuth. You have to revoke the access through your account settings at Twitter's website.
+*Changing your Twitter password will '''not''' terminate your relationship with any application you authorized using OAuth.
+*You have to revoke the access through your account settings at Twitter's website.
[[Category:Homebrew using libwiigui]]
[[Category:Homebrew using libwiigui]]