Fabien Benetou's PIM | Tools / Android

Via generic usage

cross-building
- ~ $ ./hello_arm64 in termux print Hello cross-compilation world!
- tetris:/tmp $ ./hello_arm in adb shell print Hello cross-compilation world!
  - also works via Termux, much easier with just scp then chmod in ~
- done via ~/Prototypes/dockcross$
  - used https://github.com/dockcross/dockcross
    - requires -static
      - details https://stackoverflow.com/questions/79105686/cannot-execute-required-file-not-found-when-trying-to-execute-binary
  - needs execution permission which is not on SD card by default
    - details https://android.stackexchange.com/questions/45554/running-own-executable-on-android-shell
  - images are large, >3Go per architecture
  - pick the right architecture
    - ARMv7 : dockcross/android-arm
    - ARMv8 : dockcross/android-arm64
- Android images are NDK only, not SDK
  - https://github.com/dockcross/dockcross/issues/914
own F-Droid repository test
- documented as https://mastodon.pirateparty.be/@utopiah/115184468345195839
- interesting for https://git.benetou.fr/utopiah/offline-octopus
shortcuts
- no Firefox shortcuts, no Tridactyl availability (cf issue commented on)
  - no new tab, switching between tabs, hinting, etc
- System + B to open browser
- System + delete to go back
- Alt + Tab to switch between open apps
- unable to set dedicated shortcut for Termux
  - using System then Ter... then Enter
- Ctrl + C/V/X working as expected
possiblity to disable on-screen keyboard when physical keyboard connected

Murena CMF Phone 1

From https://murena.com/shop/smartphones/brand-new/murena-cmf-phone-1/ with hardware https://cmf.tech/en-be/pages/phone-1 and software https://doc.e.foundation pre-installed.

testing custom Firefox Web Extension web-ext run -t firefox-android --android-device=0010134BN000945 --firefox-apk org.mozilla.firefox
- via https://extensionworkshop.com/documentation/develop/developing-extensions-for-firefox-for-android/#install-and-run-your-extension-in-firefox-for-android
- goal of sharing URL to a specific page, e.g. appending to current URL to WithoutNotesAugust2025
  - see also
    - Android ShareSheet
    - Web Share API https://developer.mozilla.org/en-US/docs/Web/API/Navigator/share
used App Lounge to have App Store + F-Droid as one interface, no account required
- anonymous access
microG services https://microg.org
installed Termux via F-Droid
- updated then installed sshd
- added Termux:Boot to have sshd on boot
- enabled `termux-setup-storage` in order to be able to add content visible by other apps
  - e.g. `scp` music then play via VLC
- connect via ssh key, passwordless
  - allows `sshfs` mounting
use developer mode then USB debugging to allow `scrcpy` then be able to type on phone
might be compatible with https://esim.me but untested

Nebulas Mars II Pro

adb shell reboot -p to shutdown, -p stands for poweroff
adb shell am start -n org.bromite.bromite/com.google.android.apps.chrome.Main -a android.intent.action.VIEW -d 'https://fabien.benetou.fr'
- open a Web page remotely
adb connect videoprojector:5555 ; adb push $(mr mkv) /sdcard/Download/;adb shell am start -n org.videolan.vlc/org.videolan.vlc.gui.video.VideoPlayerActivity -d file:///sdcard/Download/file.mkv
- connect, copy file then watch it with VLC
adb connect IP works without any developer mode activated
- via https://old.reddit.com/r/nebulaprojectors/comments/ip5jkm/adb_access_on_the_nebula_capsule_max/gc2bi6k/
in shell pm list packages
booting straight to VLC
- using https://f-droid.org/en/packages/news.androidtv.launchonboot/
to consider
- alternative launcher https://gitlab.com/flauncher/flauncher
- apps https://xdaforums.com/t/top-40-android-tv-open-source-apps.4695827/

Lynx

removing lense distortion e.g adb shell setprop persist.lynx.openxr.distortion 0
- https://portal.lynx-r.com/documentation/view/sharing-your-screen
rooted using https://lynx.miraheze.org/wiki/Rooting_Process
- saved /mnt/vendor/persist/qvr as qvr.tar in ~/Prototypes
- why even root in the first place?
  - https://twitter.com/utopiah/status/1494308471306698756
building Wolvic
- building Gecko failed on current Ubuntu
  - went "back" to 22.04 via container
  - details https://github.com/Igalia/wolvic/issues/1270
- motivated by lack of AFrame support https://github.com/Igalia/wolvic/issues/1103 and no release available
- result https://fabien.benetou.fr/pub/home/Wolvic-lynx-arm64-gecko-generic-release.apk
  - also available on https://apps.lynx-community.workers.dev/
  - seems WebXR is supported https://immersive-web.github.io/webxr-samples/ but not VR or AR mode found
- note that signing is required, can use jarsigner or do so via Android Studio
  - might require to use keytool prior
  - if done through Studio then zipalign does not seemed to be required
- Android Studio isn't that large anymore but requires few restart to work properly
- the project also needs to have its depencies installed and that might requires few retries
  - https://github.com/Igalia/wolvic#setup-instructions
- Wolvic comes installed as a system app so the package name will conflict
  - can refactor as per https://www.geeksforgeeks.org/how-to-rename-package-name-in-android-studio/
  - that might be problematic with Gecko and the activity
  - failed via https://apktool.org
- see also https://github.com/Igalia/wolvic/issues/1279
unable to access cameras via scrcpy, either local via scrcpy-server or scrcpy as client/server
Android settings is available by pulling the top of the screen via scrcpy
for settings adb shell am start -a android.settings.SETTINGS then scrcpy to be able to interact
- unsure how to do that within the Lynx UI, thanks for the pointers
go back home adb shell am start -a android.intent.action.MAIN -c android.intent.category.HOME
to access adb through termux :
- on desktop adb tcpip 5555 with Lynx plugged in
- within termux adb connect localhost:5555
termux-boot works but the IP changes during every boot
- consequently termux must be started once, then sshd then possible to go back to home via adb
- can use adb shell am start -n com.termux/.HomeActivity
consider https://github.com/Genymobile/scrcpy/blob/master/doc/develop.md#standalone-server

Go

rooted, cf https://twitter.com/utopiah/status/1559831610060685313
official unlocking instructions https://developer.oculus.com/blog/unlocking-oculus-go/

Quest

stop browser adb shell am force-stop com.oculus.vrshell
- faster than having to reboot when entered a weird state
boot2webXR
- achieved on rooted Quest3 via
  - EventHorizon to enable adb on boot
  - Termux and Termux:boot namely in .termux/boot/start-webxr
  - sleep 20
  - adb connect localhost # assumes rooting with adb enabled on boot (via eventhorizon)
  - adb shell am start -n com.oculus.vrshell/.MainActivity -d apk://com.oculus.browser -e uri https://companion.benetou.fr/index.html?username=q4_autoenter_vr_quest
- inpisred by https://wiki.mozilla.org/B2G
Meta Browser
- chrome://flags disable "webxr user activation requirement"
  - let enter WebXR with needing to interact with the page
- video https://video.benetou.fr/w/4qPJwFp9xMKzAaPqrGKdZQ
- autovropenquest https://companion.benetou.fr/index.html?username=q4_pull_to_ring
  - defining in e.g. ~/.bashrc the function autovropenquest(){ adbshell am start -n com.oculus.vrshell/.MainActivity -d apk://com.oculus.browser -e uri "$1\&autoenter_vr_quest=true" }
  - assumes that the page does parse and use an autoenter_vr_quest query parameter
  - note that \& must be escaped
  - optionally use -t 4 to specify adb device if more than 1 is connected
root on boot
- https://mastodon.pirateparty.be/@utopiah/115243846726957767
- via https://github.com/veygax/eventhorizon
scrcpy on Quest3
- specify display --display-id=0
  - related issue https://github.com/Genymobile/scrcpy/issues/5913#issuecomment-2774898633
  - getting numbered pannels adb shell dumpsys display | grep "mDisplayId=: " | sort | uniq
rooting of Quest 3
- exploit with installed and documentation https://github.com/FreeXR/eureka_panther-adreno-gpu-exploit-1
- tried on v78, auto update stopped https://mastodon.pirateparty.be/@utopiah/115060505025743220k
- consider https://github.com/termux/termux-packages/tree/master/root-packages
  - `avahi` for mDNS/DNS-SD e.g https://git.benetou.fr/utopiah/offline-octopus/issues/28
  - `containerd`/`docker`
turn sensor off/on for recording
- off shell am broadcast -a com.oculus.vrpowermanager.prox_close
- on shell am broadcast -a com.oculus.vrpowermanager.automation_disable
- reset on reboot
start the browser with a specific URL adb shell am start -n com.oculus.vrshell/.MainActivity -d apk://com.oculus.browser -e uri ""

In order to be able to use Termux with addons, e.g https://wiki.termux.com/wiki/Termux:Boot , use the F-droid build.

scrcpy

Used for mirroring on VR and AR devices but also eInk, e.g PineNote with stock OS.

stream Quest/Quest 2 on low-end device, e.g RPi4 scrcpy -n -m 1024 -b 10M --max-fps=24 -f
- unfortunately --crop=1832:1920:0:0 fails, bug in the HMD

Flutter

Example to get WebView https://pub.dev/packages/webview_flutter on a device :

cd ~/Prototypes/flutter-plugins/packages/webview_flutter/webview_flutter_android
docker run --rm -it -v "$PWD":/build --workdir /build/example cirrusci/flutter:stable flutter build apk
# if built and installed before
# docker run --rm -it -v "$PWD":/build --workdir /build/example cirrusci/flutter:stable flutter clean
# adb uninstall io.flutter.plugins.webviewflutterandroidexample
adb install example/build/app/outputs/flutter-apk/app-release.apk
adb shell monkey -p 'io.flutter.plugins.webviewflutterandroidexample' -v 500
# to check and control from desktop
# scrcpy

Used on AugmentedReality for the Google Glass Enterprise 2 and VuzixBlade.

Projects

random moment polling (QS)
elastic behavior (QS)
InnovativITLab:WheelShare/
- consider C2D instead of polling
automated creativity remote control
add to public and private PIM
- http://android-developers.blogspot.be/2012/02/share-with-intents.html

Discovering Ionic/Cordova

SRE steps (cf Principle)
1. created ~/SandboxedReusableExplorations/ionic/
2. installed ionic with dependencies via https://github.com/nraboy/ubuntu-ionic-installer
3. started to follow http://ionicframework.com/docs/guide/installation.html
  1. created ionic.io account after started the build
  2. installed Ionic View on Android phone after started the build
  3. made an Android image via android avd
    1. terribly slow boot (1min black screen, several minutes on the Android splashscreen)
4. found https://www.reddit.com/r/ionic/ while look for information on the slow boot time
5. started in parallel (since the emulator was taking too long) Quick start from http://docs.ionic.io and trying https://apps.ionic.io in the WebView app
  1. without success, seemed limited to psuh/deploy/analytics...
6. focusing instead on testing on a phone proper
  1. sending the apk from the build to the phone, worked
7. using ionic serve to test in the browser
  1. nicely handles live reloading

From personal use

find architecture to install apk adb shell getprop | grep product.cpu.abi
apps on Google Play are account based
- not device based
- they can not be migrated to other account, just re-installed on another device
to check the content of files written by an app via adb shell
- cd /data/data/your.app.reversed.domain/files
  - cat yourfile.txt
to access the SDcard simply enable via the nofication menu
- then mount/.../umount
using connectbot to access ssh
QRcode
general key resource
- http://developer.android.com/guide/
  - installing
    - Ubuntu https://help.ubuntu.com/community/AndroidSDK
    - Debian http://workaround.org/developing-android-applications-on-debian
  - Android Debug Bridge (adb)
  - http://developer.android.com/guide/topics/usb/adk.html for hardware extensions
- #android and #android-dev on freenode IRC network

vogella.com Android tutorials

http://www.vogella.com/articles/Android/article.html
- key clarifications on the vocabulary
- Activity, View, Intent, ...
http://www.vogella.com/articles/AndroidNotifications/article.html
- works well but only for instantaneous notifications

blundell's Notification-for-a-user-chosen-time

http://blog.blundell-apps.com/notification-for-a-user-chosen-time/
- also required to do an android update project --target 1 --path . to work with ant
- warning for reboot though, cf http://stackoverflow.com/questions/8461208/android-notification-after-reboot
relying on http://blog.blundell-apps.com/basic-date-picker/

Hello World by CLI

Requires JDK, Ant, AndroidSDK

http://www.syscs.com/node/504
- explains how to
  - create an emulator image with android avd ...
  - use a template with create project
  - compile with ant debug
  - send the application to it for testing with avd -s DEVICE install PATH/TO/APP.apk
  - use adb to connect to a device (virtual or not) to run commands

Elastic Behavior

blending PIM and QS via QRcodes

consider also for gamification

MVP

ask as a notification a value between 1 and 10 stored in values.csv file in your memory card at 5 random moment of the day between 10AM and 10PM
- Path:/pub/ElasticBehavior.apk
  - might need specific MIME type
  - code repo https://github.com/Utopiah/ElasticBehavior

Test

generate QRcode via http://qrcode.kaywa.com with your server URL
- e.g. http://fabien.benetou.fr/RealLife/YourAction
- eg calories
  - daily sum done via dailycalories
- consider instead Encode intent (iif it is possible to save or send the generated picture)
take the QRcode after doing your action
- open the targer URL
display result
- grep " /RealLife" /webroot/var/log/lighttpd/access.log | awk '{print $4 " " $7}'

Generalization

X sampling per period (e.g. day, week, etc)
- frequency (equidistant) or random (e.g. for flow) or standard deviations (hence the "elastic part)
- value from numbers (e.g. floats from 1.0 to 10.0) or discrete list (e.g. picture of items) or QRcodes (physically located, motivated by SC22#LesObjectsDansLEspaceLaPlanificationDansLAction and more generally Wikipedia:Situated cognition)

Steps

enter server URL
enter habit to track
pick type of expected input values
1. optionally generate QRcode to put in the target locations
2. optionally activate conditional reminders (mobile notifications)
visit server URL of results

Technically

request Scan intent to ZXing library to consider own server as "trusted" URL
- cf http://stackoverflow.com/questions/2050263/using-zxing-to-create-an-android-barcode-scanning-app?
- hence 1-click and doing HTTP GET of the returned value (and some tests) in the background rather than opening the browser
  - http://stackoverflow.com/questions/5870611/curl-in-android
- e.g. http://192.168 prefix
generate set of home cards or stickers based on that trusted URL
- http://code.google.com/p/zxing/source/browse/trunk#trunk/core/src/com/google/zxing/qrcode/encoder

From YetAnotherTutorial

notifications
- http://developer.android.com/reference/android/app/Notification.html
- http://developer.android.com/guide/topics/ui/notifiers/notifications.html
location
- http://marakana.com/s/tutorial_android_location_service_example,311/
UI
- http://www.androiduipatterns.com
geo-notification
- https://play.google.com/store/apps/details?id=com.rtsw.georeminderslite
sleep tracking
- https://sites.google.com/site/sleepasandroid/
accelerometer
- sensors in general
  - http://developer.android.com/reference/android/hardware/SensorManager.html
- http://stackoverflow.com/questions/5180187/how-do-i-use-the-android-accelerometer
voice actions
- http://www.google.com/mobile/voice-actions/
  - program own command?
    - e.g. PIM [query]
- consider alternative iris
  - disappointing

Social gatherings

Google I/O Extended Brussels on Google+
Brussels GTUG

To explore

links to websites with content to discover
Overlay
Programming
ObjectsExoBrain
Cookbook:DetectMobile
urban data
- e.g. http://data.be
programming itself
- Java http://mobile.tutsplus.com/tutorials/android/java-tutorial/
- Scala http://robots.thoughtbot.com/post/5836463058/scala-a-better-java-for-android
  - http://code.google.com/p/scalaforandroid/
  - http://www.assembla.com/wiki/show/scala-ide/Developing_for_Android
- Ruby http://ruboto.org/
- Scripting in general http://code.google.com/p/android-scripting/
- MIT AppInventor http://www.appinventor.mit.edu with http://www.appinventorblocks.com
  - online simple IDE, very easy to install the packaged app via QRcode
    - need to allow installation from non-trusted sources
http://code.google.com/p/android-notifier/
http://web.airdroid.com/
Cloud 2 Device Messaging https://developers.google.com/android/c2dm/
http://f-droid.org
computer vision
- http://www.stanford.edu/class/ee368/Android/Tutorial-2-OpenCV-for-Android-Setup-Windows.pdf
- http://code.opencv.org/projects/opencv/wiki/OpenCV4Android
- potentially useful for Google Glass
http://www.malgenomeproject.org

Note

My notes on Tools gather what I know or want to know. Consequently they are not and will never be complete references. For this, official manuals and online communities provide much better answers.

Android {Tools}