README

What is Swirc?

Swirc is a BSD licensed, console based and lightweight ICB and IRC client written in C/C++, whose goals are to be portable and secure.

Official Swirc homepage

Program options

usage: swirc [-46?CPRdipv] [-c server[:port]] [-j join] [-n nickname] [-r rl name] [-u username] [-x config]

-4                   Use IPv4 addresses only
-6                   Use IPv6 addresses only
-?, --help           Output help
-C                   Do not change color definitions
-P                   Permanently disable SASL authentication
-R                   Disable TLS/SSL peer verification
-c <server[:port]>   Connect to IRC server
-d                   Debug logging
-i                   Turn on Internet Citizen's Band mode
-j <join>            A comma-separated list of channels to join
-n <nickname>        Online nickname
-p                   Query for server password (for private servers)
-r <rl name>         Your real name
-u <username>        Your username
-v, --version        Output Swirc version
-x <config>          Config file

Cloning

To clone the repository use Git.

$ git clone https://github.com/uhlin/swirc.git

Building

Framework

Swirc currently depends on:

• Curl
• GNU libidn
• Ncurses with wide character support
• OpenSSL toolkit

Which means that on for example a Debian GNU/Linux system you need to install 4 packages before building:

# apt install libcurl4-openssl-dev libidn11-dev libncursesw5-dev libssl-dev

And on Mac OS X, provided that Homebrew is installed, issue:

$ brew install libressl

FreeBSD

# pkg install curl libidn

NetBSD

# pkgin install curl libidn ncursesw

Void GNU/Linux

# xbps-install -S libcurl-devel libressl-devel ncurses-devel libidn-devel

Building for the UNIX environment

On the BSDs and GNU/Linux the configure script will per default generate make definitions that expects that the C compiler GCC is installed on your system. A make utility must also be present. Regarding Mac OS X I suggest that you install Xcode. Due to certain circumstances I no longer can confirm that building for OS X works.

$ cd /path/to/swirc
$ ./configure
$ make

Configuration options

The following options can be passed to the configure script:

• --with-libnotify: Enable support for desktop notifications
• --without-libidn: Build without GNU libidn
• --without-libintl: No internationalization

Install

1. Installing it under /usr/local:

    $ sudo make install
   

2. Installing it under /home/user without the translations (in which case you also should've passed --without-libintl to the configure script):

    $ PREFIX=/home/user make install-no-lc-msgs
   

Building for Windows

To build Swirc for Windows you must have Visual Studio.

So, fire up the command prompt for Visual Studio where the needed tools (the compiler, etc.) are loaded into the environment. The regular command prompt won't work. Then:

cd c:\path\to\swirc
nmake -f Makefile.vc

Done!

To make a distribution of Swirc use:

nmake -f Makefile.vc dist

Cleaning

Examples:

$ make clean
$ nmake -f Makefile.vc clean