No description
Find a file
2025-06-05 12:16:58 +10:00
.assets documentation (README): update project README 2019-04-16 15:57:42 +10:00
.github chore (github): update github template 2024-09-16 15:24:06 +10:00
client fix (safari): iframe issue on current frontend 2024-09-08 21:15:56 +10:00
cmd fix (plugin): order of plugin init 2025-04-01 10:34:23 +11:00
config chore (cleanup): cleanup code 2025-06-05 12:16:58 +10:00
docker fix (docker): remove unready stuff 2025-02-27 13:25:26 +11:00
public chore (cleanup): cleanup code 2025-06-05 12:16:58 +10:00
server chore (legacy): remove legacy stuff 2025-05-26 16:57:36 +10:00
.babelrc test ci 2018-09-24 23:16:23 +10:00
.editorconfig maintenance (editorconfig): as per #107 2019-12-17 14:01:41 +11:00
.eslintrc.json fix (eslint): linting 2022-01-31 17:43:45 +11:00
.gitignore chore (cleanup): cleanup before release 2023-10-20 20:16:39 +11:00
CONTRIBUTING.md fix (api): api key validation 2023-10-31 08:43:47 +11:00
embed.go release (migration): migration of admin interface 2023-10-07 22:47:37 +11:00
go.mod chore (tidy): go mod tidy 2025-05-22 02:23:57 +10:00
go.sum chore (tidy): go mod tidy 2025-05-22 02:23:57 +10:00
Jenkinsfile chore (arm): disable arm build for now 2024-09-18 13:30:21 +10:00
LICENSE Initial commit 2017-06-13 15:34:14 +10:00
Makefile chore (rewrite): improve loading speed on new release 2024-07-19 07:54:15 +10:00
package.json fix (webpack): uglify plugin is broken 2024-11-20 16:58:24 +11:00
README.md doc (README): revamp README 2024-11-08 14:58:17 +11:00
webpack.config.js fix (webpack): uglify plugin is broken 2024-11-20 16:58:24 +11:00

screenshot

A Dropbox-like file manager that let you manage your data anywhere it is located:
FTP • FTPS • SFTPWebDAV • Git • S3 • NFS • SMB • Artifactory • LDAP • Mysql
Storj • CardDAV • CalDAV • Backblaze B2 • Minio
Dropbox • Google Drive

demo button

Features

  • Manage your files from a browser
  • Authentication middleware to connect to various source of user
  • Flexible Share mechanism
  • Chromecast support for images, music, and videos
  • Video player
  • Video transcoding (mov, mkv, avi, mpeg, and more)
  • Image viewer
  • Image transcoding (raw images from Nikon, Canon, and more)
  • Photo management
  • Audio player
  • Shared links are full fledge network drive
  • Office documents (docx, xlsx and more)
  • Full org mode client (documentation)
  • User friendly
  • Mobile friendly
  • Customisable
  • Plugins
  • Super fast
  • Upload files and folders
  • Download as zip
  • Multiple cloud providers and protocols, easily extensible
  • Nyan cat loader
  • Emacs, VIM or Sublime keybindings ;)
  • Pluggable Search (default is recursive search)
  • .. and many more

Screenshots

user experience on navigation

user experience on medias

Core Principles and Ideas

Filestash started as an attempt to solve the "Dropbox problem" by abstracting the storage layer, allowing you to "bring your own backend" by implementing this interface:

type IBackend interface {
	Init(params map[string]string, app *App) (IBackend, error) // constructor
	Ls(path string) ([]os.FileInfo, error)           // list files in a folder
	Cat(path string) (io.ReadCloser, error)          // download a file
	Mkdir(path string) error                         // create a folder
	Rm(path string) error                            // remove something
	Mv(from string, to string) error                 // rename something
	Save(path string, file io.Reader) error          // save a file
	Touch(path string) error                         // create a file
	LoginForm() Form                                 // dynamic form generation for the login
}

The software is effectively 2 distinct parts: Core and Plugins. Plugins act as "Lego blocks" that shape all the opinions on how the file manager operates, such as who can do what and where (aka, the authorisation), how the search features work (e.g., recursive search, full text search, ...), how users are authenticated (e.g., passthrough to the storage layer, LDAP, OIDC, SAML, signed URLs), how the application behaves when opening different file types, etc...

The architecture is designed to enable implementers to build file managers that are fit for purpose. To cite an example, several control panels for elevators in Europe feature QR codes generated by Filestash. Technicians responsible for their maintenance scan these QR codes to access the complete history of the elevator, upload new records, access relevant external resources, and view a banner displaying location specific metadata from the ERP. What would have been a complex custom solution was made possible through the addition of two plugins: one for QR code generation and another for ERP integration. Everything else was off the shelf.

Documentation

Support

Credits