hstr/README.md

# HSTR
[![Travis CI](https://travis-ci.org/dvorka/hstr.svg?branch=master)](https://travis-ci.org/dvorka/hstr)
<!--
[![Current release](https://img.shields.io/github/release/dvorka/hstr.svg)](https://github.com/dvorka/hstr/releases)
[![GitHub issues](https://img.shields.io/github/issues/dvorka/hstr.svg?maxAge=360)](https://github.com/dvorka/hstr/issues)
[![All releases downloads](https://img.shields.io/github/downloads/dvorka/hstr/total.svg)](https://github.com/dvorka/hstr/releases)
-->

Easily view, navigate and search your **command history** with shell history suggest box for Bash and
[Zsh](CONFIGURATION.md#zsh-history-settings).

[![Shell History Suggest Box](http://me.mindforger.com/projects/images/hh-animated-01.gif "Shell History Suggest Box @ YouTube")](http://www.youtube.com/watch?v=sPF29NyXe2U)


## Description
Are you looking for a command that you used **recently**? Do you
want to  avoid the need to write **long commands** over and over
again? Are you looking for a tool that is able to manage your 
**favorite** commands?

HSTR (**H**i**ST**o**R**y) is a command line utility that brings improved Bash command completion
from the history. It aims to make completion **easier** and more **efficient**
than <kbd>Ctrl+r</kbd>.

HSTR can also **manage** your command history (for instance you can remove
commands that are obsolete or contain a sensitive information) or **bookmark** 
your favorite commands.

Check [video](http://www.youtube.com/watch?v=sPF29NyXe2U) tutorial.


## Installation
Install:

* [Ubuntu](INSTALLATION.md#ubuntu)
* [Fedora](INSTALLATION.md#fedorarhelcentos)
* [Gentoo](INSTALLATION.md#gentoo)
* [CentOS](INSTALLATION.md#fedorarhelcentos)
* [openSUSE](INSTALLATION.md#opensuse)
* [RHEL](INSTALLATION.md#fedorarhelcentos)
* [Debian](INSTALLATION.md#debianmint)
* [Mint](INSTALLATION.md#debianmint)
* [Arch Linux](INSTALLATION.md#arch-linux)
* [Scientific Linux](INSTALLATION.md#fedorarhelcentos)
* [macOS](INSTALLATION.md#macos)

Build:

* [build on any Linux distro](INSTALLATION.md#build-on-any-linux-distro)
* [build on Ubuntu](INSTALLATION.md#build-on-ubuntu)
* [build on Debian](INSTALLATION.md#build-on-debian)
* [build on Fedora](INSTALLATION.md#build-on-fedora)
* [build on Windows Subsystem for Linux (WSL)](INSTALLATION.md#build-on-wsl)
* [build on Cygwin](INSTALLATION.md#build-on-cygwin)

Tarball:

* [build and install tarball](INSTALLATION.md#build-and-install-tarball)

## Configuration
Optionally configure HSTR just by running:
```bash
hh --show-configuration >> ~/.bashrc
```
For detailed `hh` configuration documentation please refer to [Configuration](CONFIGURATION.md).


## Documentation
Check `hh` man page:

```bash
man hh
```

## In the News
Read about `hh` in [LinuxMagazine](http://www.linux-magazine.com/Issues/2014/164/Bash-History-on-Steroids), [UbuntuGeek](http://www.ubuntugeek.com/tag/hstr-bash-history), [DebianAdmin](http://www.debianadmin.com/hstr-easily-view-navigate-search-and-use-your-command-history-with-shell-history.html), [Tuxdiary](https://tuxdiary.com/2015/02/17/hstr/) or [Softpedia](http://linux.softpedia.com/get/Terminals/BASH-Command-History-Completion-103155.shtml).


## Bugs
https://github.com/dvorka/hstr/issues
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`# HSTR`
Travis CI badge. 2018-08-11 20:42:52 +08:00			`[![Travis CI](https://travis-ci.org/dvorka/hstr.svg?branch=master)](https://travis-ci.org/dvorka/hstr)`
GitHub icons caching on web doesn't work. 2018-07-17 16:59:38 +08:00			`<!--`
Adding badges. 2018-04-27 15:30:08 +08:00			`[![Current release](https://img.shields.io/github/release/dvorka/hstr.svg)](https://github.com/dvorka/hstr/releases)`
			`[![GitHub issues](https://img.shields.io/github/issues/dvorka/hstr.svg?maxAge=360)](https://github.com/dvorka/hstr/issues)`
			`[![All releases downloads](https://img.shields.io/github/downloads/dvorka/hstr/total.svg)](https://github.com/dvorka/hstr/releases)`
GitHub icons caching on web doesn't work. 2018-07-17 16:59:38 +08:00			`-->`
Adding badges. 2018-04-27 15:30:08 +08:00
Update README.md 2018-03-18 01:03:16 +08:00			`Easily view, navigate and search your command history with shell history suggest box for Bash and`
Minor index polishing. 2015-05-09 20:44:36 +08:00			`[Zsh](CONFIGURATION.md#zsh-history-settings).`
Initial commit 2013-12-03 06:47:51 +08:00
Fixing broken link. 2018-01-11 19:01:13 +08:00			`[![Shell History Suggest Box](http://me.mindforger.com/projects/images/hh-animated-01.gif "Shell History Suggest Box @ YouTube")](http://www.youtube.com/watch?v=sPF29NyXe2U)`
MD 2014-01-20 04:54:14 +08:00
Source code 2013-12-03 06:55:33 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`## Description`
Highlighting important information in readme. 2014-12-20 17:43:36 +08:00			`Are you looking for a command that you used recently? Do you`
			`want to avoid the need to write long commands over and over`
Update README.md 2018-03-18 01:03:16 +08:00			`again? Are you looking for a tool that is able to manage your`
			`favorite commands?`
Motivation why to use hh added to MD. 2014-04-20 14:00:16 +08:00
Polishing documentation. 2018-08-11 14:37:17 +08:00			`HSTR (HiSToRy) is a command line utility that brings improved Bash command completion`
Highlighting important information in readme. 2014-12-20 17:43:36 +08:00			`from the history. It aims to make completion easier and more efficient`
Update README.md 2018-08-12 04:32:33 +08:00			`than <kbd>Ctrl+r</kbd>.`
Source code 2013-12-03 06:55:33 +08:00
Update README.md 2018-03-18 01:03:16 +08:00			`HSTR can also manage your command history (for instance you can remove`
			`commands that are obsolete or contain a sensitive information) or bookmark`
			`your favorite commands.`
Fixed #62 by merging 'favorites' branch. 2014-04-13 16:02:25 +08:00
Update README.md 2018-03-18 01:03:16 +08:00			`Check [video](http://www.youtube.com/watch?v=sPF29NyXe2U) tutorial.`
Adding screenshot to .md 2013-12-16 15:15:11 +08:00
MD 2014-01-10 08:21:21 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`## Installation`
			`Install:`
Polishing documentation. 2018-08-11 14:37:17 +08:00
Polishing readme. 2015-02-18 13:38:27 +08:00			`* [Ubuntu](INSTALLATION.md#ubuntu)`
Fixing links from the readme to installation MD. 2015-08-31 04:34:51 +08:00			`* [Fedora](INSTALLATION.md#fedorarhelcentos)`
			`* [Gentoo](INSTALLATION.md#gentoo)`
			`* [CentOS](INSTALLATION.md#fedorarhelcentos)`
Update README.md Added openSUSE instalation method (README.md) 2016-01-15 00:21:46 +08:00			`* [openSUSE](INSTALLATION.md#opensuse)`
Fixing links from the readme to installation MD. 2015-08-31 04:34:51 +08:00			`* [RHEL](INSTALLATION.md#fedorarhelcentos)`
Fixed #129 - deletion of history entries - entries are deleted both from system and hh's raw history (in the right order). 2015-02-23 05:03:51 +08:00			`* [Debian](INSTALLATION.md#debianmint)`
			`* [Mint](INSTALLATION.md#debianmint)`
Polishing readme. 2015-02-18 13:38:27 +08:00			`* [Arch Linux](INSTALLATION.md#arch-linux)`
Fixing links from the readme to installation MD. 2015-08-31 04:34:51 +08:00			`* [Scientific Linux](INSTALLATION.md#fedorarhelcentos)`
Making title conventions consistent. 2018-08-11 14:48:25 +08:00			`* [macOS](INSTALLATION.md#macos)`
MD and man 2014-01-17 11:46:12 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`Build:`
MD and man 2014-01-17 11:46:12 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`* [build on any Linux distro](INSTALLATION.md#build-on-any-linux-distro)`
			`* [build on Ubuntu](INSTALLATION.md#build-on-ubuntu)`
			`* [build on Debian](INSTALLATION.md#build-on-debian)`
			`* [build on Fedora](INSTALLATION.md#build-on-fedora)`
Update README.md 2018-08-12 05:36:07 +08:00			`* [build on Windows Subsystem for Linux (WSL)](INSTALLATION.md#build-on-wsl)`
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`* [build on Cygwin](INSTALLATION.md#build-on-cygwin)`

			`Tarball:`

			`* [build and install tarball](INSTALLATION.md#build-and-install-tarball)`

			`## Configuration`
Polishing readme. 2015-02-18 13:38:27 +08:00			`Optionally configure HSTR just by running:`
MD Shell > bash highlighting 2014-01-27 02:30:09 +08:00			```bash
MD 2014-01-27 01:27:28 +08:00			`hh --show-configuration >> ~/.bashrc`
			```
Documentation polishing. 2015-01-08 06:44:07 +08:00			For detailed `hh` configuration documentation please refer to [Configuration](CONFIGURATION.md).
Adding Mac howto to MD (credits goess to Alex) 2014-01-13 14:23:02 +08:00

Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`## Documentation`
Refactoring documentation to multiple files. 2015-01-08 05:36:50 +08:00			Check `hh` man page:
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00
Improving man page and MD (env var options). 2014-02-01 02:46:18 +08:00			```bash
Refactoring documentation to multiple files. 2015-01-08 05:36:50 +08:00			`man hh`
MD 2014-01-27 01:27:28 +08:00			```
MD 2014-01-27 01:14:47 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`## In the News`
Update README.md 2016-11-01 16:30:45 +08:00			Read about `hh` in [LinuxMagazine](http://www.linux-magazine.com/Issues/2014/164/Bash-History-on-Steroids), [UbuntuGeek](http://www.ubuntugeek.com/tag/hstr-bash-history), [DebianAdmin](http://www.debianadmin.com/hstr-easily-view-navigate-search-and-use-your-command-history-with-shell-history.html), [Tuxdiary](https://tuxdiary.com/2015/02/17/hstr/) or [Softpedia](http://linux.softpedia.com/get/Terminals/BASH-Command-History-Completion-103155.shtml).
Update README.md 2016-11-01 16:30:00 +08:00
MD 2014-01-27 01:14:47 +08:00
Significant documentation improvements, fixes and rewrites. 2018-08-12 02:14:46 +08:00			`## Bugs`
Changing download address. 2013-12-03 15:54:19 +08:00			`https://github.com/dvorka/hstr/issues`