Swift/User Guide

Swift

Swift is an elegant, secure, adaptable and intuitive XMPP Client. Available for free on Windows, Mac OSX and Linux. Swift's clean design and comprehensive feature set make it the logical choice for anyone looking for a cross-platform XMPP client. Combining ease of use with a comprehensive feature set, Swift is suitable for single-user use and large-scale deployments in security conscious environments.

Swift is free software and licensed under the GPLv2.

Downloading and Installing Swift

Downloading and installing swift is just like any other program.

1. Start by going to the Swift download page.
2. Choose the operating system you are currently running.
3. Once downloaded, open the installer and complete the install.

Logging into Swift for the first time

Note: The Swift client is NOT able to perform in-band registration at this time.

Swift Login Window (Image 1)

The first time you start up Swift you will be presented with Swift login window ^[Image1].

Swift requires that you already have a XMPP account before you may use Swift. You may choose a server from my list of available servers or you may use an account from your place of work or other organisation that has a XMPP service available.

Logging in with Default Options

Once you have your JID (username) and Password you may login with it using swift.

1. Enter your JID/username in the "User address:" box.
2. Enter your Password in the "Password:" box.
3. If this is a computer that you normally use, you may click the "Remember Password?" checkbox.
4. If you wish Swift to auto login and when started, click the "Login Automatically?"

Logging in with Advanced Options

If the initial attempt to log in fails due to something other then a bad username/password, it may be an issue with the connection options

1. From the Swift login window, choose "Connection Options"
2. From the new windows that opens, select the top dropdown box and change it to "Manual"
3. A new

Updating your Profile

Note: All information in your profile is PUBLIC and may be accessed by people you do not know.

A XMPP server is able to store a user's profile or sometimes know as a vCard (XEP-0154). This profile is accessible to your contacts and anyone searching for your name on the server. The profile is accessible whether you are online or offline since it is stored on your server.

1. To update your profile, either click on your profile image, or click Actions → Edit Profile
2. A new window will open, you may fill in as much or as little information you wish.
   • Please at least fill out your First Name, Last Name, & Nick Name.
   • Add a profile picture to your profile so others and quickly see who they are chatting with.
3. You may add new fields to your profile by clicking the Add Fields dropdown near the bottom right of the profile window.
4. Once complete, click Save in the bottom right of the profile window.

Your profile will then be published on the server. You may view other peoples profiles by hovering your mouse over their profile picture in either your buddy list or within a conference room chat.

Adding a Contact

A contact is a user in your buddy list that you can chat with. Contacts may be users on your server or other servers that have XMPP federation enabled.

There are three (3) different methods to add a contact to Swift.

Adding a Contact you already have the address for

Swift's Add a Contact Dialog Window. (Image 2)

This option is used when you know the XMPP address or JID of the client you wish to add to Swift.

1. Click Actions from the top of the Swift window.
2. From the Actions menu, choose Add Contact.
3. To the right of "I know their address:" enter the JID or address of the new contact.
4. Once added, click Next.
5. A new window will display asking for your contact's; nickname, first name, last name, or E-Mail.
6. Enter one of the fields then click Next.
7. A list of users will be displayed, choose the user you wish to add and click Next.
8. Lastly a new window will open, asking you what name you would like this user to be displayed as and what group they should be stored in.
9. Once complete, choose Finish.

Search for a Contact hosted on the same server

This option is used when you wish to add a contact who is hosted on the same server as you are running on. Only contacts with updated profiles (see above) will be searched.

1. Click Actions from the top of the Swift window.
2. From the Actions menu, choose Add Contact.
3. Choose "I'd like to search my server" then click Next.
4. A new window will display asking for your contact's; nickname, first name, last name, or E-Mail.
5. Enter one of the fields then click Next.
6. A list of users will be displayed, choose the user you wish to add and click Next.
7. Lastly a new window will open, asking you what display name you would like to use for this new contact and what group they should be stored in.
8. Once complete, choose Finish.

Search for a Contact hosted on a different server

This option is used when you wish to add a contact who is hosted on a different server then you are running on, but do not know the contact's address. Not all servers support or allow users not hosted on the server to search for users.

Changing your Status

Your status (or sometimes known as your presence) indicates to your contacts if you are online and available to chat or not. All of your contacts are able to view your current status.

If you walk away from your computer after 5 minutes, Swift will automatically switch your status to Away. Once you come back to your computer and "wake it up" (move the mouse) your status will change back to Available.

Sending a File to a Single User

Note: The user MUST be online to receive the file.

To send a file to a single user, simply drag the image into the window of the contact you wish to send the file to. You will be prompted for a description of the file. Once complete, click the Send button.

Edit Blocking

Swift comes with blocklist management built in. When you add a contact to your block list, you are preventing that contact from sending you messages in the future.

Adding a Contact to the Blocklist

There are a few ways to add a contact to your blocking list, depending on what your doing and how to received the contacts information.

Removing or Modifying a Contact from the Blocklist

To manage a block contact, you must start by going to the "Blocking List" window within Swift, by going to Actions → Edit Blocking List....

Accessing the Blocking List window.

A new window will now open containing your list of blocked JIDs.

Swift.im Blocklist

If you would like to remove a contact, click the X to the right of the JID.

To modify a contact, click on its JID and you can edit it from there.

Group Conference Room

Sending a File to a Conference

To send a file to a conference room of users, simply drag the image into the window of the conference room you wish to send the file to. You will be prompted for a description of the file. Once complete, click the Send button.

The users in the group will receive a link to the image, any user who has the link can access the image.