thingmenu

A simple graphical menu launcher for X11.
git clone git://r-36.net/thingmenu
Log | Files | Refs | LICENSE

thingmenu.1 (2347B)

      1 .Dd July 02, 2011
      2 .Dt THINGMENU 1
      3 .Os
      4 .
      5 .Sh NAME
      6 .Nm thingmenu 
      7 .Nd a simple menu for X11
      8 .
      9 .Sh SYNOPSIS
     10 .Nm
     11 .Bk -words
     12 .Op Fl n
     13 .Op Fl o
     14 .Op Fl s
     15 .Op Fl x
     16 .Op Fl g Ar geometry
     17 .Op Fl w Ar widthscaling
     18 .Op Fl e Ar heightscaling
     19 .Op Fl -
     20 .Ar label0 cmd0 [label1 cmd1 ...]
     21 .Ek
     22 .
     23 .Sh DESCRIPTION
     24 .Bd -filled
     25 .Nm
     26 is a simple menu for X11. The menu can be displayed in a horizontal or
     27 a vertical layout. The manual specification of the parameters of the
     28 menu makes it flexible to be used in many circumstances.
     29 .Ed
     30 . 
     31 .Sh IMPLEMENTATION
     32 .Bd -filled
     33 Installation is as straighforward as grabbing the tar.gz file, extracting
     34 it and running
     35 .Qq "make; make install;"
     36 inside the
     37 .Qq "thingmenu-*"
     38 directory.
     39 The prefix for the installation can easily set using
     40 .Qq "PREFIX=/usr make install".
     41 .Ed
     42 .
     43 .Sh OPTIONS
     44 .Nm
     45 options and default settings.
     46 .Pp
     47 .Bl -tag -width ".Fl test Ao Ar string Ac"
     48 .
     49 .It Fl x
     50 Do not append a
     51 .Qq "Cancel"
     52 menu item.
     53 .Bd -filled
     54 .It Fl s
     55 Disable the oneshot behaviour. After one button click
     56 .Nm
     57 won't exit,
     58 except when the
     59 .Qq "Cancel"
     60 button is clicked.
     61 .Ed
     62 .
     63 .It Fl o
     64 Use the horizontal layout.
     65 .
     66 .It Fl n
     67 Prepend the numpad keys for shortcuts to the entries.
     68 .
     69 .It Fl g
     70 Define the X11 geometry string, which is to be used.
     71 .
     72 .It Fl w
     73 Define the width scaling.
     74 .
     75 .It Fl e
     76 Define the height scaling.
     77 .
     78 .El
     79 .
     80 .Sh CUSTOMIZATION
     81 .Bd -filled
     82 .Nm
     83 is customized by creating a custom config.h and (re)compiling the
     84 source code.
     85 .Ed
     86 .
     87 .Sh EXAMPLES
     88 .Bd -filled
     89 Open a three times scaled wide menu, which is showing an entry
     90 .Qq "Reboot now".
     91 When being clicked this entry will run
     92 .Qq "reboot".
     93 After that the menu will not exit (-s).
     94 .Ed
     95 .Bd -literal
     96 	% thingmenu -s -w 3 -- "Reboot now" reboot
     97 .Ed
     98 .Bd -filled
     99 This will create a centered menu, which is aligned based on the length of the
    100 label texts. After the first clicked entry it will exit.
    101 .Ed
    102 .Bd -literal
    103 	% thingmenu "Force reboot" "reboot -f" Shutdown shutdown
    104 .Ed
    105 .Bd -filled
    106 An example how to create multi-level menus is shown in the thingmenu-menu.sh
    107 file, included in the distribution.
    108 .Ed
    109 .
    110 .Sh FILES
    111 LICENSE, thingmenu-menu.sh, config.def.h, config.h
    112 .
    113 .Sh AUTHORS
    114 See LICENSE file for authors in the distribution.
    115 .
    116 .Sh LICENSE
    117 .Nm
    118 is released under the MIT/X Consortium License.
    119 .
    120 .Sh BUGS
    121 .Ss "Reporting Bugs"
    122 Report bugs to:
    123 .An "Christoph Lohmann" Aq 20h@R-36.net
    124