jabber_on_sdf []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Jabber on SDF =====

Jabber is the former name for the Extensible Messaging and Presence Protocol (XMPP), which is a set of open XML [[http://xmpp.org/tech/ |technologies]] for presence and real-time communication developed by the [[http://xmpp.org/about/jabber.shtml |Jabber]] open-source community in 1999, formalized by the [[http://www.ietf.org |IETF]] in 2002-2004, continuously extended through the standards process of the [[http://xmpp.org/xsf |XMPP Standards Foundation]], and implemented in a wide variety of [[http://xmpp.org/software |software]], devices, and Internet services. Jabber service on SDF is run on [[http://www.process-one.net/en/ejabberd |ejabberd]].

Jabber is popularly used as a decentralized instant messaging service. This means that you can create an account on one server such as SDF and talk to users from any other Jabber service. It is also possible to use a transport to communicate with users on other types of instant messaging services as well.

===== Connecting to SDF's Jabber Server =====

=== Account Registration ====

In contrast with other Jabber servers, accounts in SDF's Jabber server are created from the shell with the ‘maint’ utility. This is not needed if you are going to connect to a different Jabber/XMMP server besides SDF's Jabber server.

=== How to create a Jabber Account===

  - Log in to the password server by running the **maint** program.
  - Type **o** to select optional features and social networking
  - Type **j** to set your Jabber password.
  - Quit from maint utility and wait one minute.

After one minute you will be able to connect to SDF's Jabber server using your prefered Jabber client. **Your jabber id (//jid//) is your SDF username with ''@jabber.sdf.org'' at the end**

=== Connection Settings for SDF Jabber ===

Once you have activated your SDF jabber account, you should choose a Jabber client (see below), and when you run it, use the following settings:
  * Server: **jabber.sdf.org**
  * Port: **5222**
  * SSL: **enabled**

SDF's Jabber server uses a self-signed SSL certificate, so you will see a warning about this. It is safe to accept this certificate.

===== Jabber Clients =====

Available on SDF cluster and on Metaarray:

  * [[https://profanity-im.github.io/userguide.html |profanity (link to Quickstart guide)]] (Unix shell). Using ''profanity'' is described below.
  * [[http://lilotux.net/~mikael/mcabber/files/mcabber.1.html |mcabber]] (Unix shell). Using ''mcabber'' is described below.
    * To get ''mcabber'' working, copy this [[http://lilotux.net/~mikael/mcabber/files/mcabberrc.example |example config file]] to your home folder as ''.mcabberrc'' and edit the configuration file. You need to set your ''jid'' and possibly ''username'' and ''server''

Others:

  * iChat (Mac OS X)
  * [[http://pidgin.im |Pidgin]] (Unix/Windows)
  * [[http://adium.im |Adium]] (Mac OS X)
  * [[http://www.bitlbee.org |Bitlbee]]
  * [[https://www.xabber.com/ |xabber]] (Android)
  * [[https://yaxim.org/ |YAXIM]] (Android)
  * [[https://www.thunderbird.net |Thunderbird]] (multi-platform)

Recommended clients for mobile can be found [[mobile_applications_on_sdf |here]]

==== Connecting with Profanity from SDF Unix shell ====

Profanity is “a console based XMPP client.. inspired by irssi”. Its UI is based on virtual windows/tabs, each which has the following sections:
  * title bar
  * main window
  * status bar
  * input area
  * additionally, chat rooms have a roster

To start, enter at shell: ''profanity''

It will start like so:
  Profanity. Type /help for help information.                                                          [offline]
  01:31:11 - Welcome to                                                                                           
  01:31:11 -                   ___            _                                                                   
  01:31:11 -                  / __)          (_)_                                                                 
  01:31:11 -  ____   ___ ___ | |__ ____ ____  _| |_ _   _                                                         
  01:31:11 - |  _ \ / __) _ \|  __) _  |  _ \| |  _) | | |                                                        
  01:31:11 - | | ) | | | (_) | | | ( | | | | | | |_| |_| |                                                        
  01:31:11 - | ||_/|_|  \___/|_|  \_||_|_| |_|_|\___)__  |                                                        
  01:31:11 - |_|                                   (____/                                                         
  01:31:11 -                                                                                                      
  01:31:11 - Version 0.12.1                                                                                       
  01:31:11 - Copyright (C) 2012 - 2019 James Booth <boothj5web@gmail.com>.                                        
  01:31:11 - Copyright (C) 2019 - 2021 Michael Vetter <jubalh@iodoru.org>.                                        
  01:31:11 - License GPLv3+: GNU GPL version 3 or later <https://www.gnu.org/licenses/gpl.html>                   


After ''profanity'' starts, type in the “slash command” ''/connect yourusername@jabber.sdf.org'' and hit enter. It will ask your password that you set up in ‘maint’

(You can also start just by running ''profanity yourusername@jabber.sdf.org'')

After you are logged in and connected:
  * To see a list of group chat rooms–also called //conferences//–enter ''/rooms'' after logging in (see ‘Conferences’ section below for more details)
  * To join your first room, try the ‘sdf’ group. Type ''/join sdf''. A new window, //[2]//, will be created and you will be switched to that window
  * To say something in the room you are in, just type it (no leading slash) and enter. It should appear in the main window.

To issue other commands in the app, enter the appropriate slash ''/'' commands (like you did with ''/join'' already) in the input area (another important example: ''/help''). Messages responding to your command will show up in the first window, the existence of which will be indicated by a ''[1]'' in the status bar. You can change to window 1 using ''/win 1'', or alternately by use of the function key F1 (F1..F10 should work) as listed below, but you may have to figure out for your ssh and computer setup what the “Alt” means (on a mac using default terminal program, ''[Esc] 1''--Escape key, then '1'--switches to window 1):
  * Alt-1 to Alt-0
  * F1 to F10
  * Esc, 1 to Esc, 0
  * Alt-left, Alt-right

To quit, enter ''/quit''

Much more info is available in the[[https://profanity-im.github.io/userguide.html |Quickstart guide]]

==== Connecting with Mcabber from SDF Unix shell ====


mcabber is “..a small Jabber console client. For now it needs a configuration file to start, so please copy the sample mcabberrc file and adapt your connection settings. ”. Its UI is based on windows and panes, each which has the following sections:
  * The roster, alias buddylist, is on the left.
  * The chat window, or chat buffer, is on the right
  * The input line lies at the bottom of the screen, under a small log window. 

As mentioned above, before mcabber will work, you need to create a //.mcabberrc// file. You can get the example file from ''/usr/share/doc/mcabber/examples/mcabberrc.example'' or the link listed above. You will need to make a copy of this file as ''.mcabberc'' in your home directory (or you will have to specify the location of the file every time you run ''mcabber'').

Edit the file in your favorite text editor and change the value of the //set jid// line to be your //jabber id ("jid")// and //set server// to the SDF server--//jabber.sdf.org//--and optionally, if you don't want to type it every time you run mcabber, the //set password// line to your password. Save the file, then you will be ready to go.

  * To start mcabber, enter at shell: ''mcabber''
  * It will show you your JID (from what you put in the rc file) and ask for your password
  * After you enter it, you should have the 4 pane window with your username under '[status]' section.
  * If you figure out how to list rooms, add it here, but to join the sdf room, type ''/room join sdf@conference.jabber.sdf.org''. You should get a status message that says "You have joined sdf@conference.jabber.sdf.org as "<nick>""
    * Use the page up/page down buttons on your keyboard to navigate to the line that says "[C] sdf@conference.ja...", and hit <enter> key. This should allow you to start chatting.

To issue other commands in the app, enter the appropriate slash ''/'' commands (like you did with ''/room join'' already) in the input area (another important example: ''/help''). Messages responding to your command will show up in the log window near the bottom. 

The integrated help is accessible with ''/help'' but isn't that useful (help for the //room// command doesn't include how to join a room!), but this site has a good manual: https://www.systutorials.com/docs/linux/man/1-mcabber/


==== Connecting with Pidgin or Finch from Your Unix or Windows Computer ====

Install Pidgin or Finch locally on your computer via instructions on the [[https://pidgin.im/ |Pidgin site]], then if you are using Pidgin (GTK graphical interface) or Finch (ncurses term interface) follow the appropriate sections below.

=== Connecting with Pidgin ===

  * Go to **Accounts→Manage Accounts**.
  * Click on **Add** button.
  * Select **XMPP** as **Protocol**.
  * Fill the appropiate field with your desired **Username**.
  * Fill the **Domain** field with: jabber.sdf.org
  * **Click on Save** button.

After finishing this steps, Pidgin will try to connect to the jabber server and will ask for your password (the one you have set up with the **maint** utility), also you will be warned about the self signed certificate, it is safe to accept it.

=== Connecting with Finch ===

Finch is the shell-based desktop-ish version of the jabber client Pidgin that was available on SDF, but seems to have not made it past the last upgrade.

If you have it, however, the following tutorial should work:

 To move around Finch's fields and buttons use the **TAB** key. You can learn more about using Finch [[http://developer.pidgin.im/wiki/Using%20Finch |here]].

  * Press **ALT** **+ a **and select **Accounts**
  * Select **Add** button to open New Account dialog box
  * Choose **XMPP** as the protocol
  * Fill the appropiate field with you desired **Username**
  * Fill the **Domain** with: jabber.sdf.org
  * **Save**
  * Now you just can select your newly created account from the Accounts list to get connected to SDF's jabber server.

== Add buddies in Finch ==

  - Select a group in the buddy list.
  - Press **F11** to bring out the context menu
  - Select **“Add Buddy”**.

==== Using bitlbee ====

Read bitlbee's documentation for how to get the server up and running. Then, to add SDF's jabber account:

  - Go to the &bitlbee channel in the server and register your user
  - Run the following command in that channel: **account add account_name user@jabber.sdf.org [passwd]**
  - Run: **account account_name on**

Read the help of bitlbee's commands and add your contacts there.

===== Conferences =====

Jabber allows you to talk to several users at once in conferences. These are similar to com rooms or IRC channels. The SDF jabber server has a “helpdesk” conference already set up and you are free to create new conferences too.

  * [[https://jabber.sdf.org/ |https://jabber.sdf.org]] displays some rudamentary //Jabber// ((//Register with our xmpp server by typing ‘maint’ at the shell//; //[[jabber_on_sdf#account_registration |Account Registration]]//)) stats: local rooms, total number of rooms and number of users.

==== Conferences in Profanity ====

=== To join an existing conference ===

To see a list of existing conferences, type ''/rooms'' **while still in window 1** after logging in. Example response:
  Room list request sent: conference.jabber.sdf.org
  Rooms list response received: conference.jabber.sdf.org
    anon@conference.jabber.sdf.org (anon (0))
    anonradio@conference.jabber.sdf.org (anonradio (8))
    conference@conference.jabber.sdf.org (conference (0))
    helpdek@conference.jabber.sdf.org (helpdek (0))
    helpdesk@conference.jabber.sdf.org (helpdesk (3))
    pcom@conference.jabber.sdf.org (dienda (0))
    roof@conference.jabber.sdf.org (roof (2))
    sdf@conference.jabber.sdf.org (sdf (10))
    test@conference.jabber.sdf.org (test (0))
    zcom@conference.jabber.sdf.org (zcom (1))

To join an existing conference you can just ''/join [room]'' where the room is the roomname, and the //@conference.jabber.sdf.org// can be left off, e.g., ''/join helpdesk''

=== To create and join a new conference ===

You can just ''/join [newroom]'' where //newroom// is a new room name, and profanity will create the room.

==== Conferences in Pidgin ====

=== To join an existing conference ===

  * Go to **Buddies**→**Join a Chat...**.
  * Select your jabber.sdf.org account in the **Account** drop-down
  * Click on the **Room List** button
  * Make sure the server to query is: conference.jabber.sdf.org
  * Click on the **Find Rooms** button
  * The Room List window will show all existing conferences along with the number of users in each. Select the one you want (helpdesk, for example) and click on the **Join** button.

By default you will not be notified of activity in conference windows the same way you are when someone talks in a one-to-one chat window. You can change this by going to **Tools**→**Plugins**, selecting to configure **Message Notification** and checking **Chat Windows** in the “Notify For” section.

=== To create a new conference using Pidgin ===

  * Go to **Buddies**→**Add Chat...**.
  * Select your jabber.sdf.org account and enter the desired room in the **Room** field.
  * Click the **Add** button
  * The new conference will have appeared in your buddy list. Double click on it to join it.
  * You will be prompted to configure your new room. Do so if you wish, or accept defaults.
  * Invite other users to join your conference through **Conversation**→**Invite...** or have them look in the Room List as described above.

===== Looking for Jabber users =====

The easiest way to find other SDF Jabber users is to visit the conferences as described above. If you know that somebody uses the SDF jabber server you can add them to your contact list directly by using the address: //username//@jabber.sdf.org where //username// is their SDF user name.

You can also use your SDF account to chat with people who have accounts on other Jabber servers. Note that some people might call it `XMPP' instead of `Jabber'. One of the largest Jabber servers is Google Talk: you can chat to GMail/Google Talk users this way without needing a Google account. The Jabber address of those users is the same as their email address.

----

Lots of updates from source below:

$Id: jabber.html,v 1.13 2019/12/02 16:13:22 thegiant Exp $ [[http://sdf.org/?tutorials/jabber|Jabber on SDF]] - traditional link (using [[wp>Revision_Control_System|RCS]])