From 00ec9ded891d50b40c75c6e6d9845935d99c1bf5 Mon Sep 17 00:00:00 2001 From: Pekka Helenius Date: Thu, 2 Jul 2020 09:56:54 +0300 Subject: [PATCH] Re-factor README --- README.md | 61 +++++++++++++++---------------------------------------- 1 file changed, 16 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index fbba447..7b9f166 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ This repository contains recommended Anbox configuration to run the program as s Many users misconfigure Anbox to run in privileged mode which permits real root access for Android system processes to a Linux system. Configuration in this repository contains proper settings to run Anbox in _unprivileged mode_, thus better protecting your Linux system from possibly malicious Android processes. -Additionally, this repository provides feature-patched Android OS image file for Anbox, and several other improvements. +Additionally, this repository provides feature-patched Android OS image file patches for Anbox, and several other improvements. **See and get available Android images on [https://fjordtek.com/public/applications/anbox/images/](https://fjordtek.com/public/applications/anbox/images/).** `PKGBUILD` file is Arch Linux specific file. Otherwise, you can use rest of the files on any Linux distribution. @@ -67,37 +67,16 @@ Place into `/usr/local/bin/` folder and set as executable (`chmod +x #### Patch files -- [patch_audio01_timing.patch](anbox_files/patch_audio01_timing.patch) & [patch_audio02_pass-messenger.patch](anbox_files/patch_audio02_pass-messenger.patch) - - - Details: [GitHub: Anbox PR #1034 - Implement audio timing](https://github.com/anbox/anbox/pull/1034) - -- [patch_bytesize-to-bytesizelong.patch](anbox_files/patch_bytesize-to-bytesizelong.patch) - - - Details: [GitHub: Anbox PR #1480 - rpc: use ByteSizeLong from protobuf](https://github.com/anbox/anbox/pull/1480) - -- [patch_cm-helpmenu-unhidden.patch](anbox_files/patch_cm-helpmenu-unhidden.patch) - - - Details: personal patch to unhide `container-manager` options in Anbox executable help menu - -- [patch_cm-privileged-warn.patch](anbox_files/patch_cm-privileged-warn.patch) - - - Details: personal patch to add `not recommended` note into `--privileged` parameter description - -- [patch_python3.patch](anbox_files/patch_python3.patch) - - - Details: [GitHub: Anbox issue - Python 2 is EOL: comment by karuboniru](https://github.com/anbox/anbox/issues/1478#issuecomment-638055086) - -- [patch_remove-unknown-opt.patch](anbox_files/patch_remove-unknown-opt.patch) - - - Details: personal patch to remove unknown compilation time G++ option - -- [patch_window-restored.patch](anbox_files/patch_window-restored.patch) - - - Details: Some Android applications such as [NewPipe](https://github.com/TeamNewPipe/NewPipe) require `SDL_WINDOWEVENT_RESTORED` handling so that application window contents are correctly rendered after minimize/maximize operations. - -- [patch_window-icons.patch](anbox_files/patch_window-icons.patch) - - - Details: Set SDL window icon property for each application window by using application specific PNG icons. Adds value for `_NET_WM_ICON` property in X11 environment (`xprop` command). +| Patch file | Description | +|------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| [patch_audio01_timing.patch](anbox_files/patch_audio01_timing.patch), [patch_audio02_pass-messenger.patch](anbox_files/patch_audio02_pass-messenger.patch) | [GitHub: Anbox PR #1034 - Implement audio timing](https://github.com/anbox/anbox/pull/1034) | +| [patch_bytesize-to-bytesizelong.patch](anbox_files/patch_bytesize-to-bytesizelong.patch) | [GitHub: Anbox PR #1480 - rpc: use ByteSizeLong from protobuf](https://github.com/anbox/anbox/pull/1480) | +| [patch_cm-helpmenu-unhidden.patch](anbox_files/patch_cm-helpmenu-unhidden.patch) | Unhide `container-manager` options in Anbox executable help menu | +| [patch_cm-privileged-warn.patch](anbox_files/patch_cm-privileged-warn.patch) | Add `not recommended` note into `--privileged` parameter description | +| [patch_python3.patch](anbox_files/patch_python3.patch) | [GitHub: Anbox issue - Python 2 is EOL: comment by karuboniru](https://github.com/anbox/anbox/issues/1478#issuecomment-638055086) | +| [patch_remove-unknown-opt.patch](anbox_files/patch_remove-unknown-opt.patch) | Remove unknown compilation time G++ option | +| [patch_window-restored.patch](anbox_files/patch_window-restored.patch) | Some Android applications such as [NewPipe](https://github.com/TeamNewPipe/NewPipe) require `SDL_WINDOWEVENT_RESTORED` handling so that application window contents are correctly rendered after minimize/maximize operations. | +| [patch_window-icons.patch](anbox_files/patch_window-icons.patch) | Set SDL window icon property for each application window by using application specific PNG icons. Adds value for `_NET_WM_ICON` property in X11 environment (`xprop` command). | ## Android OS files @@ -111,16 +90,8 @@ On Arch Linux, you can use [anbox-image AUR package](https://aur.archlinux.org/p Provided patch files are applied to the patched Android OS image file `android_7.1.1_r13_patched.img` ([direct link](https://fjordtek.com/public/applications/anbox/images/android_7.1.1_r13_patched.img)). The patch files are as follows: -- [patch_audio01_timing.patch](androidOS_files/patch_audio01_timing.patch) & [patch_audio02_pass-messenger.patch](androidOS_files/patch_audio02_pass-messenger.patch) - - - Details: as above - -- [patch_gallery2_no-activity-checks.patch](androidOS_files/patch_gallery2_no-activity-checks.patch) - - - Details: remove video & audio pause functionality from default Android OS system application `com.android.gallery3d` as the pause functionality does not fit into Linux desktop environment when running multiple Android applications simultaneosly. - -- [patch_initcgroups.patch](androidOS_files/patch_initcgroups.patch) - - - Remove unnecessary cgroups and related mount points from containerized Android OS system. Remove cpusets. - - - Both options generate unnecessary Linux main system kernel `dmesg` output and both options fail. +| Patch file | Description | +|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| [patch_audio01_timing.patch](androidOS_files/patch_audio01_timing.patch), [patch_audio02_pass-messenger.patch](androidOS_files/patch_audio02_pass-messenger.patch) | As above | +| [patch_gallery2_no-activity-checks.patch](androidOS_files/patch_gallery2_no-activity-checks.patch) | Remove video & audio pause functionality from default Android OS system application `com.android.gallery3d` as the pause functionality does not fit into Linux desktop environment when running multiple Android applications simultaneously. | +| [patch_initcgroups.patch](androidOS_files/patch_initcgroups.patch) | Remove unnecessary cgroups and related mount points from containerized Android OS system. Remove cpusets. Both options generate unnecessary Linux main system kernel `dmesg` output and both options fail. |