hike


Namehike JSON
Version 1.1.0 PyPI version JSON
download
home_pageNone
SummaryA Markdown browser for the terminal
upload_time2025-07-09 16:15:46
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseGNU General Public License v3 or later (GPLv3+)
keywords chui documentation file-browser file-viewer markdown markdown-viewer terminal tui
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Hike

[![Hike](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-social-banner.png)](https://hike.davep.dev/)

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/davep/hike/style-lint-and-test.yaml)](https://github.com/davep/hike/actions)
[![GitHub commits since latest release](https://img.shields.io/github/commits-since/davep/hike/latest)](https://github.com/davep/hike/commits/main/)
[![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/davep/hike)](https://github.com/davep/hike/issues)
[![GitHub Release Date](https://img.shields.io/github/release-date/davep/hike)](https://github.com/davep/hike/releases)
[![PyPI - License](https://img.shields.io/pypi/l/hike)](https://github.com/davep/hike/blob/main/LICENSE)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/hike)](https://github.com/davep/hike/blob/main/pyproject.toml)
[![PyPI - Version](https://img.shields.io/pypi/v/hike)](https://pypi.org/project/hike/)

## Introduction

Hike is a [Markdown](https://commonmark.org/help/) browser for the terminal.
It provides the ability to browse for and view local Markdown files, as well
as Markdown files that can be downloaded from the web. It also has shortcuts
that make it easy to view Markdown files on popular git forges.

## Installing

### pipx

The application can be installed using [`pipx`](https://pypa.github.io/pipx/):

```sh
pipx install hike
```

### Homebrew

The package is available via Homebrew. Use the following commands to install:

```sh
brew tap davep/homebrew
brew install hike
```

### Other installation methods

The following installation methods have been provided by third parties;
please note that I can't vouch for them myself so use them at your own risk.

#### X-CMD

The application can be installed using [`x-cmd`](https://x-cmd.com):

```sh
x install hike
```

## Using Hike

Once you've installed Hike using one of the above methods, you can run the
application using the `hike` command.

The best way to get to know Hike is to read the help screen. Once in the
application you can see this by pressing <kbd>F1</kbd>.

![Hike Help](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-help.png)

Commands can also be discovered via the command palette
(<kbd>ctrl</kbd>+<kbd>p</kbd>):

![The command palette](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-command-palette.png)

For more information and details on configuring Hike, see [the online
documentation](https://hike.davep.dev/).

## Features

- A command line where file names, URLs and commands can be entered.
- A local file browser.
- A simple bookmarking system.
- A browsing history.
- The ability to edit markdown documents in the local filesystem, either
  using your editor of choice or a simple builtin editor.
- Commands for quickly loading and viewing files held on GitHub, GitLab,
  Codeberg and Bitbucket.
- A command palette to make it easy to discover commands and their keys.
- A rich help screen to make it easy to discover commands and their keys.
- [Possibly more as time goes on](https://github.com/davep/hike/issues?q=is%3Aissue+is%3Aopen+label%3ATODO).

### Editing

As mentioned above, Hike has support for editing markdown documents you're
viewing from the local filesystem. While a builtin editor is provided, use
of your own choice of editor is supported. If Hike finds that `$VISUAL` or
`$EDITOR` are set in your environment then the resulting command will be
used to edit the document (with `$VISUAL` being tried first, followed by
`$EDITOR`).

## File locations

Hike stores files in a `hike` directory within both
[`$XDG_DATA_HOME` and
`$XDG_CONFIG_HOME`](https://specifications.freedesktop.org/basedir-spec/latest/).
If you wish to fully remove anything to do with Hike you will need to
remove those directories too.

Expanding for the common locations, the files normally created are:

- `~/.config/hike/configuration.json` -- The configuration file.
- `~/.local/share/hike/*.json` -- The locally-held data.

## Getting help

If you need help, or have any ideas, please feel free to [raise an
issue](https://github.com/davep/hike/issues) or [start a
discussion](https://github.com/davep/hike/discussions).

## TODO

See [the TODO tag in
issues](https://github.com/davep/hike/issues?q=is%3Aissue+is%3Aopen+label%3ATODO)
to see what I'm planning.

[//]: # (README.md ends here)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hike",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "chui, documentation, file-browser, file-viewer, markdown, markdown-viewer, terminal, tui",
    "author": null,
    "author_email": "Dave Pearson <davep@davep.org>",
    "download_url": "https://files.pythonhosted.org/packages/7e/81/27b0fe6337e58522bdbb84c78944c0872e9fb17f3a55f905b4ab17400866/hike-1.1.0.tar.gz",
    "platform": null,
    "description": "# Hike\n\n[![Hike](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-social-banner.png)](https://hike.davep.dev/)\n\n[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/davep/hike/style-lint-and-test.yaml)](https://github.com/davep/hike/actions)\n[![GitHub commits since latest release](https://img.shields.io/github/commits-since/davep/hike/latest)](https://github.com/davep/hike/commits/main/)\n[![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/davep/hike)](https://github.com/davep/hike/issues)\n[![GitHub Release Date](https://img.shields.io/github/release-date/davep/hike)](https://github.com/davep/hike/releases)\n[![PyPI - License](https://img.shields.io/pypi/l/hike)](https://github.com/davep/hike/blob/main/LICENSE)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/hike)](https://github.com/davep/hike/blob/main/pyproject.toml)\n[![PyPI - Version](https://img.shields.io/pypi/v/hike)](https://pypi.org/project/hike/)\n\n## Introduction\n\nHike is a [Markdown](https://commonmark.org/help/) browser for the terminal.\nIt provides the ability to browse for and view local Markdown files, as well\nas Markdown files that can be downloaded from the web. It also has shortcuts\nthat make it easy to view Markdown files on popular git forges.\n\n## Installing\n\n### pipx\n\nThe application can be installed using [`pipx`](https://pypa.github.io/pipx/):\n\n```sh\npipx install hike\n```\n\n### Homebrew\n\nThe package is available via Homebrew. Use the following commands to install:\n\n```sh\nbrew tap davep/homebrew\nbrew install hike\n```\n\n### Other installation methods\n\nThe following installation methods have been provided by third parties;\nplease note that I can't vouch for them myself so use them at your own risk.\n\n#### X-CMD\n\nThe application can be installed using [`x-cmd`](https://x-cmd.com):\n\n```sh\nx install hike\n```\n\n## Using Hike\n\nOnce you've installed Hike using one of the above methods, you can run the\napplication using the `hike` command.\n\nThe best way to get to know Hike is to read the help screen. Once in the\napplication you can see this by pressing <kbd>F1</kbd>.\n\n![Hike Help](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-help.png)\n\nCommands can also be discovered via the command palette\n(<kbd>ctrl</kbd>+<kbd>p</kbd>):\n\n![The command palette](https://raw.githubusercontent.com/davep/hike/refs/heads/main/.images/hike-command-palette.png)\n\nFor more information and details on configuring Hike, see [the online\ndocumentation](https://hike.davep.dev/).\n\n## Features\n\n- A command line where file names, URLs and commands can be entered.\n- A local file browser.\n- A simple bookmarking system.\n- A browsing history.\n- The ability to edit markdown documents in the local filesystem, either\n  using your editor of choice or a simple builtin editor.\n- Commands for quickly loading and viewing files held on GitHub, GitLab,\n  Codeberg and Bitbucket.\n- A command palette to make it easy to discover commands and their keys.\n- A rich help screen to make it easy to discover commands and their keys.\n- [Possibly more as time goes on](https://github.com/davep/hike/issues?q=is%3Aissue+is%3Aopen+label%3ATODO).\n\n### Editing\n\nAs mentioned above, Hike has support for editing markdown documents you're\nviewing from the local filesystem. While a builtin editor is provided, use\nof your own choice of editor is supported. If Hike finds that `$VISUAL` or\n`$EDITOR` are set in your environment then the resulting command will be\nused to edit the document (with `$VISUAL` being tried first, followed by\n`$EDITOR`).\n\n## File locations\n\nHike stores files in a `hike` directory within both\n[`$XDG_DATA_HOME` and\n`$XDG_CONFIG_HOME`](https://specifications.freedesktop.org/basedir-spec/latest/).\nIf you wish to fully remove anything to do with Hike you will need to\nremove those directories too.\n\nExpanding for the common locations, the files normally created are:\n\n- `~/.config/hike/configuration.json` -- The configuration file.\n- `~/.local/share/hike/*.json` -- The locally-held data.\n\n## Getting help\n\nIf you need help, or have any ideas, please feel free to [raise an\nissue](https://github.com/davep/hike/issues) or [start a\ndiscussion](https://github.com/davep/hike/discussions).\n\n## TODO\n\nSee [the TODO tag in\nissues](https://github.com/davep/hike/issues?q=is%3Aissue+is%3Aopen+label%3ATODO)\nto see what I'm planning.\n\n[//]: # (README.md ends here)\n",
    "bugtrack_url": null,
    "license": "GNU General Public License v3 or later (GPLv3+)",
    "summary": "A Markdown browser for the terminal",
    "version": "1.1.0",
    "project_urls": {
        "Discussions": "https://github.com/davep/hike/discussions",
        "Documentation": "https://hike.davep.dev/",
        "Homepage": "https://hike.davep.dev/",
        "Issues": "https://github.com/davep/hike/issues",
        "Repository": "https://github.com/davep/hike",
        "Source": "https://github.com/davep/hike"
    },
    "split_keywords": [
        "chui",
        " documentation",
        " file-browser",
        " file-viewer",
        " markdown",
        " markdown-viewer",
        " terminal",
        " tui"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b6acb57f120f72683424d325678315d94fa1c4559d7cef934d6f7d5a5806a030",
                "md5": "1d192f2b669cfe3a4fffacb61a56423c",
                "sha256": "03d1f0fff03d7a2e9dcb20dc24cd39e6987cf2693f038758043348fa6509b1e7"
            },
            "downloads": -1,
            "filename": "hike-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1d192f2b669cfe3a4fffacb61a56423c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 63516,
            "upload_time": "2025-07-09T16:15:44",
            "upload_time_iso_8601": "2025-07-09T16:15:44.116914Z",
            "url": "https://files.pythonhosted.org/packages/b6/ac/b57f120f72683424d325678315d94fa1c4559d7cef934d6f7d5a5806a030/hike-1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7e8127b0fe6337e58522bdbb84c78944c0872e9fb17f3a55f905b4ab17400866",
                "md5": "7b9381f2027d45963ab45181acb8b120",
                "sha256": "31fb1abdb1cf6c6306501fb5df81c509a35def9ecee6b65cd7b758658ea29914"
            },
            "downloads": -1,
            "filename": "hike-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "7b9381f2027d45963ab45181acb8b120",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 721279,
            "upload_time": "2025-07-09T16:15:46",
            "upload_time_iso_8601": "2025-07-09T16:15:46.007153Z",
            "url": "https://files.pythonhosted.org/packages/7e/81/27b0fe6337e58522bdbb84c78944c0872e9fb17f3a55f905b4ab17400866/hike-1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-09 16:15:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "davep",
    "github_project": "hike",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "hike"
}
        
Elapsed time: 0.63113s