HTTPDIRFS(1)

NAME
HTTPDirFS - "mount HTTP directory as a virtual filesystem"

DESCRIPTION
usage: /pbulk/work/filesystems/fuse-httpdirfs/work/httpdirfs-1.2.8/output/httpdirfs [options] URL mountpoint

  general options:

--config
    Specify a configuration file

-o opt,[opt...]
    Mount options

-h  --help
    Print help

-V  --version
    Print version

-f  Foreground operation

-s  Disable multi-threaded operation

-d  --debug
    Enable debug output (implies -f)

  HTTPDirFS options:

-u  --username
    HTTP authentication username

-p  --password
    HTTP authentication password

-P  --proxy
    Proxy for libcurl, for more details refer to https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html

--proxy-username
    Username for the proxy

--proxy-password
    Password for the proxy

--proxy-cacert
    Certificate authority for the proxy

--cache
    Enable cache (default: off)

--cache-location
    Set a custom cache location (default: "${XDG_CACHE_HOME}/httpdirfs")

--cache-clear
    Delete the cache directory or the custom location specified with `--cache-location`, if the option is seen first. Then exit in either case.

--cacert
    Certificate authority for the server

--dl-seg-size
    Set cache download segment size, in MB (default: 8) Note: this setting is ignored if previously cached data is found for the requested file.

--http-header
    Set one or more HTTP headers

--max-seg-count
    Set maximum number of download segments a file can have. (default: 128*1024) With the default setting, the maximum memory usage per file is 128KB. This allows caching files up to 1TB in size using the default segment size.

--max-conns
    Set maximum number of network connections that libcurl is allowed to make. (default: 10)

--refresh-timeout
    The directories are refreshed after the specified time, in seconds (default: 3600)

--retry-wait
    Set delay in seconds before retrying an HTTP request after encountering an error. (default: 5)

--invalid-refresh
    Try refreshing invalid links when reading a directory.

--user-agent
    Set user agent string (default: "HTTPDirFS")

--no-range-check
    Disable the built-in check for the server's support for HTTP range requests

--zero-len-is-dir
    If a file has a zero length, treat it as a directory

--insecure-tls
    Disable licurl TLS certificate verification by setting CURLOPT_SSL_VERIFYHOST to 0

--single-file-mode
    Single file mode - rather than mounting a whole directory, present a single file inside a virtual directory.

    For mounting a Airsonic / Subsonic server:

--sonic-username
    The username for your Airsonic / Subsonic server

--sonic-password
    The password for your Airsonic / Subsonic server

--sonic-id3
    Enable ID3 mode - this present the server content in Artist/Album/Song layout

--sonic-insecure
    Authenticate against your Airsonic / Subsonic server using the insecure username / hex encoded password scheme

  refuse options:

-d, -o debug
    enable debug output, implies -f

-f  foreground mode

-s  single threaded mode (always enabled for now)

-o fsname=NAME
    explicitly set the name of the file system

libcurl SSL engine: OpenSSL/3.5.7