sheepla / fzwiki

🚀 A command line tool with fzf-like UI to search Wikipedia articles and open it in your browser quickly

fzwiki

A command line tool with fzf-like UI to search Wikipedia articles and open it in your browser quickly.

Usage

1. Run the command by specifying a search query.
2. Press the <Tab> key to select item(s), then press <Enter> key to confirm the selection.
3. The pages URL of the selected items will output. If you specify the -o, --open flag, it will open the page in your default browser.

Help message

fzwiki [OPTIONS] QUERY...

Application Options:
  -V, --version  Show version
  -o, --open     Open URL in your web browser
  -l, --lang=    Language for wikipedia.org such as "en", "ja", ...

Help Options:
  -h, --help     Show this help message

Key bindings

Key	Description
type some text	narrow down candidates
<C-j> / <C-n>	move focus down
<C-k> / <C-p>	move focus up
<Tab>	select the item
<Enter>	confirm the selection

Installation

Build from source

git clone https://github.com/sheepla/fzwiki.git
cd fzwiki
go install

Download executable binary

You can download executable binaries from the release page.

Latest Release

Use GitHub release installer tools

These tools make it easy to install executable binaries from GitHub Release.

with ghg:

ghg get sheepla/fzwiki  # Install
ls -l $(ghg bin)/fzwiki # It will exists executable

with relma:

Copy download link URL from Latest Release page, then run below.

relma init                           # Setup
relma install {{DOWNLOAD_LINK_URL}}  # Install
ls -l $(ghg bin)/fzwiki              # It will exists executable

with gh-install

gh install sheepla/fzwiki # Install
ls -l ~/.local/bin/fzwiki # It will exists executable

Configuration

To change the default language for Wikipedia, set a value in the environment variable FZWIKI_LANG .

FZWIKI_LANG="ja" fzwiki ... # --> search from ja.wikipedia.org instead of en.wikipedia.org

To make the setting persistent, add the following line to your rc file of the shell.

• bash (~/.bashrc) or zsh (~/.zshrc):

export FZWIKI_LANG="ja"

• fish (~/.config/fish/config.fish):

set -Ux FZWIKI_LANG ja

LICENSE

MIT

Contributing

Welcome! 💕

Author

Sheepla

fzwiki's Issues

プレビューウインドウのテキストが見切れてしまう

Add screenshot

Add feature: view article with less like pager

テストを書く

`--lang` を複数指定できるようにする

機能案

• 検索するWikipediaの言語を複数指定できるようにする
• 環境変数に言語名をセットすることで、デフォルトで検索する言語を変更できるようにする

仕様案

• -l, --lang オプションの引数にカンマで区切った言語名を指定する
• 環境変数 FZWIKI_LANG にカンマで区切った言語名を指定する

fzwiki QUERY...                             # --> search en.wikipedia.org (default)
fzwiki --lang ja,en QUERY...                # --> search ja.wikipedia.org, en.wikipedia.org
FZWIKI_LANG="ja,en" fzwiki QUERY...         # --> search ja.wikipedia.org, en.wikipedia.org
export FZWIKI_LANG="ja,en"; fzwiki QUERY... # --> search ja.wikipedia.org, en.wikipedia.org

Decompose functions to make them easier to test

GitHub releaseでバイナリを配布できるようにする