87 lines
1.9 KiB
Groff
87 lines
1.9 KiB
Groff
.Dd $Mdocdate: December 19 2023 $
|
|
.Dt ESV 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm esv
|
|
.Nd read the Bible from your terminal
|
|
.Sh SYNOPSIS
|
|
.Nm esv
|
|
.Bk -words
|
|
.Op Fl aFfHhNnRrV
|
|
.Op Fl C Ar config
|
|
.Op Fl l Ar length
|
|
.Ar book verses
|
|
.Ek
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a program that displays passages of the Bible on your terminal.
|
|
It can also play recorded audio tracks of certain passages,
|
|
through integration with the
|
|
.Xr mpg123 1
|
|
utility. While audio is playing, you can use the standard mpg123
|
|
controls: spacebar to pause/resume, comma to rewind, period
|
|
to fast-forward, etc. Read about the
|
|
.Fl C
|
|
option in mpg123's manual for more information.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width keyword
|
|
.It Fl a
|
|
Instead of displaying text passages, play a recorded audio track.
|
|
.It Fl C Ar config
|
|
Use
|
|
.Ar config
|
|
as the configuration file path. This overrides the
|
|
.Ev ESV_CONFIG
|
|
environment variable (see section
|
|
.Sx ENVIRONMENT ) .
|
|
.It Fl F
|
|
Exclude footnotes.
|
|
.It Fl f
|
|
Include footnotes (the default).
|
|
.It Fl H
|
|
Exclude headings.
|
|
.It Fl h
|
|
Include headings (the default).
|
|
.It Fl l Ar length
|
|
Use
|
|
.Ar length
|
|
as the maximum line length.
|
|
.It Fl N
|
|
Exclude verse numbers.
|
|
.It Fl n
|
|
Include verse numbers (the default).
|
|
.It Fl R
|
|
Exclude passage references.
|
|
.It Fl r
|
|
Include passage references (the default).
|
|
.It Fl V
|
|
Print the version number and exit.
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width ESV_CONFIG
|
|
.It Ev ESV_CONFIG
|
|
Where to read the configuration file, rather than using the default location (see section
|
|
.Sx FILES ) .
|
|
.It Ev ESV_PLAYER
|
|
What MP3 player to use for playing audio, rather than using mpg123.
|
|
Using mpg123 is recommended over other players such as mpv, because
|
|
mpv's controls don't work well when started by another process
|
|
for some reason.
|
|
.Sh FILES
|
|
.Bl -tag -width ~/.config/esv.conf
|
|
.It Pa ~/.config/esv.conf
|
|
default configuration file location
|
|
.El
|
|
|
|
.Sh EXAMPLES
|
|
Read Psalm 23:
|
|
.Pp
|
|
.Dl esv Psalm 23
|
|
.Pp
|
|
Listen to a recorded audio track of Matthew 5-7:
|
|
.Pp
|
|
.Dl esv -a Matthew 5-7
|
|
.Pp
|
|
|
|
.Sh SEE ALSO
|
|
.Xr esv.conf 5
|