path: root/later.1

.Dd November 11, 2024
.Dt LATER 1
.Os
.Sh NAME
.Nm later
.Nd manage mpv's watch_later entries
.Sh SYNOPSIS
.Nm
.Op options
.Op Ic list
.Nm
.Op options
.Op Ic add
.Ar item ...
.Nm
.Op options
.Ic del
.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 del Em item ...
Deletes watch_later entries matching the given items.
.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 Juhani Krekelä Aq Mt juhani@krekelä.fi
and
.An Wolfgang Müller Aq Mt wolf@oriole.systems .