8.5 KiB
Installation
Install:
Build:
- build on any Linux distro
- build snap
- build on Ubuntu
- build on Debian
- build on Fedora
- build on Windows Subsystem for Linux (WSL)
- build on Cygwin
- build on macOS
Tarball:
Install
Install HSTR using a package.
Ubuntu
Install hh on Ubuntu using 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
Configure hh and check its man page.
Fedora/RHEL/Centos
Install hh on Fedora, RHEL or CentOS:
sudo dnf install hstr -y
... or:
sudo yum install hstr -y
Configure hh and check its man page.
If you want to make sure you have the latest version, then download .rpm archive from
GitHub releases and install it:
sudo dnf install ./hstr-<major>.<minor>.<revision>-2.x86_64.rpm -y
Debian/Mint
Install hh from PPA. Add my PPA,
trust GPG key and install hh:
# add PPA to APT sources:
sudo echo -e "\ndeb http://www.mindforger.com/debian stretch main" >> /etc/apt/sources.list
# import PPA's GPG key
wget -qO - http://www.mindforger.com/gpgpubkey.txt | sudo apt-key add -
# update sources
sudo apt update
# install MindForger
sudo apt install hstr
Configure hh and check its man page.
Alternatively you can download and install .deb archive from GitHub releases
section of the project:
dpkg -i hstr_-<major>.<minor>.<revision>_1-amd64.deb
openSUSE
To install hh on openSUSE Leap 42.1 run the following commands 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
Configure hh and check its man page.
Gentoo
To install hh on Gentoo run (HSTR has been added to Portage):
emerge app-shells/hstr
Configure hh and check its man page.
Arch Linux
To install HSTR on Arch Linux download latest distribution from GitHub releases.
Use PKGBUILD in the root of the distribution to build package using makepkg.
https://aur.archlinux.org/packages/hstr-git/
Install hh.
Configure hh and check its man page.
macOS
Install hh on macOS using Homebrew (formula):
brew install hh
Configure hh and check its man page.
Build
Build HSTR from source code.
Build on any Linux distro
Clone Git repository:
git clone https://github.com/dvorka/hstr.git
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hh using:
./configure && make && make install
Run HSTR:
hh
Configure hh and check its man page.
Build snap
To build snap for 'hh' first clone Git repository:
git clone https://github.com/dvorka/hstr.git
Make sure that you can build HSTR from source code as described in a "Build on ..." section for your distribution.
Install snapcraft and build snap by running snapcraft in the root of Git repository:
$ ls ./snap
snapcraft.yaml
$ snapcraft
...
Find hh_0+git..._amd64.snap in the current directory.
Build on Ubuntu
To build hh on Ubuntu clone Git repository:
git clone https://github.com/dvorka/hstr.git
Install dependencies:
sudo apt install automake gcc make libncursesw5-dev libreadline-dev
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hh using:
./configure && make && make install
Run HSTR:
hh
Configure hh and check its man page.
Build on Debian
To build hh on Debian clone Git repository:
git clone https://github.com/dvorka/hstr.git
Install dependencies:
sudo apt install autotools gcc make libncursesw5-dev libreadline-dev
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hh using:
./configure && make && make install
Run HSTR:
hh
Configure hh and check its man page.
Build on Fedora
To build hh on Fedora clone Git repository:
git clone https://github.com/dvorka/hstr.git
Install dependencies:
sudo dnf install autotools ncurses-devel readline-devel
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hh using:
./configure && make && make install
Run HSTR:
hh
Configure hh and check its man page.
Build on WSL
To build hstr on Windows Subsystem for Linux (WSL) clone Git repository:
git clone https://github.com/dvorka/hstr.git
Install dependencies:
sudo apt install automake gcc make libncursesw5-dev libreadline-dev
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hstr using:
./configure && make && make install
It's important to finish installation by configuration of hstr binding
which ensures propagation of chosen command to the prompt:
hstr --show-configuration >> ~/.bashrc
. ~/.bashrc
Make sure to run hstr using Ctrlr - otherwise commands will not appear in prompt.
Configure hh and check its man page.
Build on Cygwin
To build hh on Cygwin clone Git repository:
git clone https://github.com/dvorka/hstr.git
Create build files using:
cd ./build/tarball && ./tarball-automake.sh && cd ../..
Build and install hh using:
./configure && make && make install
Configure hh and check its man page.
Build on macOS
HSTR can be built on macOS either using MacPorts or Homebrew.
To build hh using MacPorts install readline and ncurses:
port install readline
port install ncurses
Check portfile either on macports.com or GitHub:
autoreconf -fvi
./configure CFLAGS=-I/opt/local/include/ LDFLAGS=-L/opt/local/lib
make
Configure hh and check its man page.
To build hh using Homebrew:
autoreconf -fvi
./configure CFLAGS=-I$(brew --prefix)/opt/readline/include LDFLAGS=-L$(brew --prefix)/opt/readline/lib
make
Configure hh and check its man page.
Tarball
Download and install HSTR tarball.
Build and Install Tarball
Download latest tarball from GitHub releases section.
Expand the archive and install hh using:
./configure && make && make install