NAME

     netcache — local Internet cache handler for offpunk

SYNOPSIS

     netcache [--path] [--offline] [--max-size MAX_SIZE] [--timeout TIMEOUT] [URL ...]
     netcache -h | --help

DESCRIPTION

     Netcache is the download and cache management engine of the browser offpunk(1).  It allows
     one to fetch a link and get its content, writing the content through the local cache for
     ulterior reference.  Netcache can be forced into offline mode, in order to only fetch
     resources from the local cache, otherwise it would always refresh it from the version
     available online.  It is also useful for mapping a given URL to its location in the cache,
     independently of whether it has been downloaded first.

     Default cache path is ~/.cache/offpunk.  Set OFFPUNK_CACHE_PATH environment variable to use
     another location.

     OFFPUNK_CACHE_PATH=/home/ploum/custom-cache netcache.py gemini://some.url

     Offpunk(1) is a command-line browser and feed reader dedicated to browsing the Web, Gemini,
     Gopher and Spartan.

   Positional arguments
           URL     download the URL and output the content.

   Keyword arguments
           -h, --help
                   show a help message and exit.

           --path  output the path to the cache instead of the content of the URL.

           --max-size MAX_SIZE
                   cancel download of items above that size.  The value is expressed in
                   megabytes.

           --timeout TIMEOUT
                   time to wait before cancelling connection.  The value is expressed in seconds.

           --cache-validity -CACHE_VALIDITY
                   Maximum age (in second) of the cached version before redownloading a new
                   version.

EXIT STATUS

     The netcache utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     ansicat(1), migrate-offpunk-cache(1), offpunk(1), opnk(1), https://sr.ht/~lioploum/offpunk/

AUTHORS

     Lionel Dricot (Ploum) <offpunk2 at ploum.eu>