.Dd Created:2025-11-21|Updated:2025-11-27|
.de ocsi
\\$*
,
..
.de oxr
.ocsi .Xr \\$*
..
.de oit
.It
\\$*
..
.de obdi
.Bl -dash -compact
.oit \\$*
..
.de obdl
.Bd -literal -compact
\\$*
..
.de onote
.Bl -hang -compact
.oit \\$*
.El
..
.de ocomm
.Bl -diag -compact
.oit \\$*
.El
..
.de opsy
.Pp
.Sy - \\$*
..
.de obc
.Bl -column \\$*
..
.de obc2
.obc opt desc
..
.de obc3
.obc option arguments description
..
.Dt LYNX oh
.Os linux , OpenBSD |
.Nm lynx 
.Nd text web browser - usage and tips
.Sh PROTOCOLS
Lynx can access HTTP(S), Gopher, FTP, WAIS and NNTP servers.
.Sh COMMAND LINE
.obc _socks5_proxy_IP__PORT_ desc
.It -dump Ta | dump formatted output to stdout.
.It -source Ta | dump html output to stdout.
.It -socks5_proxy=IP[:PORT] Ta | use socks5 proxy.
.El
.Ss SOCKS5
Lynx can use the environment variable SOCKS5_PROXY, the command line option or work through torsocks.
It will not read a socks5 proxy set on with the http(s)_proxy environment variable.
.Sh SESSIONS
.obc _sessionout_FILE_ description
.It -session=FILE Ta | read/save session from/to FILE.
.It -sessionin=FILE Ta | read session from FILE.
.It -sessionout=FILE Ta | save session to FILE.
.El
Sessions can be saved by setting "Auto Session" to ON and setting a "Session file".
The session can be loaded with lynx -session=FILENAME.
The session will save visited links.
.Sh PROFILES
lynx does not have options for profiles.
However different lynx.cfg, $HOME/~.lynxrc and/or session files could be used to emulate profiles.
.Sh OPTIONS
Options can be changed on lynx through the options menu (o) or by editing ~/.lynxrc.
.Ss Menu
To save the changes on the options menu, toggle "Save options to disk" and then "Accept changes".
.obc multi_bookmarks description
.It colors Ta | never, off, on (default), always.
.It User mode Ta | Novice (default), intermediate advanced, minimal.
.It Multi-bookmarks Ta | off (default), standard, advanced.
.El
.Sh USAGE
.Ss keys
.obc2
.It H Ta | help
.It g Ta | go to URL.
.It G Ta | edit current URL.
.It E Ta | edit current selected link.
.It d Ta | download selected file.
.El
Lynx does not have tabs, however, any link can be revisited by going to the visited links (V).
.Sh BOOKMARKS
Bookmarks can be a single bookmark file or multiple bookmark files.
Multi-bookmarks has the following possible values: OFF (default), STANDARD, ADVANCED.
It can be set in the Options menu > Multi-bookmarks or ~/.lynxrc > sub_bookmarks.
.Ss Add_bookmark_files
Options menu > Review/edit bookmarks files.
The files can also be edited in ~/.lynxrc, eg.:
.Dl multi_bookmarkB=b.html
.Ss Options
.obc2
.It v Ta | view bookmarks files (files can be selected by selecting the corresponding letter to see all bookmarks).
.It a Ta | add bookmarks (when using multi-bookmarks, the bookmarks menu will be displayed to select the bookmark file).
.El
Multi-bookmarks use letters a-z to set the bookmarks files.
.Ss Add
.Bl -enum -compact
.It
a: to add a bookmark.
.It
d,l,c: document (current document), link (selected link), cancel.
.It
If multi-bookmarks is set, the bookmarks menu will be displayed.
.Bl -enum -compact
.It
Select the letter corresponding to the desired bookmarks file.
.It
Set the title for the bookmark.
.El
.It
If multi-bookmarks is off, only the title needs to be set.
.El
.Ss View
.Bl -enum -compact
.It
v: will display the bookmarks or bookmarks files if multi-bookmarks is set.
.It
If multi-bookmarks is set, select the letter corresponding to the chosen bookmarks file to see the bookmarks.
.El
.Sh JUMPS
Jumpfiles work similar to bookmarks but the items can also have parameters by adding %s to the url.
Lynx will prompt the user to enter a parameter per %s in the url. Eg.: https://man.openbsd.org/%s.
Jumps can also point to programs or executable scripts. See lynx samples directory for jump examples.
.ocomm NOTE: the list must be in alphabetical order.
.Pp
Jumpfiles are defined in lynx.cfg:
.Li JUMPFILE:PATH[:key][:prompt]
key is necessary only is multiple jumpfiles are specified, key will replace the current bind for the specified key.
Prompt will set the prompt displayed to the user.
.Pp
The first item should be:
.Li <dt>?<dd><a href="PATH_TO_JUMPFILE">the list in this jumpfile</a>
to show the jumps in the file.
.Bl -enum -compact
.It
j (or key defined for jumpfile)
.It
Jump shortcut.
.It
Enter parameter if required for the jump.
.El
.Sh DIRED
Lynx can also be used for directory editing by using lynx on a directory.
.Li lynx PATH_TO_DIR
.obc2
.It c Ta | create a (f)ile or (d)irectory.
.It r Ta | remove a file or directory.
.It e Ta | edit file. (Requires an editor to be set in ~/.lynxrc)
.El
.Ss Create
.Bl -enum -compact
.It
c: to create a directory.
.It
f or d to create file or directory.
.El
.Sh TODO
.obc2
.It - Add better examples.
.It - Split doc: bookmarks and jumpfiles.
.It - Check CGI Script options.
.It - Check mail options.
.It - Check NNTP options.
.It - Check additional cookies options.
.It - Check Downloader options.
.It - Check Editor options.
.It - Check keymap options.
.El
.Sh SEE ALSO
.oxr lynx_config oh
.oxr tor oh
.Xr text_links oh
.opsy ArchLinux manpages:
.oxr lynx 1
.oxr links 1
.oxr elinks 1
.Xr w3m 1
.Ss links
.obc2
.It - Lk https://lynx.invisible-island.net/ Thomas E. Dickey - Lynx developer (may be blocked in some countries)
.It - Lk https://lynx.invisible-mirror.net/ Mirror of Thomas E. Dickey (Accessible if the main site is blocked)
.It - Lk https://edbrowse.org/ Edbrowse, a Command Line Editor Browser 
.El
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com