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 -help Print a help screen
28 -version
31 Prints the links version number and exit.
32 -lookup <hostname>
35 Does name lookup, like command "host".
36 -g Run Links in graphics mode. If not given, Links will run in text
39 mode. Running in graphics mode means that Links will probe all
40 compiled-in graphics devices and run on the first found. If none
41 found, links will not run in graphics mode. This option works
42 only if --enable-graphics was given to ./configure.
43 -no-g Run in text mode (overrides previous -g).
46 -driver <driver name>
49 Graphics driver to use. Drivers are: x, svgalib, fb, directfb,
50 pmshell, atheos. List of drivers will be shown if you give it
51 an unknown driver. Available drivers depend on your operating
52 system and available libraries.
53 -mode <parameter>
56 Pass a parameter to the graphics driver. On SVGAlib, this is
57 widthxheightxdepth, (where depth is 16, 256, 32K, 64K, 16M or
58 16M32) and defines the graphics mode, on X the format is WIDTHx‐
59 HEIGHT and defines the window size.
60 -display <x-display>
63 Set Xwindow display.
64 -force-html
67 Treat files with unknown type as html rather than text. (can be
68 toggled with '\' key)
69 -source <url>
72 Write unformatted data stream to stdout.
73 -dump <url>
76 Write formatted document to stdout.
77 -width <number>
80 For dump, document will be formatted to this screen width (but
81 it can still exceed it if lines can't be broken).
82 -codepage <codepage>
85 For dump, convert output to specified character set -- for eaxm‐
86 ple iso-8859-2, windows-1250.
87 -anonymous
90 Restrict links so that it can run on an anonymous account. No
91 local file browsing. No downloads. Executing of viewers is
92 allowed, but user can't add or modify entries in association ta‐
93 ble.
94 -no-connect
97 Runs links as a separate instance - instead of connecting to
98 existing instance.
99 -download-dir <path>
102 Default download directory. (default: actual dir)
103 -language <language>
106 Set user interface language.
107 -max-connections <max>
110 Maximum number of concurrent connections. (default: 10)
111 -max-connections-to-host <max>
114 Maximum number of concurrent connection to a given host.
115 (default: 2)
116 -retries <retry>
119 Number of retries. (default: 3)
120 -receive-timeout <sec>
123 Timeout on receive. (default: 120)
124 -unrestartable-receive-timeout <sec>
127 Timeout on non restartable connections. (default: 600)
128 -timeout-when-trying-multiple-addresses <sec>
131 Timeout for connection when trying multiple addresses.
132 (default: 3)
133 -bind-address <ip address>
136 Use a specific local IP address.
137 -bind-address-ipv6 <ipv6 address>
140 Use a specific local IPv6 address.
141 -no-libevent
144 Don't use libevent library.
145 -no-openmp
148 Don't use OpenMP.
149 -async-dns <0>/<1>
152 Asynchronous DNS resolver on(1)/off(0).
153 -download-utime <0>/<1>
156 Set time of downloaded files to last modification time reported
157 by server.
158 -format-cache-size <num>
161 Number of formatted document pages cached. (default: 5)
162 -memory-cache-size <bytes>
165 Cache memory in bytes. (default: 1048576)
166 -image-cache-size <bytes>
169 Cache memory in bytes. (default: 1048576)
170 -font-cache-size <bytes>
173 Cache memory in bytes. (default: 2097152)
174 -aggressive-cache <0>/<1>
177 Always cache everything regardless of server's caching recomen‐
178 dations. Many servers deny caching even if their content is not
179 changing just to get more hits and more money from ads.
180 -address-preference <0>/<1>/<2>/<3>/<4>
183 (default 0) 0 - use system default. 1 - prefer IPv4. 2 - pre‐
184 fer IPv6. 3 - use only IPv4. 4 - use only IPv6.
185 -http-proxy <host:port>
188 Host and port number of the HTTP proxy, or blank. (default:
189 blank)
190 -ftp-proxy <host:port>
193 Host and port number of the FTP proxy, or blank. (default:
194 blank)
195 -https-proxy <host:port>
198 Host and port number of the HTTPS proxy, or blank. (default:
199 blank)
200 -socks-proxy <user@host:port>
203 Userid, host and port of Socks4a, or blank. (default: blank)
204 -append-text-to-dns-lookups <text>
207 Append text to dns lookups. It is useful for specifying fixed
208 tor exit node. (default: blank)
209 -no-proxy-domains <domain,domain...>
212 No proxy for specified domains. (default: blank)
213 -only-proxies <0>/<1>
216 "1" causes that Links won't initiate any non-proxy connection.
217 It is useful for anonymization with tor or similar networks.
218 -ssl.certificates <0>/<1>/<2>
221 (default 1) 0 - ignore invalid certificate. 1 - warn on invalid
222 certificate. 2 - reject invalid certificate.
223 -ssl.builtin-certificates <0>/<1>
226 (default 0; on DOS and OpenVMS default 1) Use built-in certifi‐
227 cates instead of system certificates.
228 -ssl.client-cert-key <filename>
231 Name of the PEM encoded file with the user private key for
232 client certificate authentication.
233 -ssl.client-cert-crt <filename>
236 Name of the PEM encoded file with the user certificate for
237 client certificate authentication.
238 -ssl.client-cert-password <text>
241 Password for the user private key.
242 -http-bugs.http10 <0>/<1>
245 (default 0) "1" forces using only HTTP/1.0 protocol. (useful for
246 buggy servers that claim to be HTTP/1.1 compliant but are not)
247 "0" enables using both HTTP/1.0 and HTTP/1.1.
248 -http-bugs.allow-blacklist <0>/<1>
251 (default 1) "1" defaults to using list of servers that have bro‐
252 ken HTTP/1.1 support. When links finds such server, it will
253 retry the request with HTTP/1.0.
254 -http-bugs.bug-no-accept-charset <0>/<1>
257 (default 0) Do not send Accept-Charset field of HTTP header.
258 Because it is too long some servers will deny the request. Other
259 servers will convert content to plain ascii when Accept-Charset
260 is missing.
261 -http-bugs.no-compression <0>/<1>
264 (default 0) "1" causes that links won't advertise HTTP compres‐
265 sion support (but it will still accept compressed data). Use it
266 when you communicate with server that has broken compression
267 support.
268 -http-bugs.retry-internal-errors <0>/<1>
271 (default 0) Retry on internal server errors (50x).
272 -http.fake-firefox <0>/<1>
275 (default 0) Fake that the browser is Firefox in the HTTP header.
276 -http.do-not-track <0>/<1>
279 (default 0) Send "do not track" request in the HTTP header.
280 -http.referer <0>/<1>/<2>/<3>/<4>
283 (default 0) 0 - do not send referer. 1 - send the requested URL
284 as referer. 2 - send fake referer. 3 - send real referer. 4 -
285 send real referer only to the same server.
286 -http.fake-referer <string>
289 Fake referer value.
290 -http.fake-user-agent <string>
293 Fake user agent value.
294 -http.extra-header <string>
297 Extra string added to HTTP header.
298 -ftp.anonymous-password <string>
301 Password for anonymous ftp access.
302 -ftp.use-passive <0>/<1>
305 Use ftp PASV command to bypass firewalls.
306 -ftp.use-erpt-epsv <0>/<1>
309 Use EPRT and EPSV commands instead of PORT and PASV.
310 -ftp.set-iptos <0>/<1>
313 Set IP Type-of-service to high throughput on ftp connections.
314 -smb.allow-hyperlinks-to-smb <0>/<1>
317 Allow hyperlinks to SMB protocol. Disabling this improves secu‐
318 rity, because internet sites cannot exploit possible bugs in the
319 SMB client.
320 -menu-font-size <size>
323 Size of font in menu.
324 -menu-background-color 0xRRGGBB
327 Set menu background color in graphics mode. RRGGBB are hex.
328 -menu-foreground-color 0xRRGGBB
331 Set menu foreground color in graphics mode. RRGGBB are hex.
332 -scroll-bar-area-color 0xRRGGBB
335 Set color of scroll bar area. RRGGBB are hex.
336 -scroll-bar-bar-color 0xRRGGBB
339 Set color of scroll bar. RRGGBB are hex.
340 -scroll-bar-frame-color 0xRRGGBB
343 Set color of scroll bar frame. RRGGBB are hex.
344 -bookmarks-file <file>
347 File to store bookmarks.
348 -bookmarks-codepage <codepage>
351 Character set of bookmarks file.
352 -save-url-history <0>/<1>
355 Save URL history on exit.
356 -display-red-gamma <fp-value>
359 Red gamma of display. (default 2.2)
360 -display-green-gamma <fp-value>
363 Green gamma of display. (default 2.2)
364 -display-blue-gamma <fp-value>
367 Blue gamma of display. (default 2.2)
368 -user-gamma <fp-value>
371 Additional gamma. (defult 1)
372 -bfu-aspect <fp-value>
375 Display aspect ration.
376 -dither-letters <0>/<1>
379 Do letter dithering.
380 -dither-images <0>/<1>
383 Do image dithering.
384 -display-optimize <0>/<1>/<2>
387 Optimize for CRT (0), LCD RGB (1), LCD BGR (2).
388 -gamma-correction <0>/<1>/<2>
391 Type of gamma correction: (default 2) 0 - 8-bit (fast). 1 -
392 16-bit (slow). 2 - automatically detect according to speed of
393 FPU.
394 -overwrite-instead-of-scroll <0>/<1>
397 Overwrite the screen instead of scrolling it (valid for svgalib
398 and framebuffer). Overwriting may or may not be faster, depend‐
399 ing on hardware.
400 -html-assume-codepage <codepage>
403 Use the given codepage when the webpage did not specify its
404 codepage. (default: ISO 8859-1)
405 -html-hard-assume <0>/<1>
408 Use always character set from "-html-assume-codepage" no matter
409 what server sent.
410 -html-tables <0>/<1>
413 Render tables. (0) causes tables being rendered like in lynx.
414 -html-frames <0>/<1>
417 Render frames. (0) causes frames rendered like in lynx.
418 -html-break-long-lines <0>/<1>
421 Break long lines in <pre> sections.
422 -html-images <0>/<1>
425 Display links to unnamed images as [IMG]
426 -html-image-names <0>/<1>
429 Display filename of an image instead of [IMG].
430 -html-display-images <0>/<1>
433 Display images in graphics mode.
434 -html-image-scale <percent>
437 Scale images in graphics mode.
438 -html-bare-image-autoscale <0>/<1>
441 Autoscale images displayed in full screen.
442 -html-numbered-links <0>/<1>
445 Number links in text mode. Allow quick link selection by typing
446 link number and enter.
447 -html-table-order <0>/<1>
450 In text mode, walk through table by rows (0) or columns (1).
451 -html-auto-refresh <0>/<1>
454 Process refresh to other page (1), or display link to that page
455 (0).
456 -html-target-in-new-window <0>/<1>
459 Allow opening new windows from html.
460 -html-margin <number of spaces>
463 Margin in text mode.
464 -html-user-font-size <size>
467 Size of font on pages in graphics mode.
468 -html-t-text-color <0>-<15>
471 Text color in text mode.
472 -html-t-link-color <0>-<15>
475 Link color in text mode.
476 -html-t-background-color <0>-<7>
479 Background color in text mode.
480 -html-t-ignore-document-color <0>/<1>
483 Ignore colors specified in html document in text mode.
484 -html-g-text-color 0xRRGGBB
487 Text color in graphics mode.
488 -html-g-link-color 0xRRGGBB
491 Link color in graphics mode.
492 -html-g-background-color 0xRRGGBB
495 Background color in graphics mode.
496 -html-g-ignore-document-color <0>/<1>
499 Ignore colors specified in html document in graphics mode.
500 More options can be seen with links -h
503
506 The keys you may use while navigating are
507 ESC menu/escape
509 F9 menu
511 F10 file menu
513 TAB next frame
515 PGDN page down
517 Space page down
519 PGUP page up
521 b page up
523 CursorDOWN
525 next link/down
526 CursorUP
528 prev link/up
529 INS scroll up
531 ^P scroll up
533 DEL scroll down
535 ^N scroll down
537 [ scroll left
539 ] scroll right
541 HOME home
543 END end of page
545 CursorRIGHT
547 enter link/press button
548 ENTER enter link/press button
550 CursorLEFT
552 go back
553 d download link
555 / search in the page
557 ? search back in the page
559 n find next match
561 N find next match backwards
563 f zoom actual frame
565 ^R reload page
567 g go to URL
569 G edit the current URL and goto the result
571 ^G edit the current link and goto the result
573 s bookmark manager
575 q quit, close window if more windows are open
577 Q quit without asking
579 = document information
581 \ toggle HTML source/rendered view
583
586 The following keys can be used while editing a line/jumping to a URL:
587 CursorRIGHT
589 move right
590 CursorLEFT
592 move left
593 HOME jump at the beginning
595 ^A jump at the beginning
597 END jump at the end
599 ^E jump at the end
601 ^X cut to clipboard
603 ^B copy to clipboard
605 ^V paste from clipboard
607 ENTER enter line
609 BACKSPACE
611 delete back character
612 ^H delete back character
614 DEL delete character
616 ^D delete character
618 ^U delete from beginning of the line
620 ^K delete to the end of the line or delete line (in textarea)
622 ^W auto complete line
624
631 ~/.links/links.cfg
632 Per-user configfile, automatically created by links.
633
635 links is known to work on Linux, FreeBSD, Solaris, IRIX, HPUX,
636 Digital Unix, AIX, OS/2, BeOS and Win32.
637
639 You can't upload large files; it takes _lots_ of memory.
640 Please report any other bugs you find to Mikulas Patocka <miku‐
642 las@artax.karlin.mff.cuni.cz>
643
646 links is free software; you can redistribute it and/or modify it
647 under the terms of the GNU General Public License as published
648 by the Free Software Foundation; either version 2 of the
649 License, or (at your option) any later version.
650
653 links was written by Mikulas Patocka, Karel 'Clock' Kulhavy,
654 Petr 'Brain' Kulhavy, and Martin 'PerM' Pergel. See file
655 AUTHORS for a list of people contributing to this project.
656 The homepage of links can be found at http://atrey.kar‐
658 lin.mff.cuni.cz/~clock/twibright/links
659 This manual page was written by Peter Gervai <grin@tolna.net>,
661 using excerpts from a (yet?) unknown links fan for the Debian
662 GNU/Linux system (but may be used by others). Updated by Karel
663 Kulhavy.
664
667 lynx(1), w3m(1)
668 Aug, 2006 LINKS(1)