Skip to content

segrived/ftjerm

Repository files navigation

Ftjerm v0.12.3 (fork of Stjerm)

=============================== Ftjerm is a quake-style terminal and a fork of Stjerm. It is minimalistic and works well with compiz. Ftjerm can be configured via commandline or the .Xdefaults file. Screen The following list of options displays the .Xdefaults option first and then the commandline option. The commandline options have a higher priority and thus override the .Xdefaults options.

Improvements over the original version of Stjerm:

  • Improved: completely rewritten Makefile (no more autoconf / autogen).
  • Added: setting custom border width (not only choosing one of the proposed styles). (key -b)
  • Added: setting custom key for switching to the full-screen mode. (key -fk)
  • Added: turning on/off text cursor blinking. (key -cb)
  • Added: alternative cursor shape. (key -cs)
  • Added: option to hide cursor when the user presses a key and shown when the user moves the mouse. (key -ma)
  • Added: option to show terminal window on start (from ftjerm 0.12.1). (key -ss)

Requirements

pkgconfig, gtk2, vte

Installation / Uninstallation

sudo make install for installation

sudo make uninstall for uninstallation

Arch Linux users can install Ftjerm from AUR: https://aur.archlinux.org/packages.php?ID=58754

Frugalware Linux users can install Ftjerm from official site: http://frugalware.org/packages/153251 (by slown)

Changelog

Version 0.12.3

  • Fixed: Blank terminal with some shells. Should fix this issues (google code): n44 and n45

Version 0.12.2

  • Fixed: Toggle window down't work on some systems

Version 0.12.1

  • Added: showonstart option
  • Fixed: Unescaped dashes in manpage.

Running

Simply run: ftjerm.

Actions

--help: Displays menu with commandline options.

--info: Displays menu with .Xdefaults options.

--version: Display the current application version.

--toggle: Show/hide the current ftjerm instance.

Options

key, -k: Shortcut key which shows and hides ftjerm (eg: f12). If you don't specify a shortcut key, you can only show/hide ftjerm if you run ftjerm with --toggle.

fullscreenkey, -fk: Shortcut key which toggle fullscreen mode of ftjerm (eg: f2). Default: F11.

mod, -m: Modifier key, which has to be pressed in combination with the shortcut key to show/hide ftjerm: shift, control, alt, windows, none. Default: none.

keymod, -km: Modifier for keyboard shortcuts. Can be a combination (with +) of modifiers (eg: control+alt). Default: control+shift.

autohide, -ah: Whether or not to hide ftjerm when it looses focus. Default: true.

font, -fn: Terminal font and size (eg: Sans 10). Default: Fixed 9.

background, -bg: Background color of the terminal. If the terminal is transparent this is the tint color. Default: Black.

foreground, -fg: Foreground color of the terminal. This is the font color. Default: White.

allowbold, -ab: Allow bold fonts or not. Default: true

border, -b: Border width. Default: 0.

opacity, -o: Opacity (range: 0 - 100). If compositing is enabled ftjerm will use real transparency. Otherwise you get pseudo-transparency.

bgimage, -bgimg: Background image file. Specify the filename. Default: disabled.

width, -w: Window width, either as an integer or a percentage (eg, 50%). Default: 800.

height, -h: Window height, either as an integer or a percentage (eg, 50%). Default: 400.

position, -p: Window position: top, bottom, left, right. Default: top.

scrollbar, -s: Scrollbar position: left, right, none. Default: none.

shell, -sh: Terminal shell. Default: the user's default shell.

lines, -l: Scrollback lines. 0 to disable scrollback. Default: 1000.

showtab, -st: Tabbar visibility: never, one, always. One means the tabbar is visible if more than one tab is opened. Default: one.

tabpos, -tp: Tabbar position: top, bottom, left, right. Default: bottom.

tablabel, -tl: Label of the tabs. The terminal number gets appended automatically. Default: term.

tabfill, -tf: Whether tabs fill whole tabbar space. Default: true.

scroll, -sc: Whether to scroll the terminal on output. Default: true.

cursorblink, -cb: Cursor blink: system, on, off. Default: system.

cursorshape, -cs: Cursor shape: block, ibeam, underline. Default: block.

mouseautohide, -ma: Hide cursor when the user presses a key and shown when the user moves the mouse. Default: false.

colorX, -cX: Specify color X of the terminals color palette. You may specify no palette, or a complete one with 16 total colors. For this you have to use -c0, -c1, ..., -c15 or the equivalent color0, color1,... color15.

fixedX, -fX: Overrides the calculated horizontal position of the window. Specifies the location of the left of the window.

fixedY, -fY: Overrides the calculated vertical position of the window. Specifies the location of the top of the window.

allowreorder, -ar: Allows the tabs of the tab bar to be reordered.

showonstart, -ss: Show terminal window on start: true, false. Default: false.

Authors

Copyright (C) 2012-2013 - Holden Cox <segrived@gmail.com>
Copyright (C) 2011 - Mihail Szabolcs <szaby@szabster.net> (cursor blink and cursor shape parameters)
Copyright (C) 2008 - Kristopher Wilson <kristopherwilson@gmail.com>
Copyright (C) 2007 - Stjepan Glavina <stjepang@gmail.com>
Copyright (C) 2007 - Markus Gross <xsdnyd@gmail.com>

License

See LICENSE

Contact

Feature requests, patches or anything else related to ftjerm can be send to: segrived@gmail.com