webdav-browser-extension

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #llm #golang #android #machine-learning #deep-learning #windows #awesome #cli #security

webdav-browser-extension

(★ 35)

Browser extension to browse a URL as a WebDAV share. You can not only list files but also upload and delete

webdav-browser-extension Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WebDAV browser extension

[По-русски](./README.ru.md)

Chrome and Firefox extension to browse a URL as a WebDAV share.

![screenshot](https://raw.githubusercontent.com/WebDAVDevs/webdav-browser-extension/master/screenshot.png)

Open the WebDAV folder in a browser and you'll have either `403 Forbidden` error or just a plain directory listing.
Then click on the addon button and it will make a file manager from the folder.
With the file manager you can watch, upload, delete files and directories.

See [usage video](usage.gif)

## Install
* [Firefox](https://addons.mozilla.org/en-US/firefox/addon/webdav-browser/)
* Chrome: TBD (I don't have a dev account)
* [Edge](https://microsoftedge.microsoft.com/addons/detail/webdav-browser/eombekfdnaaaakejkpdncleghmfmmjfo)
* Mobile Firefox via UserScript in TamperMonkey https://gist.github.com/stokito/a7babfa3c04c92c6c4142581145fe33d

## See also
* [File Management WebDav Browser Application](https://chromewebstore.google.com/detail/file-management-webdav/famepaffkmmhdefbapbadnniioekdppm) - a powerful app to connect to any WebDAV sever.
* [WebDAV User Script for Tampermonkey, Greasemonkey and Violentmonkey](https://gist.github.com/stokito/a7babfa3c04c92c6c4142581145fe33d) it can be used on Firefox Mobile
* [Awesome WebDAV](https://github.com/stokito/awesome-webdav) list of useful software and services for WebDAV

## Automatic detection of WebDAV
The plugin tries to determine a webdav share itself with the following heuristics:
- Response to GET contains `DAV` header
- Response to GET with 403 or 405 status e.g. a typical response when a directory listing is disabled
- subdomain `dav` or `webdav` e.g. `https://dav.example.com/`
- path has directory `/dav/` or `/webdav/` e.g. `https://example.com/dav/`

This covers most cases.

## TODO and known problems
* You need a dir listing enabled otherwise it will fail due to a bug https://github.com/dom111/webdav-js/issues/123
* NextCloud restricts a content script injection, but you anyway don't need the plugin.
* [x] Remember folders that should be viewed as dav
* Use a state as for Dark Reader or tutorial.focus-mode. The current popup solution is lame.
* Autodetect a webdav share (partially solved):
  * [x] On 403 error we can try a PROPFIND or OPTIONS. If it was successful then load the UI.
  * [x] `DAV: 1,2,3` header is already in use but returned only on OPTIONS. Maybe add it on `GET /` 403 error? **UPD** It's not used by any server but you may add the header manually.
  * `Alt-Svc: dav` header https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Alt-Svc But nobody will set the header. Discussion about possible solutions https://lists.w3.org/Archives/Public/w3c-dist-auth/2023JanMar/0000.html
  * If the directory has a listing with a `<title>Index of ...</title>` then it may have a dav version too but unlikely.
  * [x] By a folder name `/dav/` or subdomain `dav.example.com`
  * List of existing cloud providers like `https://webdav.yandex.ru`. **UPD** Most providers have dav/webdav subdomain
* Option to load the webdav-js directly from CDN with the latest version
* Open any WebDAV server i.e. just as an app. See also https://github.com/dom111/webdav-js/issues/120

## Details
Currently there is no a simple solution to see and work with a WebDAV share for inexperienced users.
You need to mount a drive (which is not that easy) or you need to use a special software.
Ideally users should be able to do this just from a browser.
This is possible if install on a server a [webdav-js](https://github.com/dom111/webdav-js) script or use the webdav-js as a bookmarklet from a browser (still complicated for most users).
So we need to add the WebDAV support directly to a browser, or at least for now we can create an extension/addon/plugin.

To test it you can open any SVN repository and press on its icon.
For example SVN repo of the EmailRelay
https://svn.code.sf.net/p/emailrelay/code/trunk/

The SVN is based on WebDAV so you can probably even mount an SVN repo into folder.

The main goal of the plugin is to make an autodetect of WebDAV share.
So when you're opening a WebDAV share from a browser the `GET /` will result into 403 Forbidden error.
This is confusing, but it's how spec is written.
My plugin can catch 403 error and try to make a WebDAV PROPFIND call for a directory listing.
If it was successful then we can load the WebDAV UI.

But if the webdav share has a plain HTML directory listing enabled (e.g. 99% cases) then instead of 403 error it will generate a html list and return with 200 OK status.
In this case the plugin can't figure out that the folder is a webdav share.
Good news that in a spec there is a dedicated DAV header that shows that the url has a webdav share.
But the problem is that the header is returned only on OPTIONS call.
So again this can't be used out of the box.
But we may configure a server to always add the header (bad idea because it may have many options).

Currently the plugin just calls a webdav-js library that makes rendering of UI.
But the library is always assumed that a directory listing is enabled and fails if it's not.
I reported a bug https://github.com/dom111/webdav-js/issues/123 but it won't be fixed soon for sure.

Also I wanted to add a `dav://` protocol schema handler to the plugin but it's not possible: https://discourse.mozilla.org/t/protocol-handler-extension-for-webdav/111920

If anyone interested to test or contribute to the plugin I'll appreciate

### Manifest problem
When packing for Chrome use manifest.json but for firefox use manifest.firefox.json
**UPD** Now they are merged https://github.com/mozilla/web-ext/issues/2532#issuecomment-1992345597

webdav-browser-extension

webdav-browser-extension Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

webdav-browser-extension

webdav-browser-extension Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README