sergios/headless_file_server repository overview

⁠1. Introduction

File Server for use with a Media Player such as the one in angular-media-player Project.

• define which host folders you want to serve
• CORS ready
• written in Java / Spring
• based on java.nio (NIO stands for Non-blocking I/O)
• supports huge host folders
• up to 3 host folders can be shared

⁠2. How to Run ?

• Start a file server for /home/sergios/Music host folder

docker run -it --rm -p 8080:8080 -v /home/sergios/Music:/hostMusicRoot:ro sergios/headless_file_server

Do not forget to change the path to something valid on your host !

• To serve a second host folder, use a command like:

docker run -it --rm -p 8080:8080 -v /home/sergios/Music:/hostMusicRoot:ro -v /home/sergios/Videos:/hostVideoRoot:ro sergios/headless_file_server

• To check your config, point your browser to:

http://localhost:8080/headless-file-server/fileExplorerSearch/load/fileExplorerSearchTreeOptions

You should receive a JSON response that reflects a portion of your host folder.

⁠3. So What ?

Install the media player angular-media-player and enjoy your music, videos and pictures like never before.