httpdirfs(1)

HTTPDIRFS(1) User Commands HTTPDIRFS(1)

NAME

HTTPDirFS - "mount HTTP directory as a virtual filesystem"

DESCRIPTION

usage: 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-1.2.9")
--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

error: no mountpoint specified

libcurl SSL engine: GnuTLS/3.8.13 Failed to call 'fusermount3': No such file or directory Running 'fusermount3 --version' failedFUSE library version 3.18.1 using FUSE kernel interface version 7.45

May 2026 HTTPDirFS version 1.2.9