man pages section 1: User Commands

Exit Print View

Updated: July 2014

xvidtune (1)


xvidtune - video mode tuner for Xorg


/usr/bin/xvidtune  [  -show  |  -prev  | -next | -unlock ] [
-toolkitoption ... ]


User Commands                                         xvidtune(1)

     xvidtune - video mode tuner for Xorg

     /usr/bin/xvidtune  [  -show  |  -prev  | -next | -unlock ] [
     -toolkitoption ... ]

     Xvidtune is a client interface to the X  server  video  mode
     extension (XFree86-VidModeExtension).

     When given one of the non-toolkit options, xvidtune provides
     a command line interface to either print or switch the video

     Without  any  options  (or  with  only  toolkit  options) it
     presents the user with various buttons and sliders that  can
     be  used  to  interactively adjust existing video modes.  It
     will also print the settings in a format suitable for inclu-
     sion in an xorg.conf file.

     Normally  the  Xorg  X servers only allow changes to be made
     with the XFree86-VidModeExtension from clients connected via
     a local connection type.

     Note:   The original mode settings can be restored by press-
     ing the `R' key, and this can be used to  restore  a  stable
     screen in situations where the screen becomes unreadable.

     The available buttons are:

               Adjust  the video mode so that the display will be
               moved in the appropriate direction.

               Adjust the video mode so that the display size  is
               altered appropriately.

     Quit      Exit the program.

     Apply     Adjust   the  current  video  mode  to  match  the
               selected settings.

     Auto      Cause    the    Up/Down/Right/Left,     Wider/Nar-
               rower/Shorter/Taller,  Restore, and the special S3

X Version 11       Last change: xvidtune 1.0.3                  1

User Commands                                         xvidtune(1)

               buttons to be applied  immediately.   This  button
               can be toggled.

     Test      Temporarily switch to the selected settings.

     Restore   Return the settings to their original values.

     Fetch     Query the server for its current settings.

     Show      Print the currently selected settings to stdout in
               xorg.conf "Modeline" format.  The  primary  selec-
               tion is similarly set.

     Next      Switch the Xserver to the next video mode.

     Prev      Switch the Xserver to the previous video mode.

     For some S3-based cards (964 and 968) the following are also

               Change the VCLK invert/non-invert state.

     EarlySC   Change the Early SC state.   This  affects  screen

               Set  the  blank delay values.  This affects screen
               wrapping.  Acceptable values are in the range 0-7.
               The  values may be incremented or decremented with
               the `+' and `-' buttons, or by pressing the `+' or
               `-' keys in the text field.

     For S3-864/868 based cards InvertVCLK and BlankDelay1 may be
     useful.  For  S3  Trio32/Trio64  cards  only  InvertVCLK  is
     available.   At  the  moment  there  are no default settings
     available for these chips in the video  mode  extension  and
     thus  this  feature  is  disabled  in  xvidtune.   It can be
     enabled by setting any of the optional S3  commands  in  the
     screen section of xorg.conf, e.g. using
               blank_delay "*" 0

     xvidtune accepts the standard X Toolkit command line options
     as well as the following:

     -show     Print the current settings to stdout in  xorg.conf
               "Modeline" format and exit.

     -prev     Switch the Xserver to the previous video mode.

X Version 11       Last change: xvidtune 1.0.3                  2

User Commands                                         xvidtune(1)

     -next     Switch the Xserver to the next video mode.

     -unlock   Normally,  xvidtune  will disable the switching of
               video modes via hot-keys while it is running.   If
               for  some  reason the program did not exit cleanly
               and they are still disabled, the  program  can  be
               re-run  with  this  option  to  re-enable the mode
               switching key combinations.

     xrandr(1), Xorg(1), xorg.conf(4).

     Kaleb S. Keithley, X Consortium.
     Additions and modifications by Jon Tombs, David  Dawes,  and
     Joe Moss.

     X  Error handling, i.e. when the server does not allow xvid-
     tune clients to write new modes, could be better.

     See  attributes(5)  for  descriptions   of   the   following

     |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
     |Availability                 |x11/xvidtune                 |
     |Interface Stability          |Volatile                     |

X Version 11       Last change: xvidtune 1.0.3                  3