FBLESS(1)

📦
version 0.2.3 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 FBLESS(1) 💖

okay bestie, gather round, because we're talking about fbless — the console fb2 reader that is genuinely iconic and also lowkey invisible to interact with. iykyk. 🌸

✨ NAME ✨

fbless — a console fb2 reader. that's it, that's the whole vibe. she reads fb2 books in your terminal and she does it beautifully. 🎀

🌈 SYNOPSIS 🌈

fbless { book.fb2 | book.fb2.{zip | gz | bz2} }

so you can feed her a plain book.fb2, or the same book all zipped / gzipped / bzipped up. she's flexible like that. 💅

👑 DESCRIPTION 👑

Fbless pops open a full-size ncurses window with the entire book content displayed, and the only little sliver of user interface is the statusbar chillin' at the bottom. no menus, no clutter, no noise. main character minimalism.

interaction with the program is invisible — vim style, literally no visible buttons — and you drive her with these default keys:

  • Up, k — scroll one line up ⬆️
  • Down, j — scroll one line down ⬇️
  • PgUp — scroll one page up 📄
  • Space, PgDown — scroll one page down 📃
  • Home, g — scroll to the beginning of file 🏁
  • End — scroll to the end of file 🔚
  • 5, G — move to a position in the file. she'll interactively ask you for a percent value in the range from 0 to 100, where 0 is the beginning of file and 100 is the end of file. so it's not literally the key "5", bestie, it's the whole percent-number-then-G situation 🎯
  • Tab — move pointer on the next link 🔗
  • Enter, Right — follow the link under the pointer 🫶
  • Left, h — return back 🔙
  • Backspace, l — re-follow last link ⏭️
  • a — toggle auto-scroll mode 🔄
  • f — enable fifo-style scrolling 🌀
  • +, - — increase/decrease autoscroll interval (1sec granuality) ⏱️
  • / — search for regular expression 🔍
  • n — go to the next search result ➡️
  • s — toggle statusbar 🙈
  • q — quit 👋

and here's the part that actually changed my life: fbless saves your position in the file on quit, and restores it next time you open the same file — unless you moved it in the meantime. so she remembers where you were, but she's not gonna fight you about it. queen behaviour. 👑

💜 FILES 💜

  • ~/.fbless_save — the file where she stores last viewed positions in books 📌
  • ~/.fblessrc, $XDG_BASE_DIR/fbless/fblessrc — configuration file!! creating and editing it lets you customize colors, keybindings and some other options ✨ the default one is installed under /usr/share/doc/fbless 📂

🦋 NOTES 🦋

this manual page was written by Dmitry Bogatov for the Debian project, but it can be used by others under terms of GPLv2+ license. so like, share the love, legally. 💖

🌟 AUTHORS 🌟

Con Radchenko. 👑

and that's the whole page, bestie!! 🫶 this was fbless Manual, dated 2016-08-29, and honestly? she ate. go read a book in your terminal. periodt. 💅✨📚

📦 where this page comes from