• Stars
    star
    117
  • Rank 300,209 (Top 6 %)
  • Language
    Shell
  • License
    GNU General Publi...
  • Created almost 4 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

📠 Dynamic fetch displayer that SuperB

📢 Check out DIYfetch, the ultimate fetch tool template. It's the successor to SuperB Fetch!

License: GPL-3.0 Development completed

💡 About

SuperB Fetch (a.k.a bfetch) is a SuperB general-purpose fetch displayer written in portable sh that takes user commands output and dynamically changes how it displays output based on the terminal size.

Note Check how people rice SuperB Fetch at Bfetchporn.

📔 Story

As a Linux ricer, I like to make Neofetch automatically run when the terminal starts. This was fine until I switched to using a tiled window manager, the terminal is often too small leading to the fetch getting cropped off, even with Pfetch, the problem would appear. This has led me to create SuperB Fetch, a dynamic fetching tool with the customization spirit of Ufetch.

Neofetch Pfetch
Without SuperB Fetch Neofetch Pfetch
With SuperB Fetch Bfetch Bfetch

✨ Features

  • Super minimum with exactly 256 lines of sh and no dependencies (if you don't count sh).
  • Super flexible:
    • Align/shift/change mode contents based on terminal size.
    • Hide some elements if terminal is too small.
  • Super customizable:
    • SuperB Fetch can take commands output and use it. By so, SuperB Fetch can display anything you want, however you want.
    • And even more config options
  • Have two mode:
Paper mode Classic mode
Paper mode Classic mode

🚀 Setup

🧾 Dependencies

📥 Installation

🔧 Manually

Option 1: using curl

curl https://raw.githubusercontent.com/NNBnh/bfetch/main/bin/bfetch > ~/.local/bin/bfetch
chmod +x ~/.local/bin/bfetch

Option 2: using git

git clone https://github.com/NNBnh/bfetch.git ~/.local/share/bfetch
ln -s ~/.local/share/bfetch/bin/bfetch ~/.local/bin/bfetch

📦 Package manager

For Arch-Linux base distro, install this AUR package:

paru -Sy superbfetch-git

For Bpkg user:

bpkg install NNBnh/bfetch

For Basher user:

basher install NNBnh/bfetch

Note If you can and want to port SuperB Fetch to other package managers, feel free to do so.

⌨️ Usage

Run SuperB Fetch in the terminal:

bfetch

⚙️ Configuration

SuperB Fetch is configured through environment variables: export BFETCH_<SETTING>="<value>"

Value Valid Default Description
BFETCH_INFO <commands> $XDG_CONFIG_HOME/bfetch/info (~/.config/bfetch/info) Read this commands output as infomation element (OS, WM, terminal, ...)
BFETCH_ART <commands> $XDG_CONFIG_HOME/bfetch/art (~/.config/bfetch/art) Read this commands output as art element (operating system logo)
BFETCH_COLOR <commands> $XDG_CONFIG_HOME/bfetch/color (~/.config/bfetch/color) Read this commands output as color element (colors strip below info)
BFETCH_TEMPORARY <path/to/file> /tmp/bfetch Temporary file's location
BFETCH_CLASSIC_MODE true|false false Make SuperB Fetch prefer classic mode when both mode are possible
BFETCH_ART_RIGHT true|false false Render art on the right when using classic mode
BFETCH_PADDING 0+ 1 Padding fetch when using classic mode
BFETCH_SEPARATOR 0+ 2 Separate info and art when using classic mode
BFETCH_PROMPT_HEIGHT 0+ 1 Acknowledge how high the shell prompt is and counter it so the prompt don't push the fetch out

SuperB Fetch will export the maximum size that an element can get:

Value Description
BFETCH_INFO_HEIGHT Maximum height of infomation element
BFETCH_INFO_WIDTH Maximum width of infomation element
BFETCH_ART_HEIGHT Maximum height of art element
BFETCH_ART_WIDTH Maximum width of art element
BFETCH_COLOR_HEIGHT Maximum height of color element
BFETCH_COLOR_WIDTH Maximum width of color element

ℹ️ Info element

SuperB Fetch looking for and execute $XDG_CONFIG_HOME/bfetch/info for info element as default, you can copy this info template with Fetchutils as a starting point and customizing.

Note Make sure the file is executable

🖼️ Art and color element

For art element and color element, take a look at NNB's ANSI collections and other textart resources.

💌 Credits

Special thanks to:






Made with ❤️ by NNB

Buy Me a Coffee

More Repositories

1

superb-bootstrap

🅱️ OS dotfiles-manager framework that SuperB
Shell
115
star
2

textart-collections

🖼️ The most ambitious textart collections
Shell
51
star
3

dotfiles

📂 My personal Đotfiles
Lua
51
star
4

bmono

🏷️ Mono font that SuperB
35
star
5

ansi

🖼️ My personal ANSI art collections
34
star
6

coderun

⏯️ Code runner CLI that can run any languages
Shell
24
star
7

da-one

🎨 Da one color scheme that you alway looking for
10
star
8

NNBnh

👤 My profile
9
star
9

dino-assets

🍱 Assets for Kazoku's Dino clone
8
star
10

minecraft-bookmarks

🧾 My personal list of Minecraft stuff
8
star
11

superb-st

📟 ST-base terminal with enough patches
C
8
star
12

mk

📄 SuperB way to create new folders and files
Shell
7
star
13

coderun.kak

⏯️ Kakoune code runner
KakouneScript
7
star
14

kickstart.zsh

🏁 A launch point for your personal .zshrc
Shell
7
star
15

bmap.kak

🔖 Kakoune key-binding that SuperB (WIP)
KakouneScript
7
star
16

base16-da-one-schemes

🎨 Da one color scheme that you alway looking for
6
star
17

orml

🍊 Orange markup language
6
star
18

wallpapers

🖼️ My personal wallpaper collections
6
star
19

terminal-explorer

📋 Bring file manager's copy/paste to the CLI
Shell
6
star
20

noi-tu

🔤 Vietnamese words connect game
JavaScript
6
star
21

craft-everything

📗 Minecraft crafting recipes collections (Abandoned)
6
star
22

clipb

📋 Clipboard managers warper that SuperB
Shell
6
star
23

hr

📏 Portable horizontal ruler for terminal
Shell
6
star
24

sed-collections

📑 My personal sed script collections
sed
4
star
25

bui.kak

🎨 BUI for Kakoune
4
star
26

NNBnh.github.io

👤 My profile
HTML
3
star
27

base16-terminal.kak

🎨 Base16 color scheme using terminal color for Kakoune
KakouneScript
3
star
28

bsymlink

🔗 Batch symlink tool that SuperB
Shell
3
star
29

flappybirdart

🍱 FlappyBird-like assets for Lê Đức's game
3
star
30

web-nang-cao

Học lập trình web nâng cao
PHP
2
star
31

scriptrun

⏯️ Code runner that can run any languages
2
star
32

bmap

⌨️ SuperB Keymap System
2
star
33

chess-logo

♟️ Chess logo/avarta/icon
2
star
34

life.rb

⠬⠆My simple "Conway's Game of Life" in Ruby
Ruby
2
star
35

bangs4all

2
star
36

bfetch-old

Fetch that SuperB
Shell
2
star
37

wordle_cli

🔤 A simple CLI Wordle game
Ruby
2
star
38

fruits-shop

🍋 Online fruits shop website
Nunjucks
2
star
39

blogs

2
star
40

cam-nang-c

📕 Cẩm nang lập trình C của Nhật Anh Nguyễn
C
1
star
41

nur-packages

NNB's Nix User Repository
Nix
1
star
42

csharp-2022

1
star
43

smwc-api

Ruby
1
star
44

bui

🎨 UI and colors management that SuperB
1
star
45

noi-tu-webpage

🔤 Trò chơi nối từ tiếng Việt 100 người chơi
HTML
1
star
46

bkey-vim

Vim key-binding that SuperB (Dead)
Vim Script
1
star
47

2048.rb

2️⃣ My simple 2048 game in Ruby
Ruby
1
star
48

tom-lang

🎉🎁🎉
JavaScript
1
star
49

adidas

👟 Online Adidas*-N'T shop website
Nunjucks
1
star
50

osu-arcade

🕹️ My personal Osu! mix skin
1
star
51

copr

📃 Spec files for my COPR packages
1
star
52

bui-terminal

🎨 BUI for terminal
Shell
1
star
53

sex_utils

🗂️ Shell Explorer: convenient files management utilities (WIP)
Ruby
1
star
54

super-central-browser

Svelte
1
star
55

bmap-helix

⌨️ Bmap keybind for Helix
Ruby
1
star
56

base24-da-one-schemes

🎨 Da one color scheme that you alway looking for
1
star
57

cb

📋 Clipboard managers warper written in POSIX sh (mirror)
Shell
1
star
58

blog

📚 Blog that SuperB
Nunjucks
1
star
59

pathshortener

✂️ File system's path shortener
Shell
1
star