kotofetch is a small, configurable CLI tool that displays Japanese quotes in the terminal. It comes with built-in quotes and allows users to customize display options such as padding, width, translation display, and text styles.

You can install the stable release from the AUR:

yay -S kotofetch

When prompted, choose All to clean-build the package from the downloaded PKGBUILD.

Or by cloning the AUR from here:

git clone https://aur.archlinux.org/kotofetch.git
cd kotofetch
makepkg -si

If you use Nix, you can install kotofetch using those commands:

git clone https://github.com/hxpe-dev/kotofetch.git
cd kotofetch
nix-build

You can download prebuilt binaries for Linux, Windows and macOS from the Releases page.

Requires Rust and Cargo:

git clone https://github.com/hxpe-dev/kotofetch.git
cd kotofetch
cargo install --path .

After installation, you can run kotofetch from anywhere in your terminal.

You need to have a Japanese font installed on your machine.

One popular choice is the Noto CJK Font.

sudo pacman -S noto-fonts-cjk

sudo apt update
sudo apt install fonts-noto-cjk

sudo dnf install google-noto-cjk-fonts

sudo zypper install noto-fonts-cjk

brew tap homebrew/cask-fonts
brew install --cask font-noto-sans-cjk

User configuration lives in:

~/.config/kotofetch/config.toml                       # On Linux
~/Library/Application Support/kotofetch/config.toml   # On macOS
%APPDATA%\kotofetch\config.toml                       # On Windows

Here you can customize:

• horizontal_padding / vertical_padding - spacing around quotes
• width - max width for text wrapping (0 for automatic width)
• show_translation - translation mode ("none", "english", "romaji")
• quote_color - named ANSI colors ("red", "yellow", "dim", etc.) or hex ("#ffcc00")
• translation_color - named ANSI colors ("red", "yellow", "dim", etc.) or hex ("#ffcc00")
• border_color - named ANSI colors ("red", "yellow", "dim", etc.) or hex ("#ffcc00")
• font_size - small, medium, or large (adds spacing between characters)
• bold - bold Japanese text (true/false)
• border - show a box border (true/false)
• rounded_border - show rounded border (need border to be enabled) (true/false)
• source - show the quote source (true/false)
• modes - list of quote files to use (any .toml file in ~/.config/kotofetch/quotes/ or built-in)
• seed - RNG seed for random quotes (0 for random seed)
• centered - center text (true/false)
• dynamic - dynamic re-centering of the text (true/false)

Example config.toml:

[display]
horizontal_padding = 3
vertical_padding = 1
width = 50
show_translation = "romaji"
quote_color = "#a3be8c"
translation_color = "dim"
border_color = "#be8ca3"
font_size = "medium"
bold = true
border = true
rounded_border = true
source = true
modes = ["proverb", "anime"]
seed = 0
centered = true
dynamic = false

Built-in quotes are embedded in the binary. To add your own quotes, create:

~/.config/kotofetch/quotes/                       # On Linux
~/Library/Application Support/kotofetch/quotes/   # On macOS
%APPDATA%\kotofetch\quotes\                       # On Windows

• Place any .toml file there.
• The filenames can be arbitrary, the program automatically reads all .toml files in this folder.
• Each .toml must follow this structure:

[[quote]]
japanese = "逃げちゃダメだ"
translation = "You mustn't run away."
romaji = "Nigeccha dame da"
source = "Neon Genesis Evangelion"

[[quote]]
japanese = "人は心で生きるんだ"
translation = "People live by their hearts."
romaji = "Hito wa kokoro de ikiru nda"
source = "Your Name"

• These custom quotes automatically merge with the built-in ones.

You can see the built-in quotes in the quotes folder.

kotofetch                               # display a quote following the config
kotofetch --horizontal-padding 3        # override specific config parameter temporarily
kotofetch --modes anime,mycustomquotes  # display quotes from specific files

Contributions are welcome! Here's how you can help:

1. Fork the repository.
2. Clone your fork locally:

git clone https://github.com/YOUR_USERNAME/kotofetch.git
cd kotofetch

3. Create a branch for your changes:

git checkout -b feature/my-feature

4. Make changes and commit:

git add .
git commit -m "Add my feature"

5. Push your branch:

git push origin feature/my-feature

6. Open a Pull Request on GitHub!

Made with ❤️ by hxpe
If you enjoy kotofetch, consider starring the GitHub repository!