# DOcument eXchange (DOX)

### Overview

DOX offers web based document exchange with versioning and user management.
DOX is designed as a modern replacement of ftp with more features.

DOX consists of folders (toplevel directories) which belong to specific owners.
A folder can contain any number of document files or subdirectories.

An owner can make his folders public (anonymous usage) or private.
In private mode you have to log in with user/password (given by the owner) to have access to the DOX folder.

### Owner and users

DOX has two different views: owner or user

- For user view you need a DOX URL from the owner, e.g.
  https://fex.rus.uni-stuttgart.de/dox/framstag@rus.uni-stuttgart.de/test/
  It offers you read access only to this folder (and subdirectories).
  You can read or download files or directories.
  File upload has to be enabled by the owner.
  Example screenshot:

You can use the CLI client fexdox for file syncing and a webbrowser to download or upload documents.

Some document types like GIF PNG JPG PDF HTML TXT can be viewed directly with a webbrowser.

### Actions

[list it] | list all files in all directories on one page
[zip it] | make a zip archive and offer download link
[fex it] | fex the files to your email address
[sync it] | start fexsync for download
[stream it] | start sexsend for download (prefered download methode for BIG folders)
[send file] | fex a local file to the owner
[upload] | upload a local file or directory to the folder upload area
[notify owner] | send a notification email about the upload to the owner
[publish] | move the upload to the regular folder

Note: [upload] [notify owner] [publish] are only available if the owner has enabled user upload.

Directory upload is only possible with Google Chrome, with other webbrowsers you first have to create a local "dox.zip" and then upload it.
After upload it will be extracted.

### Restrictions

DOX cannot handle files or directories with newline character in their filename.