How to install and use Waartaa IRC client as a local standalone application

1 Introduction

Waartaa is an open source communication and collaboration tool. It is an IRC client focussed to overcome the subtle disadvantages of existing clients. It is a web based IRC client as a service, facilitating some extremely useful services such as: centralised logging, unique Identity, global access, notifications, responsiveness to devices and displays across multiple clients.

This project is opensourced under the MIT Licence and built on the Meteor Platform and written using Meteor JS. The database at the backend is MongoDB and it has also incorporated node-irc, an IRC client library written in JavaScript for Node.

2 Installing dependencies

Waartaa requires that a few dependencies be satisfied before it can be installed. The main dependencies are Node JS and curl. It involves adding the Node JS repositories, updating the list and then installing curl. Use the following commands, one after the other.

sudo add-apt-repository ppa:chris-lea/node.js
sudo apt-get updatesudo apt-get install nodejssudo apt-get install curl

3 Downloading Waartaa

Waartaa can be downloaded either through git or by direct download. Either of the method gives the same packages.

3.1 Download through git

Use the following command to download and extract Waartaa through git.

git clone –recursive https://github.com/waartaa/waartaa.git

3.2 Direct download

You can download the zipped folder here. Once downloaded, extract it into your home folder.

4 Setup and starting the application

Before Waartaa can be run, we have to set it up with the server details and then install it onto our system. Use the following commands:

cd waartaa./setup.sh

Now wait for the setup to finish.

Once the setup is complete, we now have to configure the server hosts file. Open the file settings-local.js file by using the following commands:

cd appgedit server/settings-local.js

Once the file is opened, scroll to the very bottom and add your details such as the “SUPER_USER”, “SUPER_USER_EMAIL”, “SUPER_USER_PASSWORD” and “SECRET_KEY”. An example is given in the image below. Do remember to change it to your preferred credentials.

This completes the setup. We can now run Waartaa. The first time you run it, it will download the meteor platform tools and the dependencies it needs to run the application like the MongoDB packages. But the 2nd time onwards, it runs immediately. To run the application use the following command:

meteor

Make sure that while running the meteor command, you are always present in the app folder of Waartaa, which is the meteor’s project folder. Once the command successfully launches the application, your terminal will look similar to the image below:

If upon running the command “meteor” you get an error saying: ” project uses Meteor 1.0.2.1, which is not installed and could not be downloaded. Please check to make sure that you are online.”, then all you have to do is run the “meteor” command again and it will download the required version and start the application.

For using the GUI  and oter features, read my full article here.

Advertisements

One thought on “How to install and use Waartaa IRC client as a local standalone application

  1. Obviously Akshay nice tips wih the exciting Meteor development platform. Moreover the good news is Meteor development platform is now available for Windows. As Meteor 1.1 has been released and it can support Windows clients too. Last year, when its previous version as Meteor 1.0 was released, Windows was left out even though it was used by about half of the total market of developers as I read from a blog in http://goo.gl/KUYWmv

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s