README.md

   1 # tee for Windows
   2
   3 A simple [**`tee`**](https://en.wikipedia.org/wiki/Tee_(command)) implementation for Microsoft Windows.
   4
   5 ![tee](etc/images/tee.png)
   6 <small>(image created by [Sven](https://commons.wikimedia.org/wiki/User:Sven), CC BY-SA 4.0)</small>
   7
   8 ## Usage
   9
  10 ```
  11 tee for Windows
  12
  13 Copy standard input to output file(s), and also to standard output.
  14
  15 Usage:
  16   gizmo.exe [...] | tee.exe [options] <file_1> ... <file_n>
  17
  18 Options:
  19   -a --append  Append to the existing file, instead of truncating
  20   -b --buffer  Enable write combining, i.e. buffer small chunks
  21   -f --flush   Flush output file after each write operation
  22   -i --ignore  Ignore the interrupt signal (SIGINT), e.g. CTRL+C
  23   -d --delay   Add a small delay after each read operation
  24 ```
  25
  26 ### Terminal output
  27
  28 Tee can be used as an intermediate buffer (i.e. *without* writing to a file) to greatly speed-up terminal output:
  29 ```
  30 gizmo.exe [...] | tee.exe NUL
  31 ```
  32
  33 ## Implementation
  34
  35 This is a "native" implementation of the **`tee`** command that builds directly on top of the Win32 API.
  36
  37 It uses multi-threaded I/O and triple buffering for maximum throughput.
  38
  39 ## System Requirements
  40
  41 This application requires Windows Vista or later. All 32-Bit and 64-Bit editions, including ARM64, are supported.
  42
  43 ## Website
  44
  45 Git mirrors for this project:
  46
  47 * <https://github.com/dEajL3kA/tee-win32>
  48 * <https://gitlab.com/deajl3ka1/tee-for-windows>
  49 * <https://repo.or.cz/tee-win32.git>
  50
  51 ## License
  52
  53 Copyright (c) 2023 “dEajL3kA” &lt;Cumpoing79@web.de&gt;
  54 This work has been released under the MIT license. See [LICENSE.txt](LICENSE.txt) for details!
  55
  56 ### Acknowledgement
  57
  58 Using [T-junction icons](https://www.flaticon.com/free-icons/t-junction) created by Smashicons &ndash; Flaticon.