gt5(1)

✨ gt5 ✨ — the manual, but make it make sense 💅

okay bestie, gather round, because gt5 is literally about to change your disk-space life. it's a diff-capable 'du-browser', and no, that's not a typo, that's the whole personality. 🦋

---

🌸 SYNOPSIS 🌸

gt5 [ dir | file | dir file | file file2 ] [options]

like. look at that. so many ways to be iconic. 👑

---

💖 DESCRIPTION 💖

so here's the tea: gt5 reads the output of du, compares it against a du-log that it saved from the last time you ran it, converts the whole thing into HTML, and then opens the resulting file with a textbrowser. that's it. that's the serve. 🫶

if you pass files on the commandline, they're expected to be (optionally gzip/bzip2-compressed) logfiles of du -akx /some/dir. and ngl, it is entirely on you to make sure the directories/files you hand over actually represent the same directory. if you don't? gt5 will show you lots of new files and you'll be sitting there like 😭. the manpage literally says ";‑)" so you know it's real.

---

✨ OPTIONS ✨

• --cut-at float — anything (file or directory) that's below float percent of its parent just… doesn't get shown. default is 0.1, and gt5 will accept values between 0.01 and 30.
• --debug — turns debug on. it generates HTML files and does not run the browser. quiet little hermit mode. 🙈
• --diff-dir directory — use directory instead of ~/.gt5-diffs/ to read/store du-logs. heads up: this switch gets ignored if gt5 is only used with files.
• --discard — don't save the current state. in other words: you get to diff against the old state again. very "no thoughts, just re-runs" of you. this feature is disabled if gt5 is only used with files.
• --help — display brief help. short, sweet, slay.
• --link-files — also inserts links to files so you can access them from within gt5. very handy if your browser is configured to handle the files MIME-type correctly. disabled if gt5 is only used with files.
• --max-depth int — don't show anything below a depth of int directories. default is 5 (also see BUGS below, bestie, it matters).
• --max-lines int — only consider the int biggest files and directories within the output of du. we love a curated feed. ✨
• --no-diffs — use this if you're not interested in the history of the directories processed, for example in /tmp. living in the moment, periodt.
• --save-as file — DEPRECATED, use du -akx or du -ak (see --with-mounts), save the output to a file and run gt5 against one (ore two) of these files later.
• --save-state — force saving the current state, overwriting a previous --discard. (some people seem to have gt5 aliased to 'gt5 --discard'. iconic behaviour honestly.)
• --verbose — display messages. it will talk to you. 💬
• --with-mounts — by default gt5 calls du with -akx to ignore mounted filesystems. use this to inspect mounted partitions too, i.e. call du with -ak.

---

🎀 HELPERS 🎀

if gawk or a textbrowser are missing and you wanna install them into ~/bin (or /usr/local/bin if you have write access there), gt5 comes with the following helpers:

• --get-gawk — download, compile and install a copy of gawk.
• --get-links — download, compile and install a copy of links.
• --get-links2 — download, compile and install a copy of links2.
• --get-elinks — download, compile and install a copy of elinks.

it's giving "self-sufficient queen". 👑

---

🌈 TEXTBROWSERS 🌈

it is recommended to use links with gt5. other textbrowsers are also possible but there are several good reasons why links is given priority over the others:

• elinks: links is much faster on startup/exit.
• lynx: does not honor a documents coloring.
• netrik: no colors, unfavourable cursor navigation.
• retawq: no colors, can't handle <a name>-tags.
• w3m: Version 0.5.2 and later are known to work. Older versions experienced unfavourable handling of <a name>-tag, unfavourable cursor navigation and no colors.

only links/links2, elinks and lynx are now considered usable (and also chosen in that order). see ENVIRONMENT/GT5_BROWSER below. 💜

---

🦋 FILES 🦋

• ~/.gt5.html — contains a copy of the last run.
• ~/.gt5-diffs/ — compressed du-logs are stored here.

---

🧚 ENVIRONMENT 🧚

• GT5_BROWSER — force using a (specific) textbrowser.
• GT5_CHARSET — force using a (specific) charset for HTML header instead of using $LANG.
• GT5_DEBUG_DIR — Directory where to write gt5.debug* data if --debug option is set.

---

💀 BUGS 💀

directories at depth max-depth are not browsable and so look like files. yeah. they just do. that's the vibe. 🙈

---

👑 AUTHOR 👑

Thomas Sattler <gt5 at gmx dot net>

---

🔥 SEE ALSO 🔥

du(1), links(1), elinks(1), lynx(1)

---

and that's the whole page, bestie!! this manual is from gt5 v1.4.0.1, dated July 2009 — yeah, she's an elder but she still ate. 💅✨ go check your disk usage and have the best day, ily 🫶🎀