Diakonos is built to run on Linux, but may run under other flavours of UNIX. It is known NOT to work under Windows (unless using Cygwin). It works reasonably well under iTerm on OSX.
Under Debian and Ubuntu derivatives, you'll need the following dependencies:
sudo apt-get install libncurses5-dev ruby-dev sudo gem install curses
The latest development code can be obtained from sourcehut:
git clone https://git.sr.ht/~pistos/diakonos
ruby install.rb --help ruby install.rb [installation parameters]
You may need root privileges on the system in order to install to system-wide places like /usr . However, Diakonos runs perfectly well in userspace, such as under ~/usr .
If you use RVM1, note that Diakonos installs very easily into an RVM-based Ruby.
After installing Diakonos under RVM, you can symlink to the installed binary, and that will allow you to use Diakonos with that specific Ruby version no matter what the current RVM Ruby is. Example:
mkdir -p ~/bin cd ~/bin ln -s /home/pistos/.rvm/rubies/ruby-1.9.2-p180/bin/diakonos
Then ensure that ~/bin is in your PATH.
Run with any of these:
diakonos [filename...] diakonos -s <session-name> diakonos -m <regexp>
or, for other options and arguments,
For help using Diakonos, simply press F1 or Shift-F1 from within the editor to use the interactive help system.
To dig deeper into Diakonos' rich feature set, see https://github.com/Pistos/diakonos/wiki/Beyond-the-Basics .
The source code repository is at git clone https://git.sr.ht/~pistos/diakonos .
Send comments, feedback and tech support requests to the ##pistos channel on the Libera IRC network. Reproducible issues may be reported at https://github.com/Pistos/diakonos/issues .