logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

gt5 - a diff-capable 'du-browser'

Author

       Thomas Sattler <gt5 at gmx dot net>

Bugs

       Directories at depth max-depth are not browsable and so look like files.

Description

gt5  reads  the  output of du, compares it with a du-log saved by the last run, converts it into HTML and
       opens the resulting file with a textbrowser.

       If files are given on the commandline they are expected to be (optionally gzip/bzip2-compressed) logfiles
       of du-akx/some/dir.  It is up to you to take care that the given directories/files represent  the  same
       directory.  gt5 will show lots of new files if you don't. ;-)

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.

Files

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

Helpers

       If  gawk  or  a textbrowser are missing and you want to 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.

Name

       gt5 - a diff-capable 'du-browser'

Options

       --cut-at float
              Files  and  directories  that  are below float percent of their parents are not shown.  Default is
              0.1, gt5 will accept values between 0.01 and 30.

       --debug
              Turn on debug. Generate HTML files and do not run browser.

       --diff-dir directory
              Use directory instead of ~/.gt5-diffs/ to read/store du-logs.  This switch is ignored  if  gt5  is
              only used with files.

       --discard
              Do  not save the current state, in other words: be able to diff against the old state again.  This
              feature is disabled if gt5 is only used with files.

       --help Display brief help.

       --link-files
              Also insert links to files to access them from within gt5.  This can be very handy if your browser
              is configured to handle the files MIME-type correctly.  This feature is disabled if  gt5  is  only
              used with files.

       --max-depth int
              Do not show anything below a depth of int directories. Default is 5 (also see BUGS below).

       --max-lines int
              Only consider the int biggest files and directories within the output of du.

       --no-diffs
              Use  this  if  you  are not interested in the history of the directories processed, for example in
              /tmp.

       --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  current  state,  overwriting  a  previous --discard.  (Some people seem to have gt5
              aliased to 'gt5--discard'.)

       --verbose
              Display messages.

       --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

See Also

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

gt5 v1.4.0.1                                        July 2009                                             gt5(1)

Synopsis

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

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, unfavourablecursornavigation

       retawq:
              no colors, can't handle <a name>-tags

       w3m:   Version0.5.2andlaterareknowntowork.Olderversionsexperiencedunfavourable handling of  <a
              name>-tag, unfavourablecursornavigation and no colors

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

See Also