HTTPDIRFS(1)

📦
version 1.3.3 · 10 versions
, in ubuntu stonking

💖 HTTPDirFS 💖

okay bestie, sit DOWN, because we're talking about HTTPDirFS — that's section 1 (User Commands) of the manual, the one and only. 🫶

✨ NAME ✨

HTTPDirFS — "mount HTTP directory as a virtual filesystem" 💅 no cap, that's literally the whole job description

🌸 DESCRIPTION 🌸

🎀 general options:

  • --config — bestie you can point it at a configuration file. specify it. 💖
  • -o opt,[opt...] — mount options, plural, as many as your heart desires
  • -h, --help — print help 🫶
  • -V, --version — print version
  • -f — foreground operation (it stays right there with you, main character energy)
  • -s — disable multi-threaded operation
  • -d, --debug — enable debug output (and heads up: this implies -f, it's giving package deal)

🦋 HTTPDirFS options:

  • -u, --username — HTTP authentication username
  • -p, --password — HTTP authentication password 🤫
  • -P, --proxy — proxy for libcurl, and for more deets go look at 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
  • --proxy-capath — certificate authority directory 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 you specified with --cache-location, if the option is seen first. then exit either way. bye bestie 👋
  • --cache-min-size — set minimum file size threshold for caching, in bytes (default: none)
  • --cache-max-size — set maximum file size threshold for caching, in bytes (default: none)
  • --cacert — certificate authority for the server
  • --capath — certificate authority directory 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. it said what it said.
  • --http-header — set one or more HTTP headers
  • --max-conns — set maximum number of network connections that libcurl is allowed to make (default: 6)
  • --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.3.3")
  • --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 libcurl TLS certificate verification by setting CURLOPT_SSL_VERIFYHOST to 0 🔥
  • --external-links — include external (cross-origin) links from directory listings (default: off)
  • --single-file-mode — single file mode — rather than mounting a whole directory, present a single file inside a virtual directory. it's giving minimalism.

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

usage:

/build/httpdirfs-fuse-XZnU0P/httpdirfs-fuse-1.3.3/obj-x86_64-linux-gnu/httpdirfs [options] <mountpoint>

🌈 FUSE options:

  • -h, --help — print help
  • -V, --version — print version
  • -d, -o debug — enable debug output (implies -f)
  • -f — foreground operation
  • -s — disable multi-threaded operation
  • -o clone_fd — use separate fuse device fd for each thread (may improve performance) 💅
  • -o max_idle_threads — the maximum number of idle worker threads allowed (default: -1)
  • -o max_threads — the maximum number of worker threads allowed (default: 10)
  • -o kernel_cache — cache files in kernel
  • -o [no]auto_cache — enable caching based on modification times (off)
  • -o no_rofd_flush — disable flushing of read-only fd on close (off)
  • -o umask=M — set file permissions (octal)
  • -o fmask=M — set file permissions (octal)
  • -o dmask=M — set dir permissions (octal)
  • -o uid=N — set file owner
  • -o gid=N — set file group
  • -o entry_timeout=T — cache timeout for names (1.0s)
  • -o negative_timeout=T — cache timeout for deleted names (0.0s)
  • -o attr_timeout=T — cache timeout for attributes (1.0s)
  • -o ac_attr_timeout=T — auto cache timeout for attributes (attr_timeout)
  • -o noforget — never forget cached inodes 🫶
  • -o remember=T — remember cached inodes for T seconds (0s)
  • -o modules=M1[:M2...] — names of modules to push onto filesystem stack
  • -o allow_other — allow access by all users
  • -o allow_root — allow access by root
  • -o auto_unmount — auto unmount on process termination
  • -o io_uring — enable io-uring
  • -o io_uring_q_depth=<n> — io-uring queue depth

🧚 Options for subdir module:

  • -o subdir=DIR — prepend this directory to all paths (mandatory)
  • -o [no]rellinks — transform absolute symlinks to relative

💜 Options for iconv module:

  • -o from_code=CHARSET — original encoding of file names (default: UTF-8)
  • -o to_code=CHARSET — new encoding of the file names (default: ANSI_X3.4-1968)

and then, slay, here's the little run-status spiel it spits out, verbatim, no notes:

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

and that's the whole page, bestie!! 💖 this gorgeous thing is HTTPDirFS version 1.3.3, and it was dated August 2026. go mount something iconic. periodt. ✨🦋🎀

📦 where this page comes from