A frontend for the hii IRC client
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



A frontend for the hii IRC client.


insomnia is just a collection of small programs and scripts which are connected using tmux to create a simple irssi-like text-based user interface for hii. As you might expected it's pretty hacky but mostly works.


  • Support for readline-like key bindings and tab completions for nicks.
  • Support for highlight "notification" through bell characters.
    • Use this in combination with tmux's monitor-bell feature.
  • Support for tracking topic changes through tmux pane titles.
  • (Optional) support for nick colors.


insomnia depends on the following non-standard utilities:

Additionally, the following software is required for compilation:


To build and install insomnia run the following commands:

$ make
$ make install

Consult the GNUmakefile for environment variables which can be used to configure the installation. The variable LIBDIR is special and needs to be set for both targets make and make install.

In case you don't want to install insomnia globally but just want to experiment with it compile insomnia using the following commands:

$ export LIBDIR="$(pwd)/lib"
$ make


After a successful installation insomnia can be invoked as follows:

$ insomnia irc.hackint.org '#hii'

This will only work if an hii instance for irc.hackint.org is already running in the background and if the user already joined the #hii channel.


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.