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>

Debian                                           August 27, 2023                                     NETCACHE(1)