https://github.com/nmeum/insomnia
A frontend for the hii IRC client
https://github.com/nmeum/insomnia
ii irc irc-client suckless tmux unix-philosophy
Last synced: 11 months ago
JSON representation
A frontend for the hii IRC client
- Host: GitHub
- URL: https://github.com/nmeum/insomnia
- Owner: nmeum
- License: gpl-3.0
- Created: 2018-12-21T23:54:49.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-19T23:00:31.000Z (about 1 year ago)
- Last Synced: 2025-03-23T03:31:59.687Z (12 months ago)
- Topics: ii, irc, irc-client, suckless, tmux, unix-philosophy
- Language: C
- Homepage:
- Size: 137 KB
- Stars: 13
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# insomnia
A frontend for the [hii][hii github] IRC client.
## Screenshot
## Status
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.
## Features
* 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.
* Support for colorful output.
## Dependencies
insomnia depends on the following non-standard utilities:
* [hii][hii github] >= 1.0.0
* [input][input github] >= 0.7.0
* [tmux][tmux homepage] >= [3.3][tmux window-resized]
* awk with `fflush()` (available since [POSIX.1‐2024][posix issue 634])
Additionally, the following software is required for compilation:
* A C99 compiler
* [GNU make][GNU make] (sorry!)
## Installation
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 variables `LIBDIR` and `DATADIR` are
special and need to be set for both targets `make` and `make install`.
### Development setup
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" DATADIR="$(pwd)/data"
$ make
Afterwards run `./bin/insomnia`.
## Usage
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.
## License
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 .
[hii github]: https://github.com/nmeum/hii
[input github]: https://github.com/nmeum/input
[tmux homepage]: https://tmux.github.io
[tmux window-resized]: https://github.com/tmux/tmux/issues/2995
[posix issue 634]: http://austingroupbugs.net/view.php?id=634
[GNU make]: https://www.gnu.org/software/make/