Swirc IRC client -- Cloning and building

Documentation

Updated: 2022-02-24

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

Installing it under /usr/local:

$ sudo make install

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