lws - fixup description

This commit is contained in:
Licaon_Kter 2018-10-23 00:06:08 +00:00
parent 3a4f5679e3
commit d369cc4af3

View file

@ -1,6 +1,6 @@
Categories:Connectivity
License:GPL-3.0-only
Web Site:https://github.com/mvbasov/lWS
Web Site:
Source Code:https://github.com/mvbasov/lWS
Issue Tracker:https://github.com/mvbasov/lWS/issues
Changelog:https://github.com/mvbasov/lWS/releases
@ -10,56 +10,54 @@ Summary:lightweight Web Server (lWS)
Description:
'''It is ...'''
* ... Web Server for static content.
* ... a Web Server for static content.
* ... lightweight. APK size less then 100 Kb.
* ... as simple as possible. Only essential features implemented.
* ... open. [Source code](https://github.com/mvbasov/lWS") 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.
* ... open. [https://github.com/mvbasov/lWS Source code] released under GPL-3.0.
* ... a personal solution. It is not optimized/tested for many parallel connections and large file transfer.
* ... network state responsive. Requires Wi-Fi connected or tethering enabled. Service will stop automatically if network is disconnected.
'''Based on'''
This application is continue of development [Webserver for
Android](https://play.google.com/store/apps/details?id=com.bolutions.webserver)
which is [open source](https://github.com/bodeme/androidwebserver) and released
under GPL-3.0.
This application continues the development of
[https://github.com/bodeme/androidwebserver Webserver for Android].
'''What is configurable'''
* Document root. Path may be entered as text or optional select using OI File Manager. If it is not installed offer to install it.
* Port. May be from 1024 to 65535. Default is 8080
* Document root. Path may be entered as text or optionally selected using [[org.openintents.filemanager]]. If it is not installed it will offered for install.
* Port. May be between 1024 and 65535. Default is 8080
In attempt to set wrong value parameter automatically set to default.
Any wrong values in parameters will automatically be set back to their defaults.
'''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.
Document root by default is set to application private directory, example index
file automatically created. It is a safe configuration. You can place your pages
in this directory. But be careful! If you use Android 5.0 or above and uninstall
the application this directory and its content will be removed.
'''Security warning'''
You can change document root to any readable point of file system, but you need
You can change document root to any readable path on 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.
configuration so than anyone on the same Wi-Fi network could access the data on
your device whether you like it or not.__ All files from document root and below
are available for reading without any restrictions to anyone who's connected to
the network and knows the URL of the server.
'''"Send", "QR code" and "Browser"'''
After server starts you can press:
* "Browser" button for check server operation in local browser.
* "QR code" to call [lWS QR plugin](https://f-droid.org/app/net.basov.lws.qr.fdroid) or [Barcode Scanner (by ZXing Team)](https://play.google.com/store/apps/details?id=com.google.zxing.client.android) to share URL by QR code. If nothing of both installed offer to install lWS QR plugin
* "Send" to share working server URL to another device by Bluetooth, Android Beam, E-Mail and other way available on your device.
* "Browser" button for check server operation in your local browser
* "QR code" to call [[net.basov.lws.qr.fdroid]] or [[com.google.zxing.client.android]] to share URL by QR code. If no app is installed it offers to install lWS QR plugin
* "Send" to share the working server URL to another device via Bluetooth, Android Beam, E-Mail and any 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
The application has no permanent logging. This was treated this as redundant
functionality. The app tries to have the notification up to date. The on screen
log works only when the application is visible. Log screen may be cleared after
returning from background.
.