path: root/later.1

.Dd October 26, 2024
.Dt LATER 1
.Os
.Sh NAME
.Nm later
.Nd list mpv's watch_later entries
.Sh SYNOPSIS
.Nm
.Op options
.Op Ic list
.Nm
.Op options
.Op Ic add
.Ar item ...
.Sh DESCRIPTION
.Nm
is a program to manage watch_later entries as created by
.Xr mpv 1 .
.Pp
In order to display file names and URLs for an entry, the
.Sy write-filename-in-watch-later-config
option must be set in
.Xr mpv 1 .
.Pp
The following options can be given for any command:
.Bl -tag -width "-h, --update-titles"
.It Fl u , Fl \-update-titles
update titles of videos using yt-dlp
.El
.Pp
The commands are as follows:
.Bl -tag -width Ds
.It Sy add Em item ...
Creates watch_later entries for the given items.
This command is implied if it wasn't explicitly given but there are
remaining arguments.
.It Sy list
Lists all watch_later entries.
This command is implied if there are no remaining arguments.
.El
.Pp
An item may be a URL or a path to a file on the file system.
Any command that modifies watch_later entries will subsequently print
all entries just as if
.Ic list
was invoked.
.Sh FILES
.Bl -tag -width "1"
.It Pa $XDG_CACHE_HOME/later/titles.json
JSON-encoded mapping of URLs to video titles.
Populated by running
.Nm
with the
.Fl \-update-titles
option.
.El
.Sh SEE ALSO
.Xr mpv 1
.Sh AUTHORS
.An -nosplit
.Nm
was written by
.An Wolfgang Müller Aq Mt wolf@oriole.systems
with yt-dlp integration by
.An Juhani Krekelä Aq Mt juhani@krekelä.fi