aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/later.1
blob: b9f38b47ce183427fc93f67c75e7dba3b95d0417 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.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