# helloxz/zdir

A multifunctional private storage program that integrates file indexing, online preview, and sharing, supporting both WebDAV and cloud download.

Repository: https://github.com/helloxz/zdir
Canonical: https://ross.abutalabs.com/products/zdir
Homepage: https://www.zdir.pro
Language: Go
License: Apache-2.0
License Family: permissive
Topics: alist, file-browser, h5ai, webdav, zdir
Last push: 2024-08-15T11:22:27+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2998, "days_push": 748, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1533, forks 346 (observed 2026-08-28T04:04:59.568345+00:00)

## What it is
Zdir is a self-hosted private storage and file-sharing application built with Golang and Vue3 that indexes directories, previews files online, and supports sharing, WebDAV server access, and cloud (offline) downloads. It is designed for NAS devices or VPS use by individuals, studios, and small teams, though from version 4.x the latest releases are closed-source with the open code limited to earlier versions.

## Use cases
- self-host a file browser and index for my VPS like h5ai or alist
- share files with expiry links from my own server
- serve a WebDAV endpoint over my local files
- preview images, videos, and documents in the browser
- download files from URLs and magnet links to my server
- search across all files on my NAS from a web UI
- edit text files online on my server

## When to avoid
- you require fully open-source software for the latest version, since 4.x is closed-source and commercial
- you need a distributed or multi-tenant enterprise file platform
- you only need simple static directory listing without a web application

## Facets
- artifact type: application
- maturity: active
- function: file-system, search-engine, http-server, web-scraping
- domain: self-hosted, files, web-development, developer-tools
- platform: self-hosted, cross-platform
- tags: file-indexing, webdav-server, file-sharing, online-preview, cloud-download, nas, golang, vue3, freemium, linux, docker, web-server

## Member repositories
- helloxz/zdir (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:59.568345+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:14.991048+00:00, confidence not recorded.
  - readme: https://github.com/helloxz/zdir (fetched 2026-08-28T04:04:59.568345+00:00, sha e1b13f704b8b)
  - homepage: https://www.zdir.pro (fetched 2026-08-29T11:33:13.140081+00:00, sha b4c3c89c526f)
- Data as of 2026-08-30T08:39:29.467469+00:00.