Skip to content
lightweight Web Server (lWS) for Android
Java HTML Shell
Branch: master
Clone or download
Pull request Compare This branch is 263 commits ahead of bodeme:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
gradle/wrapper
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
build.gradle
gradlew
ic_launcher-web.png
settings.gradle

README.md

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.
You can’t perform that action at this time.