Preview

Features

wiki-tui currently has these features: - Browse through Wikipedia (Set the language by changing the url in the config) - Uses webscraping and a custom view to display wikipedia articles in the terminal - Use links to open other articles

These features are planned: - View and interact with more elements of wikipedia articles (like tables, images, etc.) - Better error handling

How it looks

Note: These Screenshots were taken on iTerm2 (MacOS) with the Fira Code font

Usage

If you want to search for an article quickly, you can pass the search term as an argument. wiki-tui <ARTICLE> wiki-tui then searches for this article automatically.

Controls

Key	Function
q	Quit the program (except when inside the search bar)
Up and Down	Scrolling
Left and Right	Select the next link (only in the article view)

Installation

The binary executable is wiki-tui

Cargo

cargo install wiki-tui

NetBSD

Using the package manager pkgin install wiki-tui Building from source cd /usr/pkgsrc/www/wiki-tui make install

Configuration

Location of the config file

MacOS, Linux and NetBSD

$HOME/.config/wiki-tui/config.toml

Windows

C:\Users\{USERNAME}\wiki-tui\config.toml

Settings

Default configuration ```toml [api] base_url = "https://en.wikipedia.org/" # this is the url of wikipedia, it can be changed to change the language of wikipedia

The settings here are all colors and can be set by either the name of the color or a hex string (valid formats are: #ffffff, #fff)

The actual colors displayed in your terminal can change depending on your terminal settings

[theme] background = "white" # color used for View backgrounds title = "red" # color used for the title text highlight = "red" # color used for highlighting text highlightinactive = "blue" # color used for highlighting inactive text highlighttext = "white" # color used for highlighted text text = "black" # color used for the text search_match = "red" # color used for a search match in the results view

You can also change the theme of specific views

These settings are the same for every supported view

[theme.searchbar] background = "white" title = "red" highlight = "red" highlightinactive = "blue" highlight_text = "white" text = "black"

Currently, these views are supported:

- search_bar

- search_results

- search_preview

- article_view

- toc_view

[logging] enabled = true # can be either true or false. enables/disables logging logdir = "wikitui.log" # location of the file where the log will be written to log_level = "Info" # log level to be used, can be Debug, Info, Warn, Error ```

Contributing

Any contributions you make are greatly appreciated.

Fork the Project
Switch to the experimental branch
Commit your Changes
Push to the branch
Open a Pull Request

Acknowledgements

cursive
Some parts of Best-README-Template