* '''Launchpad Entry''': https://launchpad.net/products/ubuntu-live-chat-support/+spec/ubuntu-live-chat-support
 * '''Created''': 2006-04-07 by [[joelbryan| Joel Bryan Juliano]]
 * '''Contributors''': [[joelbryan| Joel Bryan Juliano]]
 * '''Packages affected''': gaim, perl, gtk 2.0, gnome-panel

= Summary =

The [[UbuntuLiveChatSupport]] aims to provide an interface to communicate to other ubuntu users with the same language & location, as well as to connect to the official ubuntu channel in '''freenode.net'''. It also aims to get live chat support from ubuntu users right into the desktop menu, via ''"System > Help > Live Chat Support"''. 

= Rationale =

People who don't speak english and want local support in their language will face a challenge to gain help in existing documentations, specially when there are just a few documentations for their language.
But if they speak to someone that can understand their language, they can talk to an experienced user to provide them with answers. It might as well be positive, because there might be a good chance that they will collaborate on translation of documentations and software for their language, as well as contributing to the Ubuntu work.

Another problem with the current way of getting help in Ubuntu requires the user to read and browse documentations, but what most users really want is getting the right answers to the questions straight. Browsing and reading documentations sometimes require one to research on a particular problem. But to get the right answer from an experience user is the most easiest way.

= Scope =

This will use Gaim as an IRC client, but will not alter the main Gaim configurations. It will add the IRC channels defined in InternetRelayChat in Gaim buddy list, namely, Support Channels, and Team Collaboration Channels. Localization channels defined in this page is added automatically.

= Localization =

The user's location & language will be the basis of the default channel that will be automatically joined. 

#ubuntu-<locale code> is the default channel, wherein <locale code> is based on their country. However, #ubuntu will also be added to the auto-join list.

Here are the list of the channels and their descriptions

|| Locale Code || Country || Channel Definition ||
|| AD || (Andorra) || Ubuntu Channel ||
|| AE || (United Arab Emirates) || Ubuntu Channel ||
|| AL || (Albania) || Ubuntu Channel ||
|| AM || (Armenia) || Ubuntu Channel ||
|| AR || (Argentina) || Ubuntu Channel ||
|| AT || (Austria) || Ubuntu Channel ||
|| AU || (Australia) || Ubuntu Channel ||
|| AZ || (Azerbaijan) || Ubuntu Channel ||
|| BA || (Bosnia) || Ubuntu Channel ||
|| BD || (Bangladesh) || Ubuntu Channel ||
|| BE || (Belgium) || Ubuntu Channel ||
|| BG || (Bulgaria) || Ubuntu Channel ||
|| BH || (Bahrain) || Ubuntu Channel ||
|| BO || (Bolivia) || Ubuntu Channel ||
|| BR || (Brazil) || Ubuntu Channel ||
|| BT || (Bhutan) || Ubuntu Channel ||
|| BW || (Botswana) || Ubuntu Channel ||
|| BY || (Belarus) || Ubuntu Channel ||
|| CA || (Canada) || Ubuntu Channel ||
|| CH || (Switzerland) || Ubuntu Channel ||
|| CL || (Chile) || Ubuntu Channel ||
|| CN || (China) || Ubuntu Channel ||
|| CO || (Colombia) || Ubuntu Channel ||
|| CR || (Costa Rica) || Ubuntu Channel ||
|| CS || (Serbia and Montenegro) || Ubuntu Channel ||
|| CY || (Cyprus) || Ubuntu Channel ||
|| CZ || (Czech) || Ubuntu Channel ||
|| DE || (Germany) || Ubuntu Channel ||
|| DJ || (Djibouti) || Ubuntu Channel ||
|| DK || (Denmark) || Ubuntu Channel ||
|| DO || (Dominican Republic) || Ubuntu Channel ||
|| DZ || (Algeria) || Ubuntu Channel ||
|| EC || (Ecuador) || Ubuntu Channel ||
|| EE || (Estonia) || Ubuntu Channel ||
|| EG || (Egypt) || Ubuntu Channel ||
|| ER || (Eritrea) || Ubuntu Channel ||
|| ES || (Spain) || Ubuntu Channel ||
|| ET || (Ethiopia) || Ubuntu Channel ||
|| FI || (Finland) || Ubuntu Channel ||
|| FO || (Faroe Islands) || Ubuntu Channel ||
|| FR || (France) || Ubuntu Channel ||
|| GB || (Great Britain) || Ubuntu Channel ||
|| GE || (Georgia) || Ubuntu Channel ||
|| GL || (Greenland) || Ubuntu Channel ||
|| GR || (Greece) || Ubuntu Channel ||
|| GT || (Guatemala) || Ubuntu Channel ||
|| HK || (Hong Kong) || Ubuntu Channel ||
|| HN || (Honduras) || Ubuntu Channel ||
|| HR || (Croatia) || Ubuntu Channel ||
|| HU || (Hungary) || Ubuntu Channel ||
|| ID || (Indonesia) || Ubuntu Channel ||
|| IE || (Ireland) || Ubuntu Channel ||
|| IL || (Israel) || Ubuntu Channel ||
|| IN || (India) || Ubuntu Channel ||
|| IQ || (Iraq) || Ubuntu Channel ||
|| IR || (Iran) || Ubuntu Channel ||
|| IS || (Iceland) || Ubuntu Channel ||
|| IT || (Italy) || Ubuntu Channel ||
|| JO || (Jordan) || Ubuntu Channel ||
|| JP || (Japan) || Ubuntu Channel ||
|| KE || (Kenya) || Ubuntu Channel ||
|| KG || (Kyrgyzstan) || Ubuntu Channel ||
|| KH || (Cambodia) || Ubuntu Channel ||
|| KR || (South Korea) || Ubuntu Channel ||
|| KW || (Kuwait) || Ubuntu Channel ||
|| KZ || (Kazakhstan) || Ubuntu Channel ||
|| LA || (Laos) || Ubuntu Channel ||
|| LB || (Lebanon) || Ubuntu Channel ||
|| LK || (Sri Lanka) || Ubuntu Channel ||
|| LT || (Lithuania) || Ubuntu Channel ||
|| LU || (Luxemburg) || Ubuntu Channel ||
|| LV || (Latvia) || Ubuntu Channel ||
|| LY || (Libya) || Ubuntu Channel ||
|| MA || (Morocco) || Ubuntu Channel ||
|| MG || (Madagascar) || Ubuntu Channel ||
|| MK || (Macedonia) || Ubuntu Channel ||
|| MN || (Mongolia) || Ubuntu Channel ||
|| MT || (Malta) || Ubuntu Channel ||
|| MX || (Mexico) || Ubuntu Channel ||
|| MY || (Malaysia) || Ubuntu Channel ||
|| NI || (Nicaragua) || Ubuntu Channel ||
|| NL || (Netherlands) || Ubuntu Channel ||
|| NO || (Norway) || Ubuntu Channel ||
|| NP || (Nepal) || Ubuntu Channel ||
|| NZ || (New Zealand) || Ubuntu Channel ||
|| OM || (Oman) || Ubuntu Channel ||
|| PA || (Panama) || Ubuntu Channel ||
|| PE || (Peru) || Ubuntu Channel ||
|| PH || (Philippines) || Ubuntu Channel ||
|| PK || (Pakistan) || Ubuntu Channel ||
|| PL || (Poland) || Ubuntu Channel ||
|| PR || (Puerto Rico) || Ubuntu Channel ||
|| PT || (Portugal) || Ubuntu Channel ||
|| PY || (Paraguay) || Ubuntu Channel ||
|| QA || (Qatar) || Ubuntu Channel ||
|| RO || (Romania) || Ubuntu Channel ||
|| RU || (Russia) || Ubuntu Channel ||
|| RW || (Rwanda) || Ubuntu Channel ||
|| SA || (Saudi Arabia) || Ubuntu Channel ||
|| SD || (Sudan) || Ubuntu Channel ||
|| SE || (Sweden) || Ubuntu Channel ||
|| SG || (Singapore) || Ubuntu Channel ||
|| SI || (Slovenia) || Ubuntu Channel ||
|| SK || (Slovak) || Ubuntu Channel ||
|| SN || (Senegal) || Ubuntu Channel ||
|| SO || (Somalia) || Ubuntu Channel ||
|| SV || (El Salvador) || Ubuntu Channel ||
|| SY || (Syrian Arab Republic) || Ubuntu Channel ||
|| TH || (Thailand) || Ubuntu Channel ||
|| TJ || (Tajikistan) || Ubuntu Channel ||
|| TN || (Tunisia) || Ubuntu Channel ||
|| TR || (Turkey) || Ubuntu Channel ||
|| TW || (Taiwan) || Ubuntu Channel ||
|| UA || (Ukraine) || Ubuntu Channel ||
|| UG || (Uganda) || Ubuntu Channel ||
|| US || (United States of America) || Ubuntu Channel ||
|| UY || (Uruguay) || Ubuntu Channel ||
|| UZ || (Uzbekistan) || Ubuntu Channel ||
|| VE || (Venezuela) || Ubuntu Channel ||
|| VN || (Vietnam) || Ubuntu Channel ||
|| XX || (Peace) || Ubuntu Channel ||
|| YE || (Yemen) || Ubuntu Channel ||
|| YU || (Yugoslavia) || Ubuntu Channel ||
|| ZA || (South Africa) || Ubuntu Channel ||
|| ZW || (Zimbabwe) || Ubuntu Channel ||

The format that will appear to the buddy list would be like this:

Philippines Ubuntu Channel

All of the above localized channels would be added in gaim's buddy list, under '''Local Channels'''.

= Language =

|| Language Code || Language Name || Channel Description ||
|| aa  || (Afar) || Speaking Ubuntu Channel ||
|| af  || (Afrikaans) || Speaking Ubuntu Channel ||
|| am  || (Amharic) || Speaking Ubuntu Channel ||
|| an  || (Aragonese) || Speaking Ubuntu Channel ||
|| ar  || (Arabic) || Speaking Ubuntu Channel ||
|| ast || (Asturian) || Speaking Ubuntu Channel ||
|| az  || (Azeri) || Speaking Ubuntu Channel ||
|| be  || (Belarusian) || Speaking Ubuntu Channel ||
|| bg  || (Bulgarian) || Speaking Ubuntu Channel ||
|| bn  || (Bengali) || Speaking Ubuntu Channel ||
|| br  || (Breton) || Speaking Ubuntu Channel ||
|| bs  || (Bosnian) || Speaking Ubuntu Channel ||
|| byn || (Blin) || Speaking Ubuntu Channel ||
|| ca  || (Catalan) || Speaking Ubuntu Channel ||
|| csb || (Kashubian) || Speaking Ubuntu Channel ||
|| cs  || (Czech) || Speaking Ubuntu Channel ||
|| cy  || (Welsh) || Speaking Ubuntu Channel ||
|| da  || (Danish) || Speaking Ubuntu Channel ||
|| de  || (German) || Speaking Ubuntu Channel ||
|| dz  || (Dzongkha) || Speaking Ubuntu Channel ||
|| el  || (Greek) || Speaking Ubuntu Channel ||
|| en  || (English) || Speaking Ubuntu Channel ||
|| eo  || (Esperanto) || Speaking Ubuntu Channel ||
|| es  || (Spanish) || Speaking Ubuntu Channel ||
|| et  || (Estonian) || Speaking Ubuntu Channel ||
|| eu  || (Basque) || Speaking Ubuntu Channel ||
|| fa  || (Persian) || Speaking Ubuntu Channel ||
|| fi  || (Finnish) || Speaking Ubuntu Channel ||
|| fo  || (Faroese) || Speaking Ubuntu Channel ||
|| fr  || (French) || Speaking Ubuntu Channel ||
|| fur || (Furlan) || Speaking Ubuntu Channel ||
|| fy  || (Frisian) || Speaking Ubuntu Channel ||
|| ga  || (Irish) || Speaking Ubuntu Channel ||
|| gd  || (Gaelic) || Speaking Ubuntu Channel ||
|| gez || (Geez) || Speaking Ubuntu Channel ||
|| gl  || (Galician) || Speaking Ubuntu Channel ||
|| gu  || (Gurajati) || Speaking Ubuntu Channel ||
|| gv  || (Gaelic) || Speaking Ubuntu Channel ||
|| he  || (Hebrew) || Speaking Ubuntu Channel ||
|| hi  || (Hindi) || Speaking Ubuntu Channel ||
|| hr  || (Croatian) || Speaking Ubuntu Channel ||
|| hsb || (Sorbian) || Speaking Ubuntu Channel ||
|| hu  || (Hungarian) || Speaking Ubuntu Channel ||
|| hy  || (Armenian) || Speaking Ubuntu Channel ||
|| id  || (Indonesian) || Speaking Ubuntu Channel ||
|| ik  || (Inupiaq) || Speaking Ubuntu Channel ||
|| is  || (Icelandic) || Speaking Ubuntu Channel ||
|| it  || (Italian) || Speaking Ubuntu Channel ||
|| iu  || (Inuktitut) || Speaking Ubuntu Channel ||
|| iw  || (Hebrew) || Speaking Ubuntu Channel ||
|| ja  || (Japanese) || Speaking Ubuntu Channel ||
|| ka  || (Georgian) || Speaking Ubuntu Channel ||
|| kk  || (Kazakh) || Speaking Ubuntu Channel ||
|| kl  || (Greenlandic) || Speaking Ubuntu Channel ||
|| km  || (Khmer) || Speaking Ubuntu Channel ||
|| kn  || (Kannada) || Speaking Ubuntu Channel ||
|| ko  || (Korean) || Speaking Ubuntu Channel ||
|| ku  || (Kurdish) || Speaking Ubuntu Channel ||
|| kw  || (Cornish) || Speaking Ubuntu Channel ||
|| ky  || (Kyrgyz) || Speaking Ubuntu Channel ||
|| lg  || (Luganda) || Speaking Ubuntu Channel ||
|| li  || (Limburgish) || Speaking Ubuntu Channel ||
|| lo  || (Lao) || Speaking Ubuntu Channel ||
|| lt  || (Lithuanian) || Speaking Ubuntu Channel ||
|| lv  || (Latvian) || Speaking Ubuntu Channel ||
|| mg  || (Malagasy) || Speaking Ubuntu Channel ||
|| mi  || (Maori) || Speaking Ubuntu Channel ||
|| mk  || (Macedonian) || Speaking Ubuntu Channel ||
|| ml  || (Malayalam) || Speaking Ubuntu Channel ||
|| mn  || (Mongolian) || Speaking Ubuntu Channel ||
|| mr  || (Marathi) || Speaking Ubuntu Channel ||
|| ms  || (Malay) || Speaking Ubuntu Channel ||
|| mt  || (Maltese) || Speaking Ubuntu Channel ||
|| nb  || (Norwegian) || Speaking Ubuntu Channel ||
|| nds || (Neddersassisch) || Speaking Ubuntu Channel ||
|| ne  || (Nepali) || Speaking Ubuntu Channel ||
|| nl  || (Dutch) || Speaking Ubuntu Channel ||
|| nn  || (Nynorsk) || Speaking Ubuntu Channel ||
|| no  || (Norwegian) || Speaking Ubuntu Channel ||
|| nr  || (Ndebele) || Speaking Ubuntu Channel ||
|| nso || (Sotho) || Speaking Ubuntu Channel ||
|| oc  || (Occitan) || Speaking Ubuntu Channel ||
|| om  || (Oromo) || Speaking Ubuntu Channel ||
|| pa  || (Punjabi) || Speaking Ubuntu Channel ||
|| ph  || (Filipino) || Speaking Ubuntu Channel ||
|| pl  || (Polish) || Speaking Ubuntu Channel ||
|| pt  || (Portuguese) || Speaking Ubuntu Channel ||
|| ro  || (Romanian) || Speaking Ubuntu Channel ||
|| ru  || (Russian) || Speaking Ubuntu Channel ||
|| rw  || (Kinyarwanda) || Speaking Ubuntu Channel ||
|| sa  || (Sanskrit) || Speaking Ubuntu Channel ||
|| sc  || (Sardinian) || Speaking Ubuntu Channel ||
|| se  || (Saami) || Speaking Ubuntu Channel ||
|| sid || (Sidama) || Speaking Ubuntu Channel ||
|| si  || (Sinhala) || Speaking Ubuntu Channel ||
|| sk  || (Slovak) || Speaking Ubuntu Channel ||
|| sl  || (Slovenian) || Speaking Ubuntu Channel ||
|| so  || (Somali) || Speaking Ubuntu Channel ||
|| sq  || (Albanian) || Speaking Ubuntu Channel ||
|| sr  || (Serbian) || Speaking Ubuntu Channel ||
|| ss  || (Swati) || Speaking Ubuntu Channel ||
|| st  || (Sotho) || Speaking Ubuntu Channel ||
|| sv  || (Swedish) || Speaking Ubuntu Channel ||
|| ta  || (Tamil) || Speaking Ubuntu Channel ||
|| tg  || (Tajik) || Speaking Ubuntu Channel ||
|| th  || (Thai) || Speaking Ubuntu Channel ||
|| tig || (Tigre) || Speaking Ubuntu Channel ||
|| ti  || (Tigrigna) || Speaking Ubuntu Channel ||
|| tl  || (Tagalog) || Speaking Ubuntu Channel ||
|| tn  || (Tswana) || Speaking Ubuntu Channel ||
|| tr  || (Turkish) || Speaking Ubuntu Channel ||
|| ts  || (Tsonga) || Speaking Ubuntu Channel ||
|| tt  || (Tatar) || Speaking Ubuntu Channel ||
|| uk  || (Ukrainian) || Speaking Ubuntu Channel ||
|| ur  || (Urdu) || Speaking Ubuntu Channel ||
|| uz  || (Uzbek) || Speaking Ubuntu Channel ||
|| ve  || (Venda) || Speaking Ubuntu Channel ||
|| vi  || (Vietnamese) || Speaking Ubuntu Channel ||
|| wal || (Walaita) || Speaking Ubuntu Channel ||
|| wa  || (Walloon) || Speaking Ubuntu Channel ||
|| wo  || (Wolof) || Speaking Ubuntu Channel ||
|| xh  || (Xhosa) || Speaking Ubuntu Channel ||
|| yi  || (Yiddish) || Speaking Ubuntu Channel ||
|| zh  || (Chinese) || Speaking Ubuntu Channel ||
|| zu  || (Zulu) || Speaking Ubuntu Channel ||

##('''update:''' These channels are included in 0.3.14, under '''Local Ubuntu Channels''', replacing the localized channels in InternetRelayChat.)

All of the above languages channel would be added in gaim's buddy list, under '''Local Language Channels'''.

= Default Channels =

##('''update:''' In version 0.3.14)

Gaim's buddy-list will include a group called "Default", and will be based on the user's language and location. It will contain #ubuntu, #ubuntu-<locale>, and #ubuntu-<language name>

= Design =

== Invocation and overall design ==

The software will be linked right into "System > Help > Live Chat Support" menu, and will have the stock people icon. It will have an intro screen, a freenode.org login screen, a register button. By registering to freenode.org, an information will be displayed about the advantages of registering their nick, and guides you to registration process. It automates the registration based on the information provided. It also includes nick availability option to check if the nick is available, or currently using it.

##('''update:''' Version 0.3.14 have automatic registration system, that automates the registration based on the information provided. It also includes nick availability option to check if the nick is available, or currently using it.)

== Registration System ==

By registering, the user will have alot of advantages, user will have a nick that he/she can use over and over again. People will also know the user by reputation, and how the user communicates to other user. Registered users can also send private messages to other registered users.

=== Basic and Personal Information ===

Basic information are the required information by Freenode.  All personal information is handled by NickServ including optional informations.

Optional information are non required information by Freenode. Users can personalize them.

==== Basic Information ====
 * Nick/Username
 * Password
 * E-Mail Address

==== Optional Information ====
 * Website/URL
 * Phone Number
 * GSM/SMS Cellular Phone Number

===== Recommended Website/URL Format =====
Need to include http://

example: http://www.example.com

===== Recommended Phone Number Format =====
International Phone Format

 * +xxx-(yyy)-zzz-zzzz

Where: 
       * xxx      = Country Code
       * yyy      = Area or City Code
       * zzz-zzzz = Local Number

example: +1-(800)-123-4567

===== Recommended GSM/SMS Cellular Phone Number Format =====
International GSM/SMS Phone Number Format

 * +8812345678

Where: 
       * 88       = Country Code
       * 12345678 = Cellphone number without leading 0

== Desktop Integration ==

Nautilus integration and Evolution mail integration is enabled by default. This would be easy to send files to a user in IRC.

== Profile Handling ==

Preferences and Buddy List will be saved for a particular Nick. Every nick will create a seperate profile for the current session. The seperate profile will be configurable and be used over and over again.

= Screenshots =

== Menu ==

{{attachment:ubuntu-live-chat-support-menu.0.3.14.png}}

The software aims to be launched via '''System > Help > Live Chat Support'''

== Introduction Screen ==

{{attachment:ubuntu-live-chat-support-intro-0.3.14.png}}

The intro screen will tell the users about the process, and provide a brief introduction about the software.

##('''update:''' Slight changes in the layout. The borders in 0.3.14 is hidden making it more slick and professional looking app.)

##(Also a "About" button is included in the main screen.)

== Login screen ==

The login screen will ask about their freenode.org username and password. However, if they are not yet registered, they will be prompted to click the "Register" button.

=== Registered user handling ===

Login screen have a disabled button if no password is given, this ensures logging of registered nick. However, non-registered user can still login, by clicking the "Use unregistered login" checkbox.

{{attachment:ubuntu-live-chat-support-login-registered-0.3.14.png}}

It will also auto set the nick based on the user's account, for example, if ''Foo Roberts'' uses "fooroberts" as an account to login to his computer, then "fooroberts" will be set as a nick in Ubuntu Live Chat Support. 

If he register the nick "xroberts" using the wizard, then "xroberts" would be automatically set in the login dialog. His new registered nick will be set everytime he uses Ubuntu Live Chat Support.

=== Non-Registered user handling ===

By clicking the "Use unregistered login" checkbox, a user's nick will 
have a "guest_" prefix. for example, ''foo'' would be ''guest_foo''.

{{attachment:ubuntu-live-chat-support-login-unregistered-0.3.14.png}}

When the user click the checkbox, the password field would be disabled, and the "Connect" button would be enabled.

=== Settings ===

Users can choose different layout by clicking the settings button.

{{attachment:ubuntu-live-support-0.3.14-7-settings.png}}

The "Default Layout" is the default gaim layout, where the channels is on top tab, and channel aliases is turned on.

The "Alternative Layout" is the xchat-alike layout, where the channels is on left tab, and channel aliases is turned off.

== Registration ==

##('''update:''' No one want's to cut-and-paste codes and send them in the Freenode using Gaim, it was too lame. Now by popular demand, 0.3.14 "All you need is Love" have automated Freenode registration system. Awesome! and neat!)

=== Intro screen about advantages on registering a nick. ===

The intro screen will tell the user about the advantages of registering their nick. The intro screen is targetted for Ubuntu users getting technical support in his/her computer in Freenode.

{{attachment:ubuntu-live-chat-support-register-intro-0.3.14.png}}

##('''update:''' 0.3.14 now has it's own words about why it's good to register to Freenode, not taken from Freenode FAQ.)

=== Checking nick's availability. ===

In the first step of registration, a user can check the nick's availability by clicking the "Check Availability" button. The nick entered here will be used for the final step of registration.

{{attachment:ubuntu-live-chat-support-register-check-0.3.14.png}}

##('''update:''' You have your most desired nick, and just found out that it was registered to someone else. Well, say no more, you can check your precious nick's availability by the "Check Availability" button. Now you won't cry again if your beautiful nick "kalamantutay" has been taken.)

=== Sending Registration ===

The nick that will be sent to freenode will be defined by the previous step. If a user's nick is taken, it will tell the user to choose another nick, and be able to check it's availability again, until a unavailable nick is found. This step will ask the user's basic information as well as the optional information. The password & confirm password should be identical to send the registration. A warning feedback will appear when the passwords are not identical.

{{attachment:ubuntu-live-support-0.3.14-7-register.png}}

=== Privacy ===

User can set their information private when they unclick the "Share my personal information to other users" checkbox.

##('''update:''' Now you have your precious nick not taken, it's time to personalize it and send them to freenode, but make sure your password and confirm password is identical before you can send them.)

=== Fail-Proof Registration System ===

When a failure occurs by either a system shutdown or when the user cancel's the registration process, the software will cleanup an incomplete registration in Freenode, and restarts the registration process again. 

=== Logging your registered nick ===

Once the registration is successful, the user will be redirected to the login menu, and the user's chosen nick will be set in the username field. The user can now enter a password to connect to the ubuntu support channels.

{{attachment:ubuntu-live-chat-support-register-login2-0.3.14.png}}

##('''update:''' Whew!, just finished the painstakingly difficult process of registration to freenode via the two-step wizard, now, it's time to reap your reward and gain +1 reputation points. Summon your precious nick, and explore the Freenode wilderness.)

== Buddy List and Chat Screen ==

New users, registered users and unregistered users will have 5 predefined groups in their gaim buddy list. These includes the localized ubuntu channels, the team support groups, support and help channels, and auto-join default channels.

{{attachment:ubuntu-live-support-0.3.14-7-buddylist.png}}

##('''update:''' Too bad you can't understand anything they are saying? It's like talking to someone saying "achutaaa.. parakumbes, paramuna... chirochirobobo" man what does that mean?, well, now you have an intergalactic translators in 0.3.14. Based on your galaxy, it will automatically join you to their hang-out place. Now chill out a little in your localized ''Kashyyyk'' lounge.)

The user will be automatically join to a particular #ubuntu-<locale code> channel, the #ubuntu channel, and #ubuntu-<language name>

##(Also you will be joined to #ubuntu channel, the Official Ubuntu Help Support channel. Your buddy list will also contain those channels under the "Local Ubuntu Channels" as well as the channels defined in InternetRelayChat, now, that's better than your CNN and AXN channel, err, just kidding...)

##(== About Screen ==)

##(The about dialog screen can be accessed by clicking the "About" button in the first screen.)

##(attachment:ubuntu-live-chat-support-about-0.3.14.png)

##('''update:''' What am I thinking? not including About in 0.3.14 is like suicide for this very polished release, with all the hardwork, pain, suffering, dad just walk 30 miles to get to school, err, anyways, my conscience tell me I should include an About button. This bring a very tremendous advantage in the software itself, because now you can answer your most mysterious question ''Who is that freakin' guy who made Ubuntu live Chat Support?'', well my friend, your not alone, the answer is right in there, thanks to the About button. Just click it and you will find the most ultimate answer to your question. Yes... the truth will set your free.)

##(== License Screen ==)

##(The license and/or credits dialog screen can be accessed in the "Credits" and "License" buttons in the About dialog screen.)

##(attachment:ubuntu-live-chat-support-about-license-0.3.14.png)

##('''update:''' Free Software would not be possible without the GNU License, because of that, I'm very thankful about Linux, Ubuntu, GNOME, and ultimately /usr/bin/fortune. To return the favor, I have the GPL 2 license screen to give credit to open source.)

== Old Screenshots ==

Old screenshots is available below.

See [[UbuntuLiveChatSupport/Versions/PreviousRelease| PreviousRelease]]

= Code =

The code is written in GTK+ 2.0, C and perl, with sh scripts as scripting backend.

= Patch =

[[attachment:09_help_submenu.patch]]

This patch for gnome-panel will enable the '''System > Help > Live Chat Support''' organization.

= Source Package =

[[attachment:ubuntu-live-support-0.3.14-7.tar.gz]]

Add GUI improvements in registration. 
Change the buddylist group labels.
Add a auto-join channel by user's language.
Impliment registration privacy.
Add settings to change different gaim layouts.

[[attachment:ubuntu-live-support-0.3.14-5.tar.gz]]

Improved release, alot of PID handling fixes, break everything into smaller pieces and make it more modular. And got new implimentations from the recent discussions with lilo, and agreed that a delay should be implimented. It now has a enforced registration delay by Freenode to avoid abuse of Freenode services. Another is, the change of gaim's interface to be xchat-alike.

[[attachment:ubuntu-live-support-0.3.14.tar.gz]]

Third release, version 0.3.14 contains alot of improvements over the older versions. It has, an automated registration system, better GUI improvements, and more...

[[attachment:ubuntu-live-chat-support-0.2.tar.gz]]

The second release, contains lot's of improvements, like
seperate account by nick profile handling, localization. Pretty much works perfectly.

[[attachment:ubuntu-live-chat-support.tar.gz]]

This is the first release of the software, but it's quite stable. 

= Binary Package =

[[attachment:ubuntu-live-support_0.3.14-7_i386.deb]] (stable)

  * Change the name "Auto-Join Default" to "Default"
  * Overhaul the Local Channel names
  * A new channel will be autojoined based on language.
  * Added the language to "Local Languages" group
  * Change the name of "Local Ubuntu Channels" to "Local Channels"
  * UI improvements, in Nick registration, add a "Passwords do not
    match" warning.
  * Impliment a settings in login page to choose from 2 different
    layout, the default top channels tab and alternative left channels
    tab. The static xchat-gnome look is removed.
  * Add a new checkbox for privacy, when registration.
  * Impliment registration privacy when the checkbox is toggled.

[[attachment:ubuntu-live-support_0.3.14-6_i386.deb]] (stable),

  * Impliment fail-proof registration, that autoclean incomplete and failed registration attempts due to system crash or when the user press cancel while registering.

  * Automatically set the nickname entry, to the registered nick.

[[attachment:ubuntu-live-support_0.3.14-5_i386.deb]] (stable),   

  * Overhauled the Process ID handling, now it's killall free!
  * Change the desktop entry to Applications;GTK;Core;
  * Change the way parts of the software is called, now uses modular approach on all things.
  * Impliment xchat-style in gaim interface.

[[attachment:ubuntu-live-support_0.3.14-4_i386.deb]], this solves the issues regarding nick registration. It now use a true nick checking capability, for online or offline nicks. Security imposed time by Freenode.net is added to nick registration to intimidate spammers and abusers. 

  * Due to security imposed delays for freenode registration, because of abusive bots, delays are now used in nick registration.

  * Delay time can change dynamically, this release fixes by capturing the exact delay time and add 20 more seconds if the machine is busy and doing multitasking jobs. The constant 200 seconds is removed.

[[attachment:ubuntu-live-support_0.3.14-1_i386.deb]]

= GNOME Panel Binary Package =

[[attachment:gnome-panel_2.14.1-0ubuntu8_i386.deb]]

This is the prepatched version of the gnome-panel that enables the menu organization.

= Installation =

For compiling the source, you need build-essentials, gtk+2.0-dev, autotools-dev, perl, and perl standard modules.

For installing the binary, please see dpkg, apt informations for instructions on installing deb packages.

----
CategorySpec

= Comments =

odla:  looks real nice.  nice gnome integration and i like the use of gaim since it's a Ubuntu default.  the auto-registration is real nice and will make it real easy for folks new to Ubuntu and irc to get on freenode and navigating around.  i also like being dumped into a channel with folks from a similar geographic region.  

glatzor: gaim seems to be quite uncomfortable for irc actions. I think that writing a small irc client around python-irc would be a cleaner solution.

GuillaumeDesmottes : Why not use xchat-gnome? He's very easy to use, have a clean interface and good GNOME integration. IMHO, gaim is really not a good tool for irc chat.
I wrote a [[http://bigon.be/cassidy/blog/index.php?2006/04/29/55-irc-chat-on-ubuntu-dapper|post on my blog]] about why xchat-gnome is a better choice than gaim IMHO.

I don't think #ubuntu-<country code> is the right way to go for localisation.  For example, #ubuntu-be is not a support channel; support for Dutch, French & German speaking people in Belgium is in #ubuntu-nl, #ubuntu-fr & #ubuntu-de respectively, while the Belgian channel is for the coordination of Ubuntu-related activities in Belgium.  --JanClaeys

The same goes for Switzerland. The support channels should be organized by language, not nationality nor location. --TormodVolden

JeromeGotangco: We don't have a graphical IRC client on the default install with the exception of GAIM, hence the specification. There is also irssi, but that is terminal-driven. +1 with JanClaeys on the country code issue. We could still consider the country code, but perhaps for locoteam concerns rather than support? Some of the codes are not even active, so might as well trim it, for exaple, -kr doesn't exist for korea - its actually -ko :)

[[joelbryan| joelbryan:]] I talked to [[DennisKaarsemaker| Seveas]] regarding the channel localization. He made a very good progress with the problems about the local ubuntu channels in freenode. For example, -mx doesn't exist because someone register it, so people just join #ubuntumexico instead, Seveas reclaim -mx and advised them to use #ubuntu-mx officially for ubuntu mexico.

RicardoPérezLópez: The country code works well with Spain and its Spanish #ubuntu-es :)

I think the best way to do l10n would be to have a gettext "translateable" string that contains one or more channels to show (e.g. CSV-formatted or something similar).  That way local teams can decide for themselves how to organize their channels...  --JanClaeys

RunarIngebrigtsen: This is excellent. What about the OEM situation? When we roll out desktops and sell support it'd be nice to auto-add our own (paid) support channels like IRC, Jabber and SIP for both Gaim and Ekiga. It seems to me this would be the right tool for such.

I made another app, and is available in [[UbuntuCommercialSupport]] for paid support in Canonical Ltd. For auto-add OEM local support, I would like to know the channels that has those services. - [[joelbryan]]

I've never used xchat so I think gaim is more than enough to ask for help - maybe not for entering commands, but I don't think that's what the people who will use livesupport will want anyway. To sum up, I think gaim is a good option.

I think, however, that livesupport should be aware when a gaim session is already open and use it instead of opening a new one. And all the information -the account, the channel list- should be automatically added to gaim. I don't think it makes any sense to have 2 gaim sessions at the same time. Livesupport should also respect the window size and layout the user has chosen for his chat windows. If I like tabs under the window, why must I have them on the left?

Additionally, I've asked the people on the spanish channel for their opinion and some of them have told me that it's not a support channel and that they are concerned that people will enter the channel without even taking a look at the guide, expecting to get a satifactory answer as soon as they ask and some might even complain if they don't get it.

Therefore, I think some kind of disclaimer at the end of the registration dialog would be convenient. Something like, please understand that this is not a support channel. You're going to talk to users just like you who might or might not help you. If you have a general doubt please try a look at the desktop guide first (with an actual link to the guide) and if you don't find the information you need then come in and ask yous question clear and politely. Be welcome.

With a 5 or 10 second countdown so people have to read it. What do you think?

RobertStoffers - In accordance with Freenode policy Ubuntu "owns" the #ubuntu* namespace, so any channel registered by anyone else in this namespace can be transferred to the Ubuntu project on request (by [[DennisKaarsemaker| Seveas]] or any other listed contact). Also, channel forwarding can be set up, so in the example -ko and -kr above, #ubuntu-kr can be forwarded to #ubuntu-ko or vice-versa. I'm rather intrested in this project, both as a Ubuntu member and a Freenode staff member, so please let me know if there is any thing you need in regards to Freenode and I'll be happy to help you out (my nick is "rob"). 

DaxSolomonUmaming - Progress? Will this be nominated for Gutsy? Maybe Hardy. Is there a blueprint for this? This is very useful for everyone, especially newbies. 

[[joelbryan| Joel Bryan Juliano]] - This project had been nominated eversince Dapper (by Mark himself), and it needs more love. I currently shift my focus on an school work, a Linux distribution based on Ubuntu called "AMA Desktop 2007" where I had put the idea of instant support in the desktop (since currently it doesnt have any documentations). The next step is to be less primitive and brutal, use more C/Python and less bash :)