Update READMEs
This commit is contained in:
parent
c424423349
commit
b812ad9be8
|
@ -1,10 +1,17 @@
|
||||||
# Android Floating WebView
|
# Android Floating WebView
|
||||||
|
|
||||||
A simple app, that I quickly arranged, for an effective way of having a WebView as a constant visual overlay on my screen, but that still allows touches to be directed to any other app running below it.
|
A simple app, that I quickly arranged,
|
||||||
|
for an effective way of having a WebView as a constant visual overlay on my screen,
|
||||||
|
but that still allows touches to be directed to any other app running below it.
|
||||||
|
|
||||||
The UX isn't the best and functionality is not optimized, since I only made this quick and dirty for just my specific use; that is, putting animations on the screen of my old smartphone that I'm upcycling into a PC touchpad, thanks to KDE connect (which I couldn't manage to modify for putting a WebView). I will probably not improve it. See <https://octospacc.altervista.org/2024/01/17/overlay-webview-su-android-a-scopi-ricreativi/>.
|
The UX isn't the best and functionality is not optimized,
|
||||||
|
since I only made this quick and dirty for just my specific use; that is,
|
||||||
|
putting animations on the screen of my old smartphone that I'm upcycling into a PC touchpad,
|
||||||
|
thanks to KDE connect (which I couldn't manage to modify for putting a WebView).
|
||||||
|
I will probably not improve it. See <https://octospacc.altervista.org/2024/01/17/overlay-webview-su-android-a-scopi-ricreativi/>.
|
||||||
|
|
||||||
Most of the code is taken from <https://github.com/mjlong123123/TestFloaWindow/>, so proper credits go to them, I just did the following things:
|
Most of the code is taken from <https://github.com/mjlong123123/TestFloaWindow/>,
|
||||||
|
so proper credits go to them, I just did the following things:
|
||||||
|
|
||||||
* Made the app overlay contain just a WebView, loading a file from private external storage.
|
* Made the app overlay contain just a WebView, loading a file from private external storage.
|
||||||
* Removed test code and disabled complex window overlay code.
|
* Removed test code and disabled complex window overlay code.
|
||||||
|
@ -13,10 +20,23 @@ Most of the code is taken from <https://github.com/mjlong123123/TestFloaWindow/>
|
||||||
|
|
||||||
## Download and Usage
|
## Download and Usage
|
||||||
|
|
||||||
* After [installing AndroidFloatingWebView.apk](dist/AndroidFloatingWebView.apk), start the app a first time, grant overlay permissions, then close it.
|
1. After [installing AndroidFloatingWebView.apk](dist/AndroidFloatingWebView.apk),
|
||||||
* Now, prepare an `index.html` file in the application's private external storage directory (which also appears on the screen if you reopen the app before this file is present); it usually (but not always) is `/sdcard/Android/org.eu.octt.androidfloatingwebview/files/`, and, optionally, any other files that you want to require from your HTML.
|
start the app a first time, grant overlay permissions, then close it.
|
||||||
* Now, restarting the app will make a WebView appear on your screen, totally functioning except for the fact that you can't touch it; all of your touches will go to whatever app was running before.
|
|
||||||
* To close this visual overlay, open your notification drawer and click on the service notification ("AndroidFloatingWebView: Click to terminate service").
|
|
||||||
|
|
||||||
You can put anything you want in the `index.html`, as long as your system's default WebView implementation can interpret it. You can either put an HTML5 application that will work offline, a document, or put code that redirects the browser to any website. Just keep in mind that you can only see, not touch.
|
2. Now, prepare an `index.html` file in the application's private external storage directory
|
||||||
|
(which also appears on the screen if you reopen the app before this file is present);
|
||||||
|
it usually (but not always) is `/sdcard/Android/org.eu.octt.androidfloatingwebview/files/`.
|
||||||
|
Optionally, add any other files that you want to require from your HTML.
|
||||||
|
|
||||||
|
3. Now, restarting the app will make a WebView appear on your screen,
|
||||||
|
totally functioning except for the fact that you can't touch it;
|
||||||
|
all of your touches will go to whatever app was running before.
|
||||||
|
|
||||||
|
4. To close this visual overlay, open your notification drawer and
|
||||||
|
click on the service notification ("AndroidFloatingWebView: Click to terminate service").
|
||||||
|
|
||||||
|
You can put anything you want in the `index.html`,
|
||||||
|
as long as your system's default WebView implementation can interpret it.
|
||||||
|
You can either put an HTML5 application that will work offline, a document,
|
||||||
|
or put code that redirects the browser to any website.
|
||||||
|
Just keep in mind that you can only see, not touch.
|
||||||
|
|
22
README.md
22
README.md
|
@ -1,13 +1,18 @@
|
||||||
# OcttBitsOfFun
|
# OcttBitsOfFun
|
||||||
|
|
||||||
This repository serves as a miscellaneous depot and workshop of "fun bits", artistical or technical works that would be too messy for me to keep in their own dedicated repo.
|
This repository serves as a miscellaneous depot and workshop of "fun bits",
|
||||||
In here I simply archive constant updates of these works. Some have kind of a defined purpose to exist, while others might be simple excercises to waste time in a productive way or to study and learn new things.
|
artistical or technical works that would be too messy for me to keep in their own dedicated repo.
|
||||||
|
In here I simply archive constant updates of these works.
|
||||||
|
Some have kind of a defined purpose to exist,
|
||||||
|
while others might be simple excercises to waste time in a productive way or to study and learn new things.
|
||||||
Feel free to look around and take inspiration, if you will.
|
Feel free to look around and take inspiration, if you will.
|
||||||
|
|
||||||
## Index + Credits
|
## Index + Credits
|
||||||
|
|
||||||
Index of contents in this repo, might or might not always be complete...
|
Index of contents in this repo, might or might not always be complete...
|
||||||
I will also try to credit everyone I can for all the contents listed, when my work is in great part based on someone else's, unless I've already done so in a secondary, dedicated README.
|
I will also try to credit everyone I can for all the contents listed,
|
||||||
|
when my work is in great part based on someone else's,
|
||||||
|
unless I've already done so in a secondary, dedicated README.
|
||||||
|
|
||||||
* Thanks to <https://github.com/PeterLemon/PSX/tree/master/Cube>:
|
* Thanks to <https://github.com/PeterLemon/PSX/tree/master/Cube>:
|
||||||
* [BouncyCubePs1.asm](BouncyCubePs1.asm)
|
* [BouncyCubePs1.asm](BouncyCubePs1.asm)
|
||||||
|
@ -15,12 +20,17 @@ I will also try to credit everyone I can for all the contents listed, when my wo
|
||||||
* Thanks to <https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_world> for the original code structure; all assembly code by me:
|
* Thanks to <https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_world> for the original code structure; all assembly code by me:
|
||||||
* [HelloWorld-PS1-PsyQ.asm](HelloWorld-PS1-PsyQ.asm)
|
* [HelloWorld-PS1-PsyQ.asm](HelloWorld-PS1-PsyQ.asm)
|
||||||
|
|
||||||
* [Android Floating WebView](AndroidFloatingWebView) — Simple app arranged for an effective way of having a WebView as a constant untouchable overlay on my screen
|
* [Android Floating WebView](AndroidFloatingWebView)
|
||||||
|
— Simple app arranged for an effective way of having a WebView as a constant untouchable overlay on my screen
|
||||||
|
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
Also see other places on the Internet that exist in a way similar to this repo, let's share this common way of doing things...
|
Also see other places on the Internet that exist in a way similar to this repo, let's share this common way of doing things...
|
||||||
|
|
||||||
* <https://gitlab.com/octospacc/Configs> - Collection of config files, and importantly multi-use scripts, that I use on some systems.
|
* <https://gitlab.com/octospacc/Configs>
|
||||||
* <https://gitlab.com/octospacc/Snippets> - Small uncategorized programs I made, not necessarily fun, made instead for practical uses.
|
— Collection of config files, and importantly multi-use scripts, that I use on some systems.
|
||||||
|
|
||||||
|
* <https://gitlab.com/octospacc/Snippets>
|
||||||
|
— Small uncategorized programs I made, not necessarily fun, made instead for practical uses.
|
||||||
|
|
||||||
* (yours here?)
|
* (yours here?)
|
||||||
|
|
Loading…
Reference in New Issue