README

   1 iomenu
   2
   3  .
   4  , ,--. --.-. ,--. ---. ,  ,
   5  | |  | | | | |--' |  | |  |
   6  ' `--' ' ' ' `--' '  ' `--'
   7
   8 --------------------------------------------------------------------------------
   9 Filter lines from stdin with an interactive menu
  10
  11
  12         iomenu is a terminal tool to interactively select lines from stdin, and
  13         print them out to the standard output.
  14
  15         You can use scripts made for dmenu [1], as iomenu mostly the same way.
  16
  17         Thanks to the authors of dmenu [1], sandy [2], vis-menu[3], pep[4], ...
  18         that taught me C by writing some.
  19
  20
  21 Getting started
  22 --------------------------------------------------------------------------------
  23
  24         You can install iomenu by running:
  25
  26         """
  27         make install
  28         """
  29
  30         You can optionnaly set a "PREFIX" variable to set the path to
  31         install to:
  32
  33         """
  34         make PREFIX="$HOME/bin" install
  35         """
  36
  37         All you need to build it is a C compiler:  It is plain C89 source
  38         code without external dependencies.
  39
  40         All usage details are written in the man page, "iomenu.1".
  41
  42
  43 Examples
  44 --------------------------------------------------------------------------------
  45
  46
  47 Open a bookmark from a list in a text file
  48
  49         """
  50         iomenu < bookmarks-urls.txt | xargs firefox
  51         """
  52
  53
  54 Go to a subdirectory
  55
  56         """
  57         cd "$(find . -type d | iomenu)"
  58         """
  59
  60
  61 Edit a file located in ~
  62
  63         """
  64         $EDITOR "$(find -type f | iomenu)"
  65         """
  66
  67
  68 Play an audio file
  69
  70         """
  71         mplayer "$(find ~/Music | iomenu)"
  72         """
  73
  74
  75 Select a background job to attach to
  76
  77         """
  78         fg "%$(jobs | iomenu | cut -c 2)"
  79         """
  80
  81
  82 Filter "ps" output and print a process ID
  83
  84         """
  85         { printf '#'; ps ax; } | iomenu -s '#' | sed -r 's/ *([0-9]*).*/\1/'
  86         """
  87
  88
  89 --------------------------------------------------------------------------------
  90 1       http://git.suckless.org/dmenu/tree/dmenu.c
  91 2       http://git.suckless.org/sandy/tree/sandy.c
  92 3       http://github.com/martanne/vis/blob/master/vis-menu.c
  93 4       http://github.com/charles-l/pep/blob/master/pep.c