iTerm

iTerm Info:

  • Home
  • News
  • FAQ
  • Download
  • Misc
  • Screenshots
  • Usage
  • Scripting
  • History
  • Extras
  • Localizations


  • Links:

  • Sourceforge project page
  • Request a feature
  • Submit a Bug

  • Google
    Web iterm.sourceforge.net


    SourceForge Logo
    FAQ
    • Why my arrow/HOME/END keys are not working?
      When the terminal type of your sessions is set to one of those "xterm" types, iTerm handles the arrow keys, the home key, and the end key in a special way. The escape sequences generated by these keys depend on if your session is in the normal mode or the cursor application mode. For the normal mode, iTerm generates ESC [ sequences. For the cursor application mode, iTerm generates ESC O sequences.

      These two modes are respected by many console programs. Most shells are good with the normal mode. Full screen applications such as vi and emacs usually use cursor application mode. Termcap and terminfo are written for full screen applications, so they will report the cursor application mode sequences.

      In any case, if your keys are not working, first check if iTerm is set to correct terminal type. The terminal type set in the terminal profile should match the TERM variable in your session environment. Scripts like bashrc may change the terminal type and create some problem. Secondly, check if there's any customized key bindings for these keys. These settings will override the default behavior. And lastly, check if you have set up your console application correctly. In some system, vi by default works in the original vi mode, which does not support arrow keys.

      If everything else fails, you can fire up another terminal program that works for you, check the escape sequences generated by arrow keys in those program, and go back to iTerm, type these key sequences in your keyboard profile.

    • I can't input Chinese/Japanese/Umlauts/Accents, why?
      First of all, make sure your encoding settings is correct. For example, there are several encoding standards for Chinese, you need to know which one is used on your system. If you are running a local session, unicode is the standard of Mac OS X.

      To enable inputing unicode characters in your shell, put this in your ~/.inputrc

      set meta-flag on
      set input-meta on
      set output-meta on
      set convert-meta off

      If you are running a telnet session, be sure you turned on the 8-bit data path. Try using "telnet -8 yourhost" in your command.

    • Where does iTerm store its settings?
      Since version 0.8.0, all the setting is stored in ~/Library/Preferences/iTerm.plist. In case something goes wrong, you can delete this file and iTerm will generate a new settings file that should always work.

    • My iTerm is too slow. What can I do to improve its performance?
      First of all, upgrade to the latest version. We are constantly updating the program to improve its performance. The latest version should run at least as fast as Apple's Terminal.app. Secondly, there are a couple of things you can tweak. iTerm does the fast drawing by caching the images of glyphs in the memory. Anything that helps to save memory helps the performance. Avoid using a big scrollback buffer. This would use a lot of memory especially if you have lots of tab open. Keeping windows geometry and font size small helps too. Disable anti-aliasing does a minimal effect on speed.

      Since version 0.9.0, there is a new option to allow users to adjust the display refresh rate. Fast refreshing rate means more CPU usage, and it might decrease performance when there is a lot of scrolling.

    • My settings of bookmarks do not seem to always work. Why?
      For various reasons, most size settings such as numbers of row/col, fonts, etc. need to be the same among all the tabs within a window. Therefore, only the settings of first tab in the window will be honored. You can however specifiy different terminal types, different colors, etc.

    • Does iTerm require mono-space fonts?
      Versions before 0.8 require monospace fonts. New version no longer requires monospace fonts. All fonts will be displayed in correct alignment.

    • The fonts are looking weird. What should I do?
      iTerm lets you to specify two fonts. If you only use English or western european languages, you probably only need to set the font for ASCII characters. For other languages, you need to specify a font that works with your language as the Non-ASCII font. You need to make sure the size (height) of two fonts do not differ greatly, so iTerm won't display a mess of mixed glyphs.

    • The anti-aliasing looks funny. Is there a way to adjust it?
      Yes, there is. There is a hidden setting of StrokeWidth and BoldStrokeWidth that you can play with. See the Resource page for details. Set them to 0 gives you a standard anti-alias rendering. Any negative number gives you a bolder look.

    • Characters on screen are not aligned correctly.
      Check the option for "use double width for Non-ASCII characters".

    • Can I completely hide the toolbar?
      Yes, you can. The oblong button on the top right corner of the window does the trick.


    Modified: Aug 31st, 2007
    Created: Dec 18th, 2002
    Fabian and Ujwal S. Setlur
    Support free software by writing one.