/lWS

lightweight Web Server (lWS) for Android

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

lightweight Web Server (lWS) for Android

Available on Google Play Tavis CI Build Status Available on F-Droid

lWS

lWS

It is ...

  • ... Web Server for static content.
  • ... lightweight. APK size less then 100 Kb.
  • ... as simple as possible. Only essential features implemented.
  • ... open. Source code released under GPL-3.0.
  • ... personal solution. It is not optimized/tested for many parallel connections and large file transfer.
  • ... network state responsive. Require WiFi connected or tethering enabled. Service stop automatically if network disconnected.
  • ... connect to lopback interface if no other available.

Derivate from

This project based on another open source project Unfortunately, original project didn't maintained for 3 years.

What is configurable

  • Document root. Path may be entered as text or optional elected using OI File Manager.
  • Port. May be from 1024 to 65535. Default is 8080 In attempt to set wrong value parameter automatically set to default.

Document root

Document root by default set to application private directory. Example index file automatically created. It is safe configuration. You can place your pages in this directory. But be carefully! If you use Android 5.0 or above and deinstall the application this directory and it's content will be removed.

"Open in browser" and "Send URL"

After server starts you can press "Open in browser" button for check. You can send working server URL to another device by Bluetooth, Android Beam, E-Mail and other way available on your device.

On screen log

The application has no permanent logging. I treat this as redundant functionality. I doing my best to make notification actual all time. On screen log actual only then application visible. Log screen may be cleared after returning from background.

Security warning

You can change document root to any readable point of file system, but you need to understand what are you doing. Be careful: you could (suddenly?) create the configuration so way, than anyone on the same WiFi network could access to the data on your device either you don't like it. All files from document root and below available for reading without any restrictions to anyone who connected to network and known URL of the server.

License

lWS is licensed under the GPLv3 License because original project Directory listing sort based on this project licensed under GPL-3.0

Artwork

  • File listing icons from Feather project released under MIT license.
  • Application icon designed specially for this application.