README

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