git-annex-inprogress(1)

✨ git-annex-inprogress ✨

okay bestie, welcome to the git-annex-inprogress(1) page from the General Commands Manual 🎀 this one is lowkey magic: it's all about peeking at files while they're still downloading 👀💖

---

🌸 NAME 🌸

git-annex-inprogress — access files while they're being downloaded 🦋

---

✨ SYNOPSIS ✨

git annex inprogress [path ...]

---

💅 DESCRIPTION 💅

so here's the vibe: this command lets you get at the content of an annexed file while it's still being downloaded. it prints to standard output the name of the temporary file that's being used to download the annexed file you asked about. that's it, that's the whole thing, and it's iconic 🫶

heads up though: nothing will be output when the download is coming from an encrypted or chunked special remote. just no output, periodt 💀

sometimes you can use this to stream a file before it's fully downloaded, like:

 git annex get video.mpeg &
 vlc $(git annex inprogress video.mpeg)

and now the real talk 🙈 of course, if the file is downloading too slowly, the media player will reach the end too soon and not show you the whole thing. and of course, only some file formats can be usefully streamed this way. no cap, that's just how it is.

---

🎀 OPTIONS 🎀

• [path ..] — the files or directories whose partially downloaded content you wanna access, bestie 🍓

ngl, when no path is specified, it defaults to all files in the current working directory, and subdirectories, which can take a while to traverse 😭 so it's most efficient to specify the file you're actually interested in, or to use --all ✨

• --all, -A — instead of naming a filename or path, this one lets you access all files that are currently being downloaded. the whole set, no picking favorites 💜
• --key=keyname — access the file that's currently being downloaded for the specified key 🔑
• file matching options — the git-annex-matching-options(1) can be used to specify files to access 🌈

also the git-annex-common-options(1) can be used, yay 🧚

---

⭐ EXIT STATUS ⭐

if any of the requested items are not currently being downloaded, the exit status will be 1. so like, a lil sad face from the shell 😔

---

💖 SEE ALSO 💖

• git-annex(1)
• git-annex-get(1)

---

👑 AUTHOR 👑

Joey Hess <id@joeyh.name> — king behavior, honestly 💅

---

and that's the page, bestie!! this lil rewrite came from the git-annex-inprogress(1) manual page and it's dated at the bottom of the original with that same git-annex-inprogress(1) footer 💖 go forth and stream responsibly, mwah 🎀✨