Update READMEs

This commit is contained in:
octospacc 2024-01-18 18:14:12 +01:00
parent c424423349
commit b812ad9be8
2 changed files with 44 additions and 14 deletions

View File

@ -1,10 +1,17 @@
# 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.
* 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
* After [installing AndroidFloatingWebView.apk](dist/AndroidFloatingWebView.apk), start the app a first time, grant overlay permissions, then close it.
* 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.
* 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").
1. After [installing AndroidFloatingWebView.apk](dist/AndroidFloatingWebView.apk),
start the app a first time, grant overlay permissions, then close it.
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.

View File

@ -1,13 +1,18 @@
# 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.
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.
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.
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.
## Index + Credits
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>:
* [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:
* [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
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/Snippets> - Small uncategorized programs I made, not necessarily fun, made instead for practical uses.
* <https://gitlab.com/octospacc/Configs>
— 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?)