hstr/INSTALLATION.md
2018-08-13 17:00:22 +02:00

5.2 KiB

Installation

Install HSTR using distribution, from source code, on Ubuntu, Fedora/RHEL/CentOS/ScientificLinux, openSUSE, Debian/Mint, Gentoo, Arch Linux, Bash on Ubuntu on Windows (WSL), Cygwin or Mac OS.

Ubuntu

Install hh on Ubuntu - one-liner:

sudo add-apt-repository ppa:ultradvorka/ppa && sudo apt-get update && sudo apt-get install hh && hh --show-configuration >> ~/.bashrc

... or step by step:

sudo add-apt-repository ppa:ultradvorka/ppa
sudo apt-get update
sudo apt-get install hh

Optionally configure hh and check its man page.

Fedora/Rhel/Centos

Install hh on Fedora, RHEL or CentOS:

sudo dnf|yum install hstr -y

Optionally configure hh and check its man page.

openSUSE

For openSUSE Leap 42.1 run the following as root:

zypper addrepo http://download.opensuse.org/repositories/home:tuw-e184/openSUSE_Leap_42.1/home:tuw-e184.repo
zypper refresh
zypper install hstr

Installation from Source Code

Clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Install hh using:

./configure && make && make install

Optionally configure hh and check its man page.

Distribution Installation

Download latest distribution from project Releases section:

https://github.com/dvorka/hstr/releases

Expand the archive and install hh using:

./configure && make && make install

Optionally configure hh and check its man page.

Debian/Mint

Either download and install .deb archive from releases section of the project:

dpkg -i hstr_1...deb

Alternatively use (not always up to date) PPA to install hh on Debian (Wheezy) or Mint (13) by registering the key:

wget www.clfh.de/frankh.asc
apt-key add frankh.asc

adding the repository:

deb http://www.clfh.de/debian wheezy main
deb-src http://www.clfh.de/debian wheezy main

and installing it:

apt-get update
apt-get install hh

Optionally configure hh:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.

Gentoo

hstr has been added to Portage, see this bug. To install hstr, emerge it like so:

emerge app-shells/hstr

and you should be all set.

Arch Linux

Download latest distribution from project Releases section:

https://github.com/dvorka/hstr/releases

Use PKGBUILD in the root of the distribution to build package using makepkg:

https://aur.archlinux.org/packages/hstr-git/

Install hh.

Optionally configure hh and check its man page.

macOS

You can either install hh from Homebrew:

brew install hh

or from the source code as described further in this section. First install MacPorts:

http://www.macports.org

And then install readline and ncurses:

port install readline
port install ncurses

Build and install (if using Homebrew):

autoreconf -fvi
./configure CFLAGS=-I$(brew --prefix)/opt/readline/include LDFLAGS=-L$(brew --prefix)/opt/readline/lib
make

Alternative if using MacPorts (macports.com/GitHub):

autoreconf -fvi
./configure CFLAGS=-I/opt/local/include/ LDFLAGS=-L/opt/local/lib
make

Optionally configure hh and check its man page.

WSL

To install hh on Windows Subsystem for Linux (WSL) clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Finish installation hh using:

./configure && make && make install

In order to get autocompletion on Cygwin you must configure hh using:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.

Cygwin

To install hh on Cygwin clone Git repository:

git clone https://github.com/dvorka/hstr.git

Create build files using:

cd ./dist && ./1-dist.sh && cd ..

Finish installation hh using:

./configure && make && make install

In order to get autocompletion on Cygwin you must configure hh using:

hh --show-configuration >> ~/.bashrc

Optionally configure hh and check its man page.