.Dd Created:2025-11-21|Updated:2025-11-22
.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, config and tips
.Sh CONFIGURATION
Lynx has two configuration files, different configuration options can be configured in each file: ~/.lynxrc and /etc/lynx.cfg.
.Ss lynxrc
The file is saved to $HOME/.lynxrc, there is no argument to change this. To change the location of this file
.Li HOME=ALT_HOME_FOR_LYNX lynx
\&.
.Ss /etc/lynx.cfg
This is the default location, this file can be changed
.Li lynx -cfg=PATH_TO_LYNXCFG
\&.
.obdl STARTFILE:HOME_URL
DEFAULT_INDEX_FILE:HOME_URL|INDEX_FILE
.Ed
When using a local file, use file://localhost/PATH.
STARTFILE and DEFAULT_INDEX_FILE could be used with a bookmark file or jumpfile.
.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 option for profiles, but 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 link.
.It G Ta | edit current link.
.It E Ta | edit current selected link.
.It d Ta | download selected file.
.El
Lynx does not have tabs, however, the visited links are stored in the session, 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 can be defined by setting Multi-bookmarks in the options menu or sub_bookmarks in ~/.lynxrc.
.Pp
To use multiple bookmark files, the files need to be defined through the options menu > Review/edit bookmarks files or by setting them in ~/.lynxrc.
.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
Lynx also has jumpfiles available, they 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.
.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.
.El
.Sh SEE ALSO
.opsy ArchLinux manpages:
.Xr lynx 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 - Lynx developer (Accessible if the main site is blocked)
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com