hstr/INSTALLATION.md

510 lines
13 KiB
Markdown
Raw Normal View History

# Installation
Install:
* [Ubuntu](#ubuntu)
2018-09-06 22:26:05 +08:00
* [Fedora](#fedorarhelcentosscientific)
* [Gentoo](#gentoo)
2018-09-06 22:26:05 +08:00
* [CentOS](#fedorarhelcentosscientific)
* [openSUSE](#opensuse)
2018-09-06 22:26:05 +08:00
* [RHEL](#fedorarhelcentosscientific)
* [Debian](#debianmint)
* [Mint](#debianmint)
* [Alpine Linux](#alpine-linux)
2018-09-06 22:26:05 +08:00
* [Arch Linux](#archmanjaro-linux)
2018-11-16 04:17:33 +08:00
* [Milis Linux](#milis-linux)
2018-09-06 22:26:05 +08:00
* [Manjaro Linux](#archmanjaro-linux)
* [Scientific Linux](#fedorarhelcentosscientific)
* [Haiku OS](#haiku-os)
* [macOS](#macos)
2018-10-04 13:28:31 +08:00
* [nix package manager](#nix-package-manager)
* [Guix package manager](#guix-package-manager)
* [MPR package manager](#mpr-package-manager)
Build:
* [build on any Linux distro](#build-on-any-linux-distro)
* [build snap](#build-snap)
* [build on Ubuntu](#build-on-ubuntu)
* [build on Debian](#build-on-debian)
* [build on Fedora](#build-on-fedora)
2018-08-12 05:34:45 +08:00
* [build on Windows Subsystem for Linux (WSL)](#build-on-wsl)
* [build on Cygwin](#build-on-cygwin)
* [build on macOS](#build-on-macos)
Tarball:
* [build and install tarball](#build-and-install-tarball)
2021-12-12 15:42:54 +08:00
Upgrade:
* [HSTR 1.x to 2.x](#upgrade)
# Install
2021-12-12 15:40:45 +08:00
Install HSTR using a [package](https://pkgs.org/search/?q=hstr) or repository.
## Ubuntu
2023-01-23 20:12:33 +08:00
HSTR is [included in Ubuntu 21.10](https://packages.ubuntu.com/search?keywords=hstr) and [newer](https://wiki.ubuntu.com/Releases) releases:
```
sudo apt install hstr
```
---
Install HSTR on **Ubuntu 21.04 and older** using one-liner:
2016-10-11 14:51:18 +08:00
```bash
sudo add-apt-repository ppa:ultradvorka/ppa && sudo apt-get update && sudo apt-get install hstr && hstr --show-configuration >> ~/.bashrc && . ~/.bashrc
2016-10-11 14:51:18 +08:00
```
2016-10-11 14:51:18 +08:00
... or step by step:
```bash
sudo add-apt-repository ppa:ultradvorka/ppa
sudo apt-get update
sudo apt-get install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Debian/Mint
HSTR is [included in Debian 11](https://packages.debian.org/bullseye/hstr) and [newer](https://www.debian.org/releases/) releases:
```
sudo apt install hstr
```
---
Install HSTR on **Debian 10 and older** from my PPA. Add [PPA](https://www.mindforger.com/debian),
trust [GPG key](https://www.mindforger.com/gpgpubkey.txt) and install HSTR:
```bash
# add PPA to APT sources:
sudo bash -c 'echo -e "\ndeb https://www.mindforger.com/debian stretch main" > /etc/apt/sources.list.d/mindforger.list'
# import PPA's GPG key
wget -qO - https://www.mindforger.com/gpgpubkey.txt | sudo apt-key add -
# update sources
sudo apt update
# install HSTR
sudo apt install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
---
2018-08-12 02:18:00 +08:00
Alternatively you can download and install `.deb` archive from [GitHub releases](https://github.com/dvorka/hstr/releases)
2018-05-23 16:49:40 +08:00
section of the project:
2018-05-23 16:49:40 +08:00
```bash
wget -O hstr.deb https://github.com/dvorka/hstr/releases/download/<major>.<minor>/hstr_<major>.<minor>.<revision>-1_amd64.deb
# dependencies:
apt-get install libncursesw5 libtinfo5
sudo dpkg -i hstr.deb
```
## Fedora/RHEL/CentOS/Scientific
Install HSTR on [Fedora](https://src.fedoraproject.org/rpms/hstr), RHEL, CentOS or Scientific Linux:
```bash
sudo dnf install hstr
```
... or:
```bash
sudo yum install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
---
If you want to make sure you have the latest version, then download `.rpm` archive from
[GitHub releases](https://github.com/dvorka/hstr/releases) or [pkgs.org](https://pkgs.org/search/?q=hstr) and install it:
```bash
2020-01-06 00:20:53 +08:00
sudo dnf install ./hstr-<major>.<minor>.<revision>-2.x86_64.rpm
```
## openSUSE
To install HSTR on openSUSE, please check [software.opensuse.org](https://software.opensuse.org/package/hstr) or [pkgs.org](https://pkgs.org/search/?q=hstr). You can install HSTR as follows:
```bash
zypper addrepo https://download.opensuse.org/repositories/home:lemmy04/openSUSE_Leap_15.1/home:lemmy04.repo
zypper refresh
zypper install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Gentoo
To install HSTR on Gentoo run (HSTR has been added to [Portage](https://bugs.gentoo.org/show_bug.cgi?id=527122)):
2018-08-01 05:23:20 +08:00
```bash
emerge app-shells/hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Alpine Linux
To install HSTR on Alpine Linux run the following command as root:
```bash
apk add hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## ALT Linux
To install HSTR on ALT Linux, please check [pkgs.org](https://pkgs.org/search/?q=hstr). You can install HSTR as follows:
```bash
rpm [p10] http://ftp.altlinux.org/pub/distributions/ALTLinux/autoimports/p10 x86_64 autoimports
rpm [p10] http://ftp.altlinux.org/pub/distributions/ALTLinux/autoimports/p10 noarch autoimports
sudo apt-get update
sudo apt-get install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2018-09-06 22:26:05 +08:00
## Arch/Manjaro Linux
To install HSTR on Arch or Manjaro Linux download the latest distribution either from [pkgs.org](https://pkgs.org/search/?q=hstr) or [GitHub releases](https://github.com/dvorka/hstr/releases).
Use [PKGBUILD](https://wiki.archlinux.org/index.php/PKGBUILD) in the root of the distribution to build package using `makepkg`.
2019-12-23 15:11:51 +08:00
To install HSTR from the [Arch User Repository (AUR)](https://aur.archlinux.org/packages/hstr-git/) run `yaourt -S hstr-git` in command line.
2018-09-07 14:04:07 +08:00
## FreeBSD
To install HSTR on FreeBSD, please check [pkgs.org](https://pkgs.org/search/?q=hstr). You can install HSTR as follows:
```bash
pkg install hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Slackware
To install HSTR on Slackware, please check [pkgs.org](https://pkgs.org/search/?q=hstr). You can install HSTR as follows:
```bash
upgradepkg --install-new hstr-<major>.<minor>-x86_64-1cf.txz
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Void Linux
To install HSTR on Void Linux, please check [pkgs.org](https://pkgs.org/search/?q=hstr). You can install HSTR as follows:
```bash
xbps-install -Su hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2018-11-16 04:17:33 +08:00
## Milis Linux
To install HSTR on Milis Linux run the following commands as root:
2018-11-16 04:17:33 +08:00
```bash
mps kur hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Haiku OS
2018-08-30 21:18:35 +08:00
To install HSTR on Haiku OS use [Haiku Depot](https://www.haiku-os.org/docs/userguide/en/applications/haikudepot.html):
* https://depot.haiku-os.org/#!/?srchexpr=hstr
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## macOS
Install HSTR on macOS using [Homebrew](https://brew.sh/) ([formula](https://formulae.brew.sh/formula/hstr)):
```bash
brew install hstr
```
2022-12-02 06:45:30 +08:00
You can also install HSTR on macOS using [MacPorts](https://www.macports.org) ([port info](https://ports.macports.org/port/hstr/)):
```bash
sudo port install hstr
```
2018-10-04 13:28:31 +08:00
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## nix package manager
2018-10-04 21:20:12 +08:00
To install HSTR using the [nix package manager](https://nixos.org/nix/) e.g. on [NixOS](https://nixos.org/) you can use the [nix derivation for HSTR](https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/misc/hstr/default.nix):
2018-10-04 13:28:31 +08:00
```bash
nix-env -i hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Guix package manager
To install HSTR in [GuixSD](https://www.gnu.org/software/guix/) or using the standalone [Guix package manager](https://www.gnu.org/software/guix/manual/en/html_node/Binary-Installation.html#Binary-Installation) you can install the `hstr` package, e.g.
```bash
guix package -i hstr
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2022-01-09 19:02:19 +08:00
## MPR package manager
To install HSTR in Ubuntu or derivative operating systems using MPR, you can search for `hstr-git` using helper
2022-01-09 19:02:19 +08:00
or install it manually using `makedeb -s`
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2022-01-09 19:02:19 +08:00
[MPR package](https://mpr.hunterwittenborn.com/packages/hstr-git)
# Build
Build HSTR from source code.
2018-08-12 05:11:35 +08:00
## Build on any Linux distro
Clone Git repository:
2017-06-05 12:49:15 +08:00
```bash
git clone https://github.com/dvorka/hstr.git
```
2017-06-05 12:49:15 +08:00
Create build files using:
2017-06-05 12:49:15 +08:00
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
2017-06-05 12:49:15 +08:00
```
Build and install HSTR using:
2017-06-05 12:49:15 +08:00
```bash
./configure && make && make install
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2017-06-05 12:49:15 +08:00
## Build snap
To build [snap](https://snapcraft.io/) for HSTR first clone Git repository:
```bash
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](https://snapcraft.io/) and build
snap by running snapcraft in the root of Git repository:
```
$ ls ./snap
snapcraft.yaml
$ snapcraft
...
```
Find `hstr_0+git..._amd64.snap` in the current directory.
## Build on Ubuntu
To build HSTR on Ubuntu clone Git repository:
```bash
git clone https://github.com/dvorka/hstr.git
```
Install dependencies:
2017-06-05 12:49:15 +08:00
```bash
2018-08-12 05:11:35 +08:00
sudo apt install automake gcc make libncursesw5-dev libreadline-dev
```
Create build files using:
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
```
Build and install HSTR using:
```bash
./configure && make && make install
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Build on Debian
To build HSTR on Debian clone Git repository:
```bash
git clone https://github.com/dvorka/hstr.git
```
Install dependencies:
```bash
sudo apt install autotools gcc make pkgconf libncursesw5-dev libreadline-dev
```
Create build files using:
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
```
Build and install HSTR using:
```bash
./configure && make && make install
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Build on Fedora
To build HSTR on Fedora clone Git repository:
2017-06-05 12:49:15 +08:00
```bash
git clone https://github.com/dvorka/hstr.git
```
Install dependencies:
```bash
sudo dnf install autotools ncurses-devel readline-devel
```
Create build files using:
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
```
Build and install HSTR using:
```bash
./configure && make && make install
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Build on WSL
To build HSTR on [Windows Subsystem for Linux (WSL)](https://msdn.microsoft.com/en-us/commandline/wsl/about) clone Git repository:
```bash
git clone https://github.com/dvorka/hstr.git
```
2018-08-12 05:05:59 +08:00
Install dependencies:
```bash
2018-08-12 05:11:35 +08:00
sudo apt install automake gcc make libncursesw5-dev libreadline-dev
2018-08-12 05:05:59 +08:00
```
Create build files using:
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
```
2018-08-12 05:32:03 +08:00
Build and install `hstr` using:
```bash
./configure && make && make install
```
It's **important** to finish installation by configuration of HSTR binding
2018-08-12 05:34:45 +08:00
which ensures propagation of chosen command to the prompt:
2018-08-12 05:32:03 +08:00
```bash
hstr --show-configuration >> ~/.bashrc
. ~/.bashrc
```
Make sure to **run** HSTR using <kbd>Ctrl-r</kbd> (or `hstrwsl`) - otherwise commands will not appear in prompt.
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2018-08-12 05:32:03 +08:00
## Build on Cygwin
To build HSTR on [Cygwin](https://www.cygwin.com) clone Git repository:
```bash
git clone https://github.com/dvorka/hstr.git
```
Create build files using:
```bash
cd ./build/tarball && ./tarball-automake.sh && cd ../..
```
Build and install HSTR using:
```bash
./configure && make && make install
```
It's **important** to finish installation by configuration of HSTR binding
which ensures propagation of chosen command to the prompt:
```bash
hstr --show-configuration >> ~/.bashrc
. ~/.bashrc
```
Make sure to **run** HSTR using <kbd>Ctrl-r</kbd> (or `hstrcygwin`) - otherwise commands will not appear in prompt.
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
## Build on macOS
HSTR can be built on macOS either using [MacPorts](https://www.macports.org/) or [Homebrew](https://brew.sh/).
---
To build HSTR using [MacPorts](https://www.macports.org/) install `readline` and `ncurses`:
```bash
port install readline
port install ncurses
```
Check `portfile` either on [macports.com](https://www.macports.org/ports.php?by=name&substr=hstr) or [GitHub](https://github.com/macports/macports-ports/blob/master/shells/hstr/Portfile):
```bash
autoreconf -fvi
./configure CFLAGS=-I/opt/local/include/ LDFLAGS=-L/opt/local/lib
make
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
---
To build HSTR using [Homebrew](https://brew.sh/):
```bash
autoreconf -fvi
./configure CFLAGS=-I$(brew --prefix)/opt/readline/include LDFLAGS=-L$(brew --prefix)/opt/readline/lib
make
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
# Tarball
Download and install HSTR tarball.
## Build and Install Tarball
2018-08-12 02:18:00 +08:00
Download latest tarball from [GitHub releases](https://github.com/dvorka/hstr/releases) section.
Expand the archive and install HSTR using:
```bash
./configure && make && make install
```
[Configure](CONFIGURATION.md) HSTR and check its [man page](README.md#documentation).
2021-12-12 15:42:54 +08:00
# Upgrade
Upgrade HSTR using a [package](https://pkgs.org/search/?q=hstr) or repository. If you are `HSTR 1.x` user, please read about [HSTR 2.x changes](https://github.com/dvorka/hstr/releases/tag/2.0).