README

   1  .
   2  , ,--. --.-. ,--. ---. ,  ,
   3  | |  | | | | |--' |  | |  |
   4  ' `--' ' ' ' `--' '  ' `--'
   5
   6 --------------------------------------------------------------------------------
   7 iomenu                                                                2016-11-22
   8 --------------------------------------------------------------------------------
   9 Filter lines from stdin with an interactive menu
  10
  11         iomenu is a terminal tool to interactively select lines from stdin, and
  12         print them out to the standard output.
  13
  14         You can use scripts made for dmenu[1], as iomenu mostly the same way.
  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 Resources useful for iomenu developement
  86 --------------------------------------------------------------------------------
  87
  88         Thanks to the authors of dmenu [1], sandy [2], vis-menu[3], pep[4], ...
  89         that taught me C by writing some.
  90
  91
  92 --------------------------------------------------------------------------------
  93 1       http://git.suckless.org/dmenu/tree/dmenu.c
  94 2       http://git.suckless.org/sandy/tree/sandy.c
  95 3       http://github.com/martanne/vis/blob/master/vis-menu.c
  96 4       http://github.com/charles-l/pep/blob/master/pep.c