1git-annex-inprogress(1)     General Commands Manual    git-annex-inprogress(1)
2
3
4

NAME

6       git-annex-inprogress - access files while they're being downloaded
7

SYNOPSIS

9       git annex inprogress [path ...]
10

DESCRIPTION

12       This  command  allows accessing the content of an annexed file while it
13       is still being downloaded. It outputs to standard output  the  name  of
14       the temporary file that is being used to download the specified annexed
15       file.
16
17       Nothing will be output when the download is from an encrypted or  chun‐
18       ked special remote.
19
20       This  can  sometimes  be  used  to stream a file before it's been fully
21       downloaded, for example:
22
23        git annex get video.mpeg &
24        vlc $(git annex inprogress video.mpeg)
25
26       Of course if the file is downloading too slowly, the media player  will
27       reach  the  end  too  soon and not show the whole thing. And of course,
28       only some file formats can be usefully streamed in this way.
29

OPTIONS

31       [path ..]
32
33              The files or directories whose partially downloaded content  you
34              want to access.
35
36              Note  that,  when no path is specified, it defaults to all files
37              in the current working directory, and subdirectories, which  can
38              take  a  while to traverse. It's most efficient to specify a the
39              file you are interested in, or to use --all
40
41       --all -A
42              Rather than specifying a filename or path, this  option  can  be
43              used to access all files that are currently being downloaded.
44
45       --key=keyname
46              Access the file that is currently being downloaded for the spec‐
47              ified key.
48
49       file matching options
50              The git-annex-matching-options(1) can be used to  specify  files
51              to access.
52
53       Also the git-annex-common-options(1) can be used.
54

EXIT STATUS

56       If  any  of the requested items are not currently being downloaded, the
57       exit status will be 1.
58

SEE ALSO

60       git-annex(1)
61
62       git-annex-get(1)
63

AUTHOR

65       Joey Hess <id@joeyh.name>
66
67                                                       git-annex-inprogress(1)