1LINKS(1) General Commands Manual LINKS(1)
2
6 links - lynx-like alternative character mode WWW browser
7
9 links [options] URL
10
12 links is a text mode WWW browser with ncurses interface, supporting
13 colors, correct table rendering, background downloading, menu driven
14 configuration interface and slim code.
15 Frames are supported. You can have different file formats associated
17 with external viewers. mailto: and telnet: are supported via external
18 clients.
19 links can handle local (file://) or remote (http:// or ftp://) URLs.
21
23 Most options can be set in the user interface or config file, so usu‐
24 ally you do not need to care about them.
25 -g Run Links in graphics mode. If not given, Links will run in text
28 mode. Running in graphics mode means that Links will probe all
29 compiled-in graphics devices and run on the first found. If none
30 found, links will not run in text mode. This option works only
31 if --enable-graphics was given to ./configure.
32 -no-g Run in text mode (overrides previous -g).
35 -driver <driver name>
38 Graphics driver to use. Drivers are: x, svgalib, fb, directfb,
39 pmshell, atheos. List of drivers will be shown if you give it
40 an unknown driver. Available drivers depend on your operating
41 system and available libraries.
42 -mode <parameter>
45 Pass a parameter to the graphics driver. On SVGAlib, this is
46 widthxheightxdepth, (where depth is 16, 256, 32K, 64K, 16M or
47 16M32) and defines the graphics mode, on X the format is WIDTHx‐
48 HEIGHT and defines the window size.
49 -display <x-display>
52 Set Xwindow display.
53 -force-html
56 Treat files with unknown type as html rather than text. (can be
57 toggled with '\' key)
58 -source <url>
61 Write unformatted data stream to stdout.
62 -dump <url>
65 Write formatted document to stdout.
66 -width <number>
69 For dump, document will be formatted to this screen width (but
70 it can still exceed it if lines can't be broken).
71 -codepage <codepage>
74 For dump, convert output to specified character set -- for eaxm‐
75 ple iso-8859-2, windows-1250.
76 -anonymous
79 Restrict links so that it can run on an anonymous account. No
80 local file browsing. No downloads. Executing of viewers is
81 allowed, but user can't add or modify entries in association ta‐
82 ble.
83 -no-connect
86 Runs links as a separate instance - instead of connecting to
87 existing instance.
88 -download-utime <0>/<1>
91 Set time of downloaded files to last modification time reported
92 by server.
93 -async-dns <0>/<1>
96 Asynchronous DNS resolver on(1)/off(0).
97 -max-connections <max>
100 Maximum number of concurrent connections. (default: 10)
101 -max-connections-to-host <max>
104 Maximum number of concurrent connection to a given host.
105 (default: 2)
106 -retries <retry>
109 Number of retries. (default: 3)
110 -receive-timeout <sec>
113 Timeout on receive. (default: 120)
114 -unrestartable-receive-timeout <sec>
117 Timeout on non restartable connections. (default: 600)
118 -format-cache-size <num>
121 Number of formatted document pages cached. (default: 5)
122 -memory-cache-size <bytes>
125 Cache memory in Kilobytes. (default: 1024)
126 -image-cache-size <bytes>
129 Cache memory in Kilobytes. (default: 1024)
130 -http-proxy <host:port>
133 Host and port number of the HTTP proxy, or blank. (default:
134 blank)
135 -ftp-proxy <host:port>
138 Host and port number of the FTP proxy, or blank. (default:
139 blank)
140 -socks-proxy <user@host:port>
143 Userid, host and port of Socks4a, or blank. (default: blank)
144 -only-proxies <0>/<1>
147 "1" causes that Links won't initiate any non-proxy connection.
148 It is useful for anonymization with tor or similar networks.
149 -download-dir <path>
152 Default download directory. (default: actual dir)
153 -language <language>
156 Set user interface language.
157 -http-bugs.http10 <0>/<1>
160 (default 0) "1" forces using only HTTP/1.0 protocol. (useful for
161 buggy servers that claim to be HTTP/1.1 compliant but are not)
162 "0" enables using both HTTP/1.0 and HTTP/1.1.
163 -http-bugs.allow-blacklist <0>/<1>
166 (default 1) "1" defaults to using list of servers that have bro‐
167 ken HTTP/1.1 support. When links finds such server, it will
168 retry the request with HTTP/1.0.
169 -http-bugs.bug-302-redirect <0>/<1>
172 (default 1) Process 302 redirect in a way that is incompatible
173 with RFC1945 and RFC2068, but the same as Netscape and MSIE.
174 Many pages depend on it.
175 -http-bugs.bug-post-no-keepalive <0>/<1>
178 (default 0) No keepalive connection after post requests. For
179 some buggy servers.
180 -http-bugs.bug-no-accept-charset <0>/<1>
183 (default 0) Do not send Accept-Charset field of HTTP header.
184 Because it is too long some servers will deny the request. Other
185 servers will convert content to plain ascii when Accept-Charset
186 is missing.
187 -http-bugs.no-compression <0>/<1>
190 (default 0) "1" causes that links won't advertise HTTP compres‐
191 sion support (but it will still accept compressed data). Use it
192 when you communicate with server that has broken compression
193 support.
194 -http-bugs.retry-internal-errors <0>/<1>
197 (default 0) Retry on internal server errors (50x).
198 -http-bugs.aggressive-cache <0>/<1>
201 Always cache everything regardless of server's caching recomen‐
202 dations. Many servers deny caching even if their content is not
203 changing just to get more hits and more money from ads.
204 -http-referer <0>/<1>
207 (default 0) 0 - do not send referer. 1 - send the requested URL
208 as referer. 2 - send fake referer. 3 - send real referer. 4 -
209 send real referer only to the same server.
210 -fake-referer <string>
213 Fake referer value.
214 -fake-user-agent <string>
217 Fake user agent value.
218 -ftp.anonymous-password <string>
221 Password for anonymous ftp access.
222 -ftp.use-passive <0>/<1>
225 Use ftp PASV command to bypass firewalls.
226 -ftp.fast <0>/<1>
229 Send more ftp commands simultaneously. Faster response when
230 browsing ftp directories, but it is incompatible with RFC and
231 some servers don't like it.
232 -menu-font-size <size>
235 Size of font in menu.
236 -background-color 0xRRGGBB
239 Set menu background color in graphics mode. RRGGBB are hex.
240 -foreground-color 0xRRGGBB
243 Set menu foreground color in graphics mode. RRGGBB are hex.
244 -scroll-bar-area-color 0xRRGGBB
247 Set color of scroll bar area. RRGGBB are hex.
248 -scroll-bar-bar-color 0xRRGGBB
251 Set color of scroll bar. RRGGBB are hex.
252 -scroll-bar-frame-color 0xRRGGBB
255 Set color of scroll bar frame. RRGGBB are hex.
256 -display-red-gamma <fp-value>
259 Red gamma of display. (default 2.2)
260 -display-green-gamma <fp-value>
263 Green gamma of display. (default 2.2)
264 -display-blue-gamma <fp-value>
267 Blue gamma of display. (default 2.2)
268 -user-gamma <fp-value>
271 Additional gamma. (defult 1)
272 -bfu-aspect <fp-value>
275 Display aspect ration.
276 -aspect-on <0>/<1>
279 Enable aspect ratio correction.
280 -dither-letters <0>/<1>
283 Do letter dithering.
284 -dither-images <0>/<1>
287 Do image dithering.
288 -display-optimize <0>/<1>/<2>
291 Optimize for CRT (0), LCD RGB (1), LCD BGR (2).
292 -gamma-correction <0>/<1>/<2>
295 Type of gamma correction: (default 2) 0 - 8-bit (fast). 1 -
296 16-bit (slow). 2 - automatically detect according to speed of
297 FPU.
298 -bookmarks-codepage <codepage>
301 Character set of bookmarks file.
302 -bookmarks-file <file>
305 File to store bookmarks.
306 -html-assume-codepage <codepage>
309 Use the given codepage when the webpage did not specify its
310 codepage. (default: ISO 8859-1)
311 -html-hard-assume <0>/<1>
314 Use always character set from "-html-assume-codepage" no matter
315 what server sent.
316 -html-tables <0>/<1>
319 Render tables. (0) causes tables being rendered like in lynx.
320 -html-frames <0>/<1>
323 Render frames. (0) causes frames rendered like in lynx.
324 -html-images <0>/<1>
327 Display links to unnamed images as [IMG]
328 -html-image-names <0>/<1>
331 Display filename of an image instead of [IMG].
332 -html-display-images <0>/<1>
335 Display images in graphics mode.
336 -html-image-scale <percent>
339 Scale images in graphics mode.
340 -html-bare-image-autoscale <0>/<1>
343 Autoscale images displayed in full screen.
344 -html-numbered-links <0>/<1>
347 Number links in text mode. Allow quick link selection by typing
348 link number and enter.
349 -html-table-order <0>/<1>
352 In text mode, walk through table by rows (0) or columns (1).
353 -html-auto-refresh <0>/<1>
356 Process refresh to other page (1), or display link to that page
357 (0).
358 -html-target-in-new-window <0>/<1>
361 Allow opening new windows from html.
362 -html-margin <number of spaces>
365 Margin in text mode.
366 -html-user-font-size <size>
369 Size of font on pages in graphics mode.
370 -lookup <hostname>
373 Does name lookup, like command "host".
374 -version
377 Prints the links version number and exit.
378 -help Printf a help screen
381 More options can be seen with links -h
384
387 The keys you may use while navigating are
388 ESC menu/escape
390 F9 menu
392 F10 file menu
394 TAB next frame
396 PGDN page down
398 Space page down
400 PGUP page up
402 b page up
404 B page up
406 CursorDOWN
408 next link/down (text mode), scroll down (graphics mode)
409 CursorUP
411 prev link/up (text mode), up (graphics mode)
412 ^INS copy to clipboard
414 ^C copy to clipboard (OS/2 only)
416 INS scroll up (text mode only)
418 ^P scroll up
420 DEL scroll down
422 ^N scroll down
424 [ scroll left
426 ] scroll right
428 HOME home
430 END end of page
432 CursorRIGHT
434 enter link/press button (text mode), scroll right (graphics
435 mode)
436 ENTER enter link/press button
438 CursorLEFT
440 go back (text mode), scroll left (graphics mode)
441 d download link (text mode only)
443 D download link (text mode only)
445 / search in the page
447 ? search back in the page
449 n find next match
451 N find next match backwards
453 f zoom actual frame
455 F zoom actual frame
457 ^R reload page
459 g go to URL
461 G edit the current URL and goto the result
463 s bookmark manager
465 S bookmark manager
467 q quit, close window if more windows are open
469 Q quit, close window if more windows are open
471 = document informations
473 \ toggle HTML source/rendered view
475
478 The following keys can be used while editing a line/jumping to a URL:
479 CursorRIGHT
481 move right
482 CursorLEFT
484 move left
485 HOME jump at the beginning
487 ^A jump at the beginning
489 END jump at the end
491 ^E jump at the end
493 ^X cut to clipboard
495 ^V paste from clipboard
497 ENTER enter line
499 BACKSPACE
501 delete back character
502 ^H delete back character
504 DEL delete character
506 ^D delete character
508 ^U delete from beginning of the line
510 ^K delete to the end of the line or delete line (in textarea)
512 ^W auto complete line
514
521 ~/.links/links.cfg
522 Per-user configfile, automatically created by links.
523
525 links is known to work on Linux, FreeBSD, Solaris, IRIX, HPUX,
526 Digital Unix, AIX, OS/2 and BeOS. Port for Win32 is in state of
527 beta testing.
528
530 You can't upload large files; it takes _lots_ of memory.
531 Please report any other bugs you find to Mikulas Patocka <miku‐
533 las@artax.karlin.mff.cuni.cz>
534
537 links is free software; you can redistribute it and/or modify it
538 under the terms of the GNU General Public License as published
539 by the Free Software Foundation; either version 2 of the
540 License, or (at your option) any later version.
541
544 links was written by Mikulas Patocka, Karel 'Clock' Kulhavy,
545 Petr 'Brain' Kulhavy, and Martin 'PerM' Pergel. See file
546 AUTHORS for a list of people contributing to this project.
547 The homepage of links can be found at http://atrey.kar‐
549 lin.mff.cuni.cz/~clock/twibright/links
550 This manual page was written by Peter Gervai <grin@tolna.net>,
552 using excerpts from a (yet?) unknown links fan for the Debian
553 GNU/Linux system (but may be used by others). Updated by Karel
554 Kulhavy.
555
558 lynx(1), w3m(1)
559 Aug, 2006 LINKS(1)