mar10 · mar10 · Mar 25, 2025 · Mar 25, 2025 · Mar 26, 2025 · Mar 26, 2025
diff --git a/.gitignore b/.gitignore
@@ -36,4 +36,5 @@ wsgidav*.yaml
 wsgidav-props.shelve.dat
 wsgidav-props.shelve.dir
 manifests/
+wsgidav/dav_explorer/htdocs/wunderbaum.*
 wsgidav/dir_browser_2/htdocs/wunderbaum.esm.js
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,10 +1,14 @@
 # Changelog
 
+## `feature/update-web-ui` / Unreleased
+
+- WsgiDavExplorer: new web frontend that replaces DirBrowser by default.
+
 ## 4.4.0 / Unreleased
 
-- [#343](https://github.com/mar10/wsgidav/issues/343) 
+- [#343](https://github.com/mar10/wsgidav/issues/343)
   Add experimental middleware for impersonation (@leo9800)
-- [#348](https://github.com/mar10/wsgidav/issues/348) 
+- [#348](https://github.com/mar10/wsgidav/issues/348)
   Optionally set file/directory modification time when x-oc-mtime header presence (@leo9800)
 - [#352](https://github.com/mar10/wsgidav/pull/352)
   Apache htpasswd based domain controller (@leo9800)

diff --git a/README.md b/README.md
@@ -77,8 +77,12 @@ Main features:
   Its open architecture allows to extend the functionality and integrate
   WebDAV services into your project.<br>
   Typical use cases are:
-  - Expose data structures as virtual, editable file systems.
-  - Allow online editing of MS Office documents.
+  - Expose data structures as virtual, editable file systems, that can be mapped in 
+    _macoOS Finder_, _Windows File Explorer_, etc.
+  - Allow online editing of _MS Office_ and _LibreOffice_ documents.
+
+- _DAV Explorer_: A simple built-in web interface allows up- and download files, 
+  rename, move, copy, delete operations, and peviews.
 
 ## Status
 

diff --git a/docs/source/DAV_Explorer.png b/docs/source/DAV_Explorer.png
diff --git a/docs/source/api-doc.rst b/docs/source/api-doc.rst
@@ -27,6 +27,7 @@ Package ``wsgidav``
    wsgidav.dav_error
    wsgidav.dav_provider
    wsgidav.dir_browser
+   wsgidav.dav_explorer
    wsgidav.error_printer
    wsgidav.fs_dav_provider
    wsgidav.http_authenticator

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -29,22 +29,47 @@ Main Features
 - Comes bundled with a server and a file system provider, so we can share a
   directory right away from the command line.
 - Designed to run behind any WSGI compliant server.
-- Tested with different clients on different platforms (Windows, Linux, Mac).
+- Tested with different clients on different platforms (Windows, Linux, macOS).
 - Supports online editing of MS Office documents.
 - Contains a simple web browser interface.
 - SSL support
 - Support for authentication using Basic or Digest scheme.
 - Passes the `litmus test suite <http://www.webdav.org/neon/litmus/>`_.
 - Open architecture allows to :doc:`user_guide_custom_providers`
   (i.e. storage, locking, authentication, virtual file systems, ...).
-- WsgiDAV is a `refactored version of PyFileServer <https://github.com/mar10/wsgidav/blob/master/docs/source/changelog04.md>`_
-  written by Ho Chun Wei.
 
 
+DAV Explorer
+------------
+WsgiDAV comes with a slick web interface that allows to explore the DAV share and 
+perform basic operations (create, delete, move, copy, rename, ...) directly
+in the browser, without the need for additional software or drive mapping. |br|
+Up- and downloading of files is supported using drag-and-drop or file dialogs. |br|
+Also inline editing of office documents is supported when MS Office or LibreOffice is 
+installed on the client machine.
+
+.. image:: DAV_Explorer.png
+  :name: WsgiDAV explorer
+
 .. note::
 
-  Release 4.0 introduces some refactorings and breaking changes. |br|
-  See :doc:`changes` for details.
+  DAV Explorer is available since version 4.4. |br|
+  It has beta status and is not enabled by default, but must be explicitly enabled 
+  in the configuration file ``wsgidav.yaml``.
+
+
+Supported Clients
+-----------------
+
+WsgiDAV comes with a web interface and was tested with different clients
+(Windows File Explorer, macOS Finder, MS Office, LibreOffice, ...).
+
+.. image:: teaser.png
+  :name: WsgiDAV clients
+
+..
+  .. seealso::
+  	:doc:`run-access`
 
 
 Quickstart
@@ -76,7 +101,7 @@ WebDAV-aware client, such as MS Word, macOS Finder, Windows File Explorer, ...
   $ wsgidav --host=0.0.0.0 --port=80 --root=/tmp --auth=pam-login
 
 **On Windows** we can enforce authentication against known users (e.g.
-Windows NT Domain Controller) like so::
+Windows Domain Controller) like so::
 
   > wsgidav --host=0.0.0.0 --port=80 --root=/tmp --auth=nt
 
@@ -96,18 +121,6 @@ for example::
     $ docker run --rm -it -p 8080:8080 -v c:/temp:/var/wsgidav-root mar10/wsgidav
 
 
-Supported Clients
-=================
-
-WsgiDAV comes with a web interface and was tested with different clients
-(Windows File Explorer and drive mapping, MS Office, Ubuntu, Mac OS X, ...).
-
-.. image:: teaser.png
-  :name: WsgiDAV clients
-
-..
-  .. seealso::
-  	:doc:`run-access`
 
 
 .. |logo| image:: logo.png

diff --git a/docs/source/reference_guide_architecture.rst b/docs/source/reference_guide_architecture.rst
@@ -35,7 +35,7 @@ WsgiDAV implements this WSGI application stack::
                   http_authenticator.HTTPAuthenticator (middleware)
                     |           \- Uses a domain controller object
                     |
-                  dir_browser.WsgiDavDirBrowser (middleware, optional)
+                  dav_explorer.WsgiDavExplorer (middleware, optional)
                     |
                   request_resolver.RequestResolver (middleware)
                     |
@@ -151,7 +151,7 @@ interface is implemented.
 Applications
 ============
 
-.. inheritance-diagram:: wsgidav.mw.base_mw wsgidav.dir_browser wsgidav.mw.cors wsgidav.mw.debug_filter wsgidav.dav_error wsgidav.error_printer wsgidav.http_authenticator wsgidav.rw_lock wsgidav.wsgidav_app wsgidav.request_server wsgidav.request_resolver
+.. inheritance-diagram:: wsgidav.mw.base_mw wsgidav.dir_browser wsgidav.dav_explorer wsgidav.mw.cors wsgidav.mw.debug_filter wsgidav.dav_error wsgidav.error_printer wsgidav.http_authenticator wsgidav.rw_lock wsgidav.wsgidav_app wsgidav.request_server wsgidav.request_resolver
    :parts: 2
    :private-bases:
 
@@ -208,9 +208,9 @@ For every request:
         ``environ['httpauthentication.username']``
 
 
-WsgiDavDirBrowser
+WsgiDavExplorer
 -----------------
-Middleware :class:`wsgidav.dir_browser._dir_browser.WsgiDavDirBrowser`.
+Middleware :class:`wsgidav.dav_explorer.app.WsgiDavExplorer`.
 Handles GET requests on collections to display a HTML directory listing.
 
 On init:
@@ -223,6 +223,13 @@ For every request:
         Render collection members as directory (HTML table).
 
 
+WsgiDavDirBrowser
+-----------------
+Middleware :class:`wsgidav.dir_browser._dir_browser.WsgiDavDirBrowser`.
+
+Deprecated: replaced by :class:`wsgidav.dav_explorer.app.WsgiDavExplorer`.
+
+
 RequestResolver
 ---------------
 Middleware :class:`wsgidav.request_resolver.RequestResolver`.

diff --git a/docs/source/sample_wsgidav.json b/docs/source/sample_wsgidav.json
@@ -20,8 +20,8 @@
         "/share2": "/path/to/share2"
     },
     "http_authenticator": {
-        "domain_controller": null,  // Use simple_dc
-        "accept_basic": false,  // Force digest authentication
+        "domain_controller": null, // Use simple_dc
+        "accept_basic": false, // Force digest authentication
         "accept_digest": true,
         "default_to_digest": true,
         "trusted_auth_header": null
@@ -33,7 +33,7 @@
                     "password": "abc123"
                 }
             },
-            "/share2": true  // Allow anonymous access
+            "/share2": true // Allow anonymous access
         }
     },
     "dir_browser": {
@@ -43,5 +43,10 @@
         "davmount_links": false,
         "ms_sharepoint_support": true,
         "htdocs_path": null
+    },
+    "dav_explorer": {
+        "enable": true,
+        "response_trailer": "",
+        "htdocs_path": null
     }
-}
+}
diff --git a/docs/source/user_guide.rst b/docs/source/user_guide.rst
@@ -11,6 +11,7 @@ This section describes how to *use* the WsgiDAV library. |br|
    user_guide_cli
    user_guide_configure
    user_guide_access
+   user_guide_dav_explorer
    user_guide_lib
    user_guide_custom_providers.rst
    faq.rst
diff --git a/docs/source/user_guide_cli.rst b/docs/source/user_guide_cli.rst
@@ -5,8 +5,8 @@ Command Line Interface
 
 The WsgiDAV server was tested with these platforms
 
-  * Mac OS X
-  * Ubuntu
+  * macOS
+  * Linux
   * Windows
 
 To serve the ``/tmp`` folder as WebDAV ``/`` share, simply run::

diff --git a/docs/source/user_guide_configure.rst b/docs/source/user_guide_configure.rst
@@ -124,7 +124,7 @@ pass the class instead of the instantiated object.
 The built-in middleware derives from :class:`~wsgidav.mw.base_mw.BaseMiddleware`,
 so we can simplify as::
 
-    from wsgidav.dir_browser import WsgiDavDirBrowser
+    from wsgidav.dav_explorer import WsgiDavExplorer
     from wsgidav.mw.debug_filter import WsgiDavDebugFilter
     from wsgidav.error_printer import ErrorPrinter
     from wsgidav.http_authenticator import HTTPAuthenticator
@@ -136,7 +136,7 @@ so we can simplify as::
             WsgiDavDebugFilter,
             ErrorPrinter,
             HTTPAuthenticator,
-            WsgiDavDirBrowser,
+            WsgiDavExplorer,
             RequestResolver,  # this must be the last middleware item
             ],
         ...
@@ -147,7 +147,7 @@ removes the directory browser, and adds a third-party debugging tool::
 
     import dozer
 
-    # from wsgidav.dir_browser import WsgiDavDirBrowser
+    # from wsgidav.dav_explorer import WsgiDavExplorer
     from wsgidav.mw.debug_filter import WsgiDavDebugFilter
     from wsgidav.error_printer import ErrorPrinter
     from wsgidav.http_authenticator import HTTPAuthenticator
@@ -166,7 +166,7 @@ removes the directory browser, and adds a third-party debugging tool::
             WsgiDavDebugFilter,
             ErrorPrinter,
             HTTPAuthenticator,
-            # WsgiDavDirBrowser,
+            # WsgiDavExplorer,
             RequestResolver,  # this must be the last middleware item
             ],
         ...
@@ -191,7 +191,7 @@ should be explicitly listed::
         - wsgidav.mw.debug_filter.WsgiDavDebugFilter
         - wsgidav.error_printer.ErrorPrinter
         - wsgidav.http_authenticator.HTTPAuthenticator
-        - wsgidav.dir_browser.WsgiDavDirBrowser
+        - wsgidav.dav_explorer.WsgiDavExplorer
         - wsgidav.request_resolver.RequestResolver
 
 It is also possible to pass options as named args (i.e. 'kwargs')::

diff --git a/docs/source/user_guide_dav_explorer.rst b/docs/source/user_guide_dav_explorer.rst
@@ -0,0 +1,40 @@
+============
+DAV Explorer
+============
+
+*This section describes how to use the built-in WsgiDAV web interface, DAV Explorer.*
+
+WsgiDAV comes with a slick web interface that allows to explore the DAV share and 
+perform basic operations (create, delete, move, copy, rename, ...) directly
+in the browser, without the need for additional software or drive mapping. |br|
+Up- and downloading of files is supported using drag-and-drop or file dialogs. |br|
+Also inline editing of office documents is supported when MS Office or LibreOffice is 
+installed on the client machine.
+
+.. image:: DAV_Explorer.png
+  :name: WsgiDAV explorer
+
+.. note::
+
+  DAV Explorer is available since version 4.4. |br|
+  It has beta status and is not enabled by default, but must be explicitly enabled 
+  in the configuration file ``wsgidav.yaml``.
+
+.. toctree::
+   :maxdepth: 1
+
+Configuration
+-------------
+
+TODO: Add configuration instructions here. |br|
+See :doc:`user_guide_configure` for more details on how to configure WsgiDAV.
+
+Using DAV Explorer
+------------------
+
+TODO: Add detailed instructions here.
+
+Known Limitations
+-----------------
+
+TODO: Add detailed instructions here.
diff --git a/docs/source/user_guide_lib.rst b/docs/source/user_guide_lib.rst
@@ -6,8 +6,8 @@ Using the Library
    :hidden:
 
 
-This section describes how to use the ``wsgidav`` package to implement custom
-WebDAV servers.
+*This section describes how to use the ``wsgidav`` package in your Python projects 
+to implement custom WebDAV servers.*
 
 
 .. todo::

diff --git a/pyproject.toml b/pyproject.toml
@@ -16,7 +16,10 @@ select = [
   "T",  # print, ...
   # "D",   # pydocstyle
   "I", # isort
-  # "C",  # codespell
+# "C",  # codespell
+  "W191", # Indentation contains tabs
+  "W292", # Trailing whitespace
+  "W293", # Blank line contains whitespace
   # "SIM",  # 
 ]
 

diff --git a/sample_wsgidav.yaml b/sample_wsgidav.yaml
@@ -101,8 +101,9 @@ middleware_stack:
     # - wsgidav.mw.debug_filter.WsgiDavDebugFilter
     - wsgidav.error_printer.ErrorPrinter
     - wsgidav.http_authenticator.HTTPAuthenticator
+    # - wsgidav.dir_browser.WsgiDavDirBrowser
+    - wsgidav.dav_explorer.WsgiDavExplorer
     # - wsgidav.mw.impersonator.Impersonator
-    - wsgidav.dir_browser.WsgiDavDirBrowser
     - wsgidav.request_resolver.RequestResolver  # this must be the last middleware item
 
 # ==============================================================================
@@ -354,12 +355,12 @@ logging:
 
 
 # ----------------------------------------------------------------------------
-# WsgiDavDirBrowser
+# WsgiDavExplorer
 
-dir_browser:
+dav_explorer:
     enable: true
     #: List of fnmatch patterns that will be hidden in the directory listing
-    ignore:
+    ignore_list:
         - '.DS_Store'  # macOS folder meta data
         - 'Thumbs.db'  # Windows image previews
         - '._*'  # macOS hidden data files
@@ -371,22 +372,10 @@ dir_browser:
     response_trailer: true
     #: Display the name and realm of the authenticated user (or 'anomymous')
     show_user: true
-    show_logout: true
-    #: Send <dm:mount> response if request URL contains '?davmount'
-    #: (See https://tools.ietf.org/html/rfc4709)
-    davmount: true
-    #: Add a 'Mount' link at the top of the listing
-    davmount_links: false
-    #: Invoke MS Office documents for editing using WebDAV by adding a JavaScript
-    #: click handler.
-    #: - For IE 11 and below invokes the SharePoint ActiveXObject("SharePoint.OpenDocuments")
-    #: - If the custom legacy Firefox plugin is available, it will be used
-    #:   https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ff407576(v%3Doffice.14)
-    #: - Otherwise the Office URL prefix is used (e.g. 'ms-word:ofe|u|http://server/path/file.docx')
-    ms_sharepoint_support: true
-    #: Invoke Libre Office documents for editing using WebDAV
-    libre_office_support: true
+    show_login: true
+    #: Generate `ms-word:ofe|u|" prefix for office URLs (Microsoft and LibreOffice)
+    office_support: true
     #: The path to the directory that contains template.html and associated
     #: assets.
-    #: The default is the htdocs directory within the dir_browser directory.
+    #: The default is the htdocs directory within the dav_explorer directory.
     htdocs_path: null
diff --git a/setup.cfg b/setup.cfg
@@ -84,6 +84,7 @@ exclude =
 # 	CHANGELOG.md
 wsgidav =
 	dir_browser/htdocs/*.*
+	dav_explorer/htdocs/*.*
 
 
 [options.data_files]