From ArchWiki
Revision as of 01:15, 2 December 2011 by Sara (Talk | contribs)

Jump to: navigation, search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Template:Article summary start Template:Article summary text Template:Article summary end

fbpad is a small framebuffer terminal that manages many terminals through single character tags. It is exceptionally lightweight, being written in C and using its own font format, tinyfont, which avoids xorg font dependencies. fbpad optionally supports 256 colors, bold fonts, and saving the framebuffer contents to memory, all which combined make fbpad a viable alternative to the X server for many purposes.


fbpad can be installed from the AUR, which by default imports the "bold" and "scrsnap" branches of fbpad, which add in 256-colors and bold fonts, and saving the contents of the framebuffer, respectively. fbpad is customized via the Template:Filename file, and edits to the Template:Filename file are incorporated into fbpad after recompiling fbpad, using the command Template:Codeline.


Users most likely will want to edit the definitions in the Template:Filename for fonts (more on this later), Template:Codeline, Template:Codeline, and Template:Codeline prior to use, to their preferred programs.

The following patch enables defining programs in the Template:Filename that have arguments:

diff --git a/term.c b/term.c
index 08355d6..bd79757 100644
--- a/term.c
+++ b/term.c
@@ -301,11 +301,11 @@ void term_exec(char *cmd)
 	if (!term->pid) {
 		char *envp[MAXENV] = {"TERM=linux"};
-		char *argv[2] = {cmd};
+		char *argv[] = {"sh", "-c", cmd, NULL};
 		envcpy(envp + 1, environ);
-		execvep(cmd, argv, envp);
+		execvep(argv[0], argv, envp);

Save the patch as Template:Filename, add Template:Codeline to your source array, and the following line to the Template:Filename after the line that copies the Template:Filename file:

patch -p1 -i "${srcdir}/${_gitname}-spaces.diff" || return 1

dwm users should have no problems accustoming to fbpad. fbpad-specific keybindings are initiated with the modifier key, which is hardcoded as the Template:Keypress key, just like in dwm. Template:Keypress + Template:Keypress and Template:Keypress + Template:Keypress switch between terminals in an open tag, Template:Keypress + Template:Keypress switches to the last open tag, and Template:Keypress + Template:Keypress shows the list of open tags, to name a few. Users comfortable with patching source code can edit the Template:Filename file to edit/add keybindings.

If you re-compile fbpad often, you would probably like to be able to reload fbpad without having to manually re-launch it. The following code starts fbpad post login in tty1 and will reload it if you quit fbpad with Template:Keypress + Template:Keypress + Template:Keypress.

if [[ $(tty) = /dev/tty1 ]]; then
  while true; do
    fbpad >/dev/null 2>&1

Place this at the end of your shellrc file.

Tag Colors

The default background of the list of tags is hardcoded as white, the foreground of empty tags as black, the foreground of fully occupied tags as green (each tag may contain two terminals), and the foreground of tags that are not fully occupied as blue. This color scheme clearly is not for everyone, but this is easily remedied with the following patch:

--- a/fbpad.c	2011-11-11 13:02:22.834825518 -0500
+++ b/fbpad.c	2011-11-11 13:04:07.016043271 -0500
@@ -110,7 +110,7 @@
 static void showtags(void)
-	int colors[] = {15, 4, 2};
+	int colors[] = {8, 2, 9};
 	int c = 0;
 	int r = pad_rows() - 1;
 	int i;
@@ -128,7 +128,7 @@
 		pad_put(i == ctag ? '(' : ' ', r, c++, FGCOLOR, BGCOLOR);
 		if (TERMSNAP(i))
-			pad_put(tags[i], r, c++, !nt ? BGCOLOR : colors[nt], 15);
+			pad_put(tags[i], r, c++, !nt ? 8 : colors[nt], BGCOLOR);
 			pad_put(tags[i], r, c++, colors[nt], BGCOLOR);
 		pad_put(i == ctag ? ')' : ' ', r, c++, FGCOLOR, BGCOLOR);

To use, replace "8" with the desired color for empty tags (in both instances), "2" with the desired color for not fully occupied tags, and "9" with the desired color for fully occupied tags, where the colors 0-15 are defined in the Template:Filename file. This patch also makes the default background color the background color of your terminal, which the writer finds to be a more natural choice.

Note that the second "8" is the color for tags for which fbpad saves the framebuffer contents. If you choose to leave Template:Codeline defined as Template:Codeline, then you will want your default foreground color and the color for saved tags to be the same, i.e. "8" in both instances. Otherwise, you may define Template:Codeline as a concatenated string of the tags to be saved, and change the second "8" to the color you wish to indicate saved tags by. The writer herself saves all tags for convenience.

Save the patch as Template:Filename, add Template:Codeline to your source array, and the following line to the Template:Filename after the line that copies the Template:Filename file:

patch -p1 -i "${srcdir}/${_gitname}-tagcolor.diff" || return 1


The font format for fbpad is the "tinyfont", and there exists a utility, ft2tfAUR, which converts TTF files to the tinyfont format. You will need to edit the Template:Filename file in the ft2tf build directory to point to the TTF file of your desired font. For instance, if the font file Template:Filename was located in Template:Filename directory, you would edit line 10 of the Template:Filename to look like the following:

{"/home/archie/.fonts/MonteCarloFixed12.ttf", 6},

if your username was "archie", and the font size of Monte Carlo you wished to create was size 6. Delete other font lines you see other than this one, unless you wish to supplement your font with the glyphs from another font, in which case, add lines like the one above for your other TTF fonts.

Then, run Template:Codeline to rebuild and reinstall the package with your customized settings.

After installing ft2tf, the following command creates a tinyfont file:

$ ft2tf > MyFont.tf

where "MyFont" can be replaced with a name of your choosing.

Remember to edit your Template:Filename to point to the directory where you save your Template:Filename. If your font also has a bold face, repeat the process of editing the ft2tf Template:Filename file, this time specifying the location of the boldface TTF file in the ft2tf Template:Filename, rebuilding with makepkg, and adding the final boldface tinyfont location to your fbpad Template:Filename.

Also note that some fonts might require modification of the Template:Codeline and Template:Codeline to have the proper width and height, respectively.

Color Support

By default, the AUR package installs the custom terminfo for fbpad, but you will need to add
export TERM=fbpad-256
to your shellrc to take advantage of the color support. Clearly, commands not spawned in your default shell (for instance, those for Template:Codeline and Template:Codeline) will not read your shellrc file, so you will need to edit their definitions in your Template:Filename file to have the commands for Template:Codeline and Template:Codeline run in a parent shell. For instance, the author of this article, who uses zsh, changed the default command for Template:Codeline from:
#define MAIL		"mailx"


#define MAIL		"zsh -i -c mailx"

taking advantage of the above patch that enabled commands with arguments in the Template:Filename file.

Additionally, to have colors with the Template:Codeline command, "fbpad-256" needs to be added to the list of terms that Template:Codeline knows can handle color. Per the Template:Filename, run the following command in your shell:

$ dircolors --print-database | sed '/^TERM linux$/aTERM fbpad-256' >$HOME/.dircolors

and add Template:Codeline to your shellrc file so that the custom dircolors file, with the fbpad-256 term added, may be loaded.


The following are examples of how some general desktop needs may be implemented in fbpad.

Copying Text

As everything is done mouselessly in fbpad, to copy text, users can make a "screenshot" of all the text on the screen with the Template:Keypress command. This will save all viewable text to the file Template:Filename. Then, if your shell supports editing the commandline with vim (for instance, the edit-command-line ZLE function in zsh), you can open the Template:Filename file as a new buffer in vim and use its copy keybindings to paste the needed text into your original buffer. Emacs users probably can adopt a similar scheme to copy text.

Watching YouTube

If one is using mplayer with the Template:Codeline option, youtube-viewerAUR is available in the AUR for searching YouTube and watching with mplayer from the commandline. Alternatively, one can add the following script as an external browser in the commandline web browser w3m, and launch playback of videos from YouTube websites with your media player of choice. The script below employs fbff-gitAUR, a lightweight media player also written by the author of fbpad, and yturlAUR, a simple program, that, rather UNIX-like, functions solely to convert YouTube URLs into directly watchable URLs.

video=$(yturl $1)
fbff -f $video > /dev/null 2>&1

Save the file in your Template:Codeline as Template:Filename, and add it as an external browser to w3m by opening w3m, hitting the Template:Keypress key to edit options, and edit the "External Browser" field under "External Program Settings" by entering in the field "youtube.sh". Hit "OK", and you are done. Now, when wishing to watch a video, with YouTube open, hit the Template:Keypress key, and the video will begin streaming instantly in fbff.

Framebuffer Programs

Here are a few recommendations for programs that significantly enhance the usability of fbpad:

  • cnoor-gitAUR - a holy Quran viewer, using pango for rendering
  • dvtm - a dynamic virtual terminal manager (think dwm, but for the console)
  • fbcatAUR - a framebuffer screenshot grabber
  • fbff-gitAUR - an ffmpeg-based media player
  • fbpdf-gitAUR - a MuPDF-based PDF viewer, optionally supports DjVu or rendering via poppler
  • fbv - an image viewer

External Links