ducker.1 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233
  1. .TH DUCKER "1" "April 2017" "Ducker 2.0.1" "User Commands"
  2. .SH NAME
  3. Ducker \- search with DuckDuckGo from the command line
  4. .SH SYNOPSIS
  5. Ducker [OPTION]... [KEYWORD]...
  6. .SH DESCRIPTION
  7. .SS "positional arguments:"
  8. .TP
  9. search_str
  10. what you want to search
  11. .SS "optional arguments:"
  12. .TP
  13. \fB\-m\fR, \fB\-\-multiple\-search\fR
  14. launch a search for every word given
  15. .TP
  16. \fB\-i\fR, \fB\-\-image\-search\fR
  17. search for images
  18. .TP
  19. \fB\-v\fR, \fB\-\-video\-search\fR
  20. search for videos
  21. .TP
  22. \fB\-w\fR, \fB\-\-website\-search\fR
  23. search for websites
  24. .TP
  25. \fB\-H\fR, \fB\-\-no\-javascript\fR
  26. search with DuckDuckGo html interface
  27. .TP
  28. \fB\-l\fR, \fB\-\-lite\fR
  29. search with DuckDuckGo lite interface
  30. .TP
  31. \fB\-s\fR N, \fB\-\-start\fR N
  32. start at the Nth result
  33. .TP
  34. \fB\-n\fR N, \fB\-\-count\fR N
  35. show N results (default 8)
  36. .TP
  37. \fB\-c\fR REG, \fB\-\-reg\fR REG
  38. region-specific search e.g. 'ar-es' for Argentina; visit https://duckduckgo.com/params
  39. .TP
  40. \fB\-x\fR, \fB\-\-exact\fR
  41. disable automatic spelling correction
  42. .TP
  43. \fB\-C\fR \fB\-\-nocolor\fR
  44. disable color output
  45. .TP
  46. \fB\-colors\fR COLORS
  47. set output colors
  48. .TP
  49. \fB\-t\fR DURATION \fB\-\-time\fR DURATION
  50. time limit search [a (any time), d (past day), w (past week), m (past month)]
  51. .TP
  52. \fB\-\-site\fR SITE
  53. search a site using DuckDuckGo
  54. .TP
  55. \fB\-p\fR PROXY \fB\-\-proxy\fR PROXY
  56. tunnel traffic through an HTTPS proxy (HOST:PORT)
  57. .TP
  58. \fB\-\-noua\fR
  59. disable user agent
  60. .TP
  61. \fB\-\-json\fR
  62. output in JSON format; implies --noprompt
  63. .TP
  64. \fB\-\-np\fR \fB\-\-nopromp\fR
  65. perform search and exit, do not prompt
  66. .TP
  67. \fB\-d\fR \fB\-\-debug\fR
  68. enable debugging
  69. .TP
  70. \fB\-h\fR, \fB\-\-help\fR
  71. show this help message and exit
  72. .TP
  73. \fB\-\-version\fR
  74. output version information and exit
  75. .SH INTERACTIVE MODE KEYS
  76. .TP
  77. .BI "n, p"
  78. Fetch the next or previous set of search results.
  79. .TP
  80. .BI "index"
  81. Open the result corresponding to index in browser.
  82. .TP
  83. .BI "f"
  84. Jump to the first page.
  85. .TP
  86. .BI o " [index ...]"
  87. Open space-separated result indices in the browser. Open the current search in the browser, if no arguments.
  88. .TP
  89. .BI g " keywords"
  90. Initiate a new DuckDuckGo search for \fIkeywords\fR with original options. This key should be used to search omniprompt keys (including itself) and indices.
  91. .TP
  92. .BI "q, ^D, double Enter"
  93. Exit Ducker.
  94. .TP
  95. .BI "?"
  96. Show help for interactive mode.
  97. .TP
  98. .BI *
  99. Any other string initiates a new search with original options.
  100. .SH COLORS
  101. \fBDucker\fR allows you to customize the color scheme via a six-letter string, reminiscent of BSD \fBLSCOLORS\fR. The six letters represent the colors of
  102. .IP - 2
  103. indices
  104. .PD 0 \" Change paragraph spacing to 0 in the list
  105. .IP - 2
  106. titles
  107. .IP - 2
  108. URLs
  109. .IP - 2
  110. nothing (may probably be used in a later version)
  111. .IP - 2
  112. abstracts
  113. .IP - 2
  114. prompts
  115. .PD 1 \" Restore paragraph spacing
  116. .TP
  117. respectively. The six-letter string is passed in either as the argument to the \fB--colors\fR option.
  118. .TP
  119. We offer the following colors/styles:
  120. .TS
  121. tab(;) box;
  122. l|l
  123. -|-
  124. l|l.
  125. Letter;Color/Style
  126. a;black
  127. b;red
  128. c;green
  129. d;yellow
  130. e;blue
  131. f;magenta
  132. g;cyan
  133. h;white
  134. i;bright black
  135. j;bright red
  136. k;bright green
  137. l;bright yellow
  138. m;bright blue
  139. n;bright magenta
  140. o;bright cyan
  141. p;bright white
  142. A-H;bold version of the lowercase-letter color
  143. I-P;bold version of the lowercase-letter bright color
  144. x;normal
  145. X;bold
  146. y;reverse video
  147. Y;bold reverse video
  148. .TE
  149. .TP
  150. .TP
  151. The default colors string is \fIGKlgxy\fR, which stands for
  152. .IP - 2
  153. bold bright cyan indices
  154. .PD 0 \" Change paragraph spacing to 0 in the list
  155. .IP - 2
  156. bold bright green titles
  157. .IP - 2
  158. bright yellow URLs
  159. .IP - 2
  160. cyan metadata/publishing info
  161. .IP - 2
  162. normal abstracts
  163. .IP - 2
  164. reverse video prompts
  165. .PD 1 \" Restore paragraph spacing
  166. .TP
  167. Note that
  168. .IP - 2
  169. Bright colors (implemented as \\x1b[90m - \\x1b[97m) may not be available in all color-capable terminal emulators;
  170. .IP - 2
  171. Some terminal emulators draw bold text in bright colors instead;
  172. .IP - 2
  173. Some terminal emulators only distinguish between bold and bright colors via a default-off switch.
  174. .TP
  175. Please consult the manual of your terminal emulator as well as \fIhttps://en.wikipedia.org/wiki/ANSI_escape_code\fR for details.
  176. .SH EXAMPLES
  177. .PP
  178. .IP 1. 4
  179. Search \fBhello world\fR with your default browser in DuckDuckGo HTML version:
  180. .PP
  181. .EX
  182. .IP
  183. .B ducker --no-javascript hello world
  184. .EE
  185. .PP
  186. .IP 2. 4
  187. Search for \fBresults\fR updated within the last \fBmonth\fR for the keywords \fBMetropolis\fR in \fBsite\fR archive.org:
  188. .PP
  189. .EX
  190. .IP
  191. .B ducker -n 4 -t m -w arhive.org Metropolis
  192. .EE
  193. .PP
  194. .IP 3. 4
  195. Open Ducker interactive mode disabling automatic spelling correction:
  196. .PP
  197. .EX
  198. .IP
  199. .B ducker --exact
  200. .EE
  201. .PP
  202. .IP 4. 4
  203. Search for a \fBspecific file type\fR:
  204. .PP
  205. .EX
  206. .IP
  207. .B ducker book type:pdf
  208. .EE
  209. .PP
  210. .IP 5. 4
  211. Use a \fBcustom color scheme\fR, e.g., one warm color scheme designed for Solarized Dark:
  212. .PP
  213. .EX
  214. .IP
  215. .B ducker --colors bjdxxy
  216. .EE
  217. .SH HOME
  218. .I https://www.freakspot.net/programas/ducker
  219. .SH REPORTING BUGS
  220. .I https://notabug.org/Ducker/ducker/issues
  221. .SH "SEE ALSO"
  222. The full documentation for
  223. .B Ducker
  224. is maintained as a Texinfo manual. If the
  225. .B info
  226. and
  227. .B Ducker
  228. programs are properly installed at your site, the command
  229. .IP
  230. .B info Ducker
  231. .PP
  232. should give you access to the complete manual.