12 | {{ content }}
13 |
14 | {{ page.title | escape }}
8 |
11 | {{ content }}
12 |
13 |
14 | 21 | * Encodes effects, foreground and background colors into a 64 bit long, which are stored for each cell in a terminal 22 | * row in {@link TerminalRow#mStyle}. 23 | *
24 | *25 | * The bit layout is: 26 | *
27 | * - 16 flags (11 currently used). 28 | * - 24 for foreground color (only 9 first bits if a color index). 29 | * - 24 for background color (only 9 first bits if a color index). 30 | */ 31 | public final class TextStyle { 32 | 33 | public final static int CHARACTER_ATTRIBUTE_BOLD = 1; 34 | public final static int CHARACTER_ATTRIBUTE_ITALIC = 1 << 1; 35 | public final static int CHARACTER_ATTRIBUTE_UNDERLINE = 1 << 2; 36 | public final static int CHARACTER_ATTRIBUTE_BLINK = 1 << 3; 37 | public final static int CHARACTER_ATTRIBUTE_INVERSE = 1 << 4; 38 | public final static int CHARACTER_ATTRIBUTE_INVISIBLE = 1 << 5; 39 | public final static int CHARACTER_ATTRIBUTE_STRIKETHROUGH = 1 << 6; 40 | /** 41 | * The selective erase control functions (DECSED and DECSEL) can only erase characters defined as erasable. 42 | *43 | * This bit is set if DECSCA (Select Character Protection Attribute) has been used to define the characters that 44 | * come after it as erasable from the screen. 45 | *
46 | */ 47 | public final static int CHARACTER_ATTRIBUTE_PROTECTED = 1 << 7; 48 | /** Dim colors. Also known as faint or half intensity. */ 49 | public final static int CHARACTER_ATTRIBUTE_DIM = 1 << 8; 50 | /** If true (24-bit) color is used for the cell for foreground. */ 51 | private final static int CHARACTER_ATTRIBUTE_TRUECOLOR_FOREGROUND = 1 << 9; 52 | /** If true (24-bit) color is used for the cell for foreground. */ 53 | private final static int CHARACTER_ATTRIBUTE_TRUECOLOR_BACKGROUND= 1 << 10; 54 | 55 | public final static int COLOR_INDEX_FOREGROUND = 256; 56 | public final static int COLOR_INDEX_BACKGROUND = 257; 57 | public final static int COLOR_INDEX_CURSOR = 258; 58 | 59 | /** The 256 standard color entries and the three special (foreground, background and cursor) ones. */ 60 | public final static int NUM_INDEXED_COLORS = 259; 61 | 62 | /** Normal foreground and background colors and no effects. */ 63 | final static long NORMAL = encode(COLOR_INDEX_FOREGROUND, COLOR_INDEX_BACKGROUND, 0); 64 | 65 | static long encode(int foreColor, int backColor, int effect) { 66 | long result = effect & 0b111111111; 67 | if ((0xff000000 & foreColor) == 0xff000000) { 68 | // 24-bit color. 69 | result |= CHARACTER_ATTRIBUTE_TRUECOLOR_FOREGROUND | ((foreColor & 0x00ffffffL) << 40L); 70 | } else { 71 | // Indexed color. 72 | result |= (foreColor & 0b111111111L) << 40; 73 | } 74 | if ((0xff000000 & backColor) == 0xff000000) { 75 | // 24-bit color. 76 | result |= CHARACTER_ATTRIBUTE_TRUECOLOR_BACKGROUND | ((backColor & 0x00ffffffL) << 16L); 77 | } else { 78 | // Indexed color. 79 | result |= (backColor & 0b111111111L) << 16L; 80 | } 81 | 82 | return result; 83 | } 84 | 85 | public static int decodeForeColor(long style) { 86 | if ((style & CHARACTER_ATTRIBUTE_TRUECOLOR_FOREGROUND) == 0) { 87 | return (int) ((style >>> 40) & 0b111111111L); 88 | } else { 89 | return 0xff000000 | (int) ((style >>> 40) & 0x00ffffffL); 90 | } 91 | 92 | } 93 | 94 | public static int decodeBackColor(long style) { 95 | if ((style & CHARACTER_ATTRIBUTE_TRUECOLOR_BACKGROUND) == 0) { 96 | return (int) ((style >>> 16) & 0b111111111L); 97 | } else { 98 | return 0xff000000 | (int) ((style >>> 16) & 0x00ffffffL); 99 | } 100 | } 101 | 102 | public static int decodeEffect(long style) { 103 | return (int) (style & 0b11111111111); 104 | } 105 | 106 | } 107 | -------------------------------------------------------------------------------- /app/src/main/java/sylirre/vmconsole/termview/CursorController.java: -------------------------------------------------------------------------------- 1 | /* 2 | ************************************************************************* 3 | This program is free software: you can redistribute it and/or modify 4 | it under the terms of the GNU General Public License as published by 5 | the Free Software Foundation, either version 3 of the License, or 6 | (at your option) any later version. 7 | 8 | This program is distributed in the hope that it will be useful, 9 | but WITHOUT ANY WARRANTY; without even the implied warranty of 10 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 | GNU General Public License for more details. 12 | 13 | You should have received a copy of the GNU General Public License 14 | along with this program. If not, see21 | * "CSI ? Pm h", DEC Private Mode Set (DECSET) 22 | *23 | * 24 | * and 25 | * 26 | *
27 | * "CSI ? Pm l", DEC Private Mode Reset (DECRST) 28 | *29 | * 30 | * controls various aspects of the terminal 31 | */ 32 | public class DecSetTest extends TerminalTestCase { 33 | 34 | /** DECSET 25, DECTCEM, controls visibility of the cursor. */ 35 | public void testEnableDisableCursor() { 36 | withTerminalSized(3, 3); 37 | assertTrue("Initially the cursor should be enabled", mTerminal.isShowingCursor()); 38 | enterString("\033[?25l"); // Disable Cursor (DECTCEM). 39 | assertFalse(mTerminal.isShowingCursor()); 40 | enterString("\033[?25h"); // Enable Cursor (DECTCEM). 41 | assertTrue(mTerminal.isShowingCursor()); 42 | 43 | enterString("\033[?25l"); // Disable Cursor (DECTCEM), again. 44 | assertFalse(mTerminal.isShowingCursor()); 45 | mTerminal.reset(false); 46 | assertTrue("Resetting the terminal should enable the cursor", mTerminal.isShowingCursor()); 47 | 48 | enterString("\033[?25l"); 49 | assertFalse(mTerminal.isShowingCursor()); 50 | enterString("\033c"); // RIS resetting should enabled cursor. 51 | assertTrue(mTerminal.isShowingCursor()); 52 | } 53 | 54 | /** DECSET 2004, controls bracketed paste mode. */ 55 | public void testBracketedPasteMode() { 56 | withTerminalSized(3, 3); 57 | 58 | mTerminal.paste("a"); 59 | assertEquals("Pasting 'a' should output 'a' when bracketed paste mode is disabled", "a", mOutput.getOutputAndClear()); 60 | 61 | enterString("\033[?2004h"); // Enable bracketed paste mode. 62 | mTerminal.paste("a"); 63 | assertEquals("Pasting when in bracketed paste mode should be bracketed", "\033[200~a\033[201~", mOutput.getOutputAndClear()); 64 | 65 | enterString("\033[?2004l"); // Disable bracketed paste mode. 66 | mTerminal.paste("a"); 67 | assertEquals("Pasting 'a' should output 'a' when bracketed paste mode is disabled", "a", mOutput.getOutputAndClear()); 68 | 69 | enterString("\033[?2004h"); // Enable bracketed paste mode, again. 70 | mTerminal.paste("a"); 71 | assertEquals("Pasting when in bracketed paste mode again should be bracketed", "\033[200~a\033[201~", mOutput.getOutputAndClear()); 72 | 73 | mTerminal.paste("\033ab\033cd\033"); 74 | assertEquals("Pasting an escape character should not input it", "\033[200~abcd\033[201~", mOutput.getOutputAndClear()); 75 | mTerminal.paste("\u0081ab\u0081cd\u009F"); 76 | assertEquals("Pasting C1 control codes should not input it", "\033[200~abcd\033[201~", mOutput.getOutputAndClear()); 77 | 78 | mTerminal.reset(false); 79 | mTerminal.paste("a"); 80 | assertEquals("Terminal reset(false) should disable bracketed paste mode", "a", mOutput.getOutputAndClear()); 81 | } 82 | 83 | /** DECSET 7, DECAWM, controls wraparound mode. */ 84 | public void testWrapAroundMode() { 85 | // Default with wraparound: 86 | withTerminalSized(3, 3).enterString("abcd").assertLinesAre("abc", "d ", " "); 87 | // With wraparound disabled: 88 | withTerminalSized(3, 3).enterString("\033[?7labcd").assertLinesAre("abd", " ", " "); 89 | enterString("efg").assertLinesAre("abg", " ", " "); 90 | // Re-enabling wraparound: 91 | enterString("\033[?7hhij").assertLinesAre("abh", "ij ", " "); 92 | } 93 | 94 | } 95 | -------------------------------------------------------------------------------- /app/src/test/java/sylirre/vmconsole/termlib/DeviceControlStringTest.java: -------------------------------------------------------------------------------- 1 | /* 2 | ************************************************************************* 3 | This program is free software: you can redistribute it and/or modify 4 | it under the terms of the GNU General Public License as published by 5 | the Free Software Foundation, either version 3 of the License, or 6 | (at your option) any later version. 7 | 8 | This program is distributed in the hope that it will be useful, 9 | but WITHOUT ANY WARRANTY; without even the implied warranty of 10 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 | GNU General Public License for more details. 12 | 13 | You should have received a copy of the GNU General Public License 14 | along with this program. If not, see
2 |
4 |
--------------------------------------------------------------------------------
/docs/Gemfile:
--------------------------------------------------------------------------------
1 | source "https://rubygems.org"
2 |
3 | # Hello! This is where you manage which Jekyll version is used to run.
4 | # When you want to use a different version, change it below, save the
5 | # file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
6 | #
7 | # bundle exec jekyll serve
8 | #
9 |
10 | # This is the default theme for new Jekyll sites. You may change this to anything you like.
11 | gem "minima", git: "https://github.com/jekyll/minima", ref: "296bf6b872b8450529bee1e48d0ca9be200a4be5"
12 |
13 | # If you want to use GitHub Pages, remove the "gem "jekyll"" above and
14 | # uncomment the line below. To upgrade, run `bundle update github-pages`.
15 | gem "github-pages", group: :jekyll_plugins
16 |
17 | # If you have any plugins, put them here!
18 | group :jekyll_plugins do
19 | gem "jekyll-feed", "~> 0.6"
20 | gem "jekyll-commonmark-ghpages", "~> 0.2"
21 | end
22 |
23 | # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
24 | # and associated library.
25 | install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
26 | gem "tzinfo", "~> 1.2"
27 | gem "tzinfo-data"
28 | end
29 |
30 | # Performance-booster for watching directories on Windows
31 | gem "wdm", "~> 0.1.0", :install_if => Gem.win_platform?
32 |
33 | # kramdown v2 ships without the gfm parser by default. If you're using
34 | # kramdown v1, comment out this line.
35 | gem "kramdown-parser-gfm"
36 |
37 | gem "webrick", "~> 1.7"
38 |
--------------------------------------------------------------------------------
/docs/README.md:
--------------------------------------------------------------------------------
1 | # vmConsole home page
2 |
3 | ## Run locally
4 |
5 | Install dependencies as explained at [Using Jekyll with Pages](https://help.github.com/articles/using-jekyll-with-pages/),
6 | then run
7 |
8 | ```
9 | bundle exec jekyll serve
10 | ```
11 |
12 | to start a local server at http://localhost:4000.
13 |
14 | ## Add New Category For Posts
15 |
16 | 1. Add a new page file for the category at `pages/posts/Page not found
3 |
2 | {%- if page.category_name -%}
3 |
4 | {% assign category_posts = site.categories[page.category_name] %}
5 |
31 |
32 |
--------------------------------------------------------------------------------
/docs/_includes/disqus_comments.html:
--------------------------------------------------------------------------------
1 | {%- if page.comments != false and jekyll.environment == "production" -%}
2 |
3 |
4 |
19 |
20 | {%- endif -%}
21 |
--------------------------------------------------------------------------------
/docs/_includes/footer.html:
--------------------------------------------------------------------------------
1 |
7 |
--------------------------------------------------------------------------------
/docs/_includes/head.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | {%- seo -%}
6 |
7 |
8 | {%- feed_meta -%}
9 |
10 |
--------------------------------------------------------------------------------
/docs/_includes/header.html:
--------------------------------------------------------------------------------
1 | {{ page.category_name | capitalize }} Posts ({{ category_posts.size | default: "0" }})
6 | 7 | {%- if category_posts.size > 0 -%} 8 |-
9 | {%- for post in category_posts -%}
10 |
-
11 | {%- assign date_format = site.minima.date_format | default: "%b %-d, %Y" -%}
12 |
13 |
14 | 15 | {{ post.title | escape }} 16 | 17 |
18 | {%- if site.show_excerpts -%} 19 | {{ post.excerpt }} 20 | {%- endif -%} 21 |
22 | {%- endfor -%}
23 |
No Category Name Set
28 | {%- endif -%} 29 | 30 |
4 | {%- assign default_paths = site.pages | map: "path" -%}
5 | {%- assign page_paths = site.header_pages | default: default_paths -%}
6 | {{ site.title | escape }}
7 |
8 | {%- if page_paths -%}
9 |
27 | {%- endif -%}
28 |
29 | {{ page.title | escape }}
7 | 21 |
24 |
88 |
--------------------------------------------------------------------------------
/docs/_layouts/home.html:
--------------------------------------------------------------------------------
1 | ---
2 | layout: default
3 | ---
4 |
5 | 25 | As of now, the vmConsole application is distributed only through Google 26 | Play Store. Click on the badge below to proceed to the installation page. 27 |
28 | 29 |
30 |
31 | 
32 |
33 |
34 |
35 |
32 |
33 | 36 | It is planned to enable distribution of the application through GitHub 37 | Releases in future, so people without Google Services will be able to 38 | install it as well. Also this will allow us to provide a version of 39 | vmConsole without certain restrictions. 40 |
41 | 42 |System Requirements
43 | 44 |45 | These system requirements are not mandatory. Though on devices where 46 | they are met, you will be able to achieve the max from application. 47 | Remember that vmConsole is a virtual machine holding the full-blown 48 | Linux distribution. Do not be naive, this application IS NOT optimized 49 | for low-end devices. 50 |
51 | 52 |-
53 |
-
54 |
55 | Disk: 8 GiB minimum. 56 |
57 |58 | Assuming you will have one 6 GiB partition on persistent disk 59 | and leave some space for Android. Note that vmConsole provides 60 | 2 persistend disks with max size of 32 GiB. You will be able to 61 | use both fully if have more than 64 GiB free on shared storage. 62 |
63 |
64 | -
65 |
66 | RAM: 6 - 8 GB. 67 |
68 |69 | Having more is good only for overall Android multitasking. 70 | vmConsole automatically determines a safe amount of memory that 71 | it can allocate, but it has a hard limit of 2047 MiB, which 72 | partially is a technical limitation (32bit devices) and partially 73 | a safe threshold that will let Android multitasking function 74 | properly without OOM conditions. 75 |
76 |
77 |
80 | It is suggested to run vmConsole on 64bit devices, as it has been 81 | observed that QEMU has better emulation performance on these. But 82 | that is unclear, especially in cases where device is 64bit with 83 | 32bit only support on Android OS. Possibly that on devices having 84 | good CPU, the performace between 32bit and 64bit variants will be 85 | little to no. 86 |
87 |{{ page.title | escape }}
7 | 21 |
24 | {%- if page.title -%}
25 | 
31 |
32 |
65 |
66 |
--------------------------------------------------------------------------------
/docs/_layouts/page.html:
--------------------------------------------------------------------------------
1 | ---
2 | layout: default
3 | ---
4 | {{ page.title }}
26 | {%- endif -%} 27 | 28 | {{ content }} 29 | 30 |
31 |
32 | 33 | vmConsole is a Linux virtual machine application for Android OS. It is 34 | built on top of QEMU system emulator and 35 | runs Alpine Linux — a small, yet 36 | powerful Linux distribution. This application lets you to do everything, 37 | like from playing with Bash scripts to performing a penetration test 38 | of remote server. 39 |
40 | 41 |
42 |
43 |
44 |
45 |
46 |
47 |
44 |
45 | Powerful. 48 | Alpine Linux distribution has over 10000 packages in its repositories 49 | covering the majority of typical tasks. Text editors, compilers, network 50 | administration utilities and others are all there. 51 | 52 |
Secure. 53 | What happens inside VM is remaining to be inside VM. You can't mess up 54 | or brick your device by running something inside vmConsole. Note that 55 | you're given full root control over virtual machine without the need 56 | of rooting or installing customized version of Android. 57 | 58 |
Minimalistic. 59 | vmConsole design is minimal and provides only necessary UI elements 60 | and features in order to provide a stable and consistent software. 61 | It is not overloaded by garland of semi-working functions unlike 62 | certain similar applications. 63 | 64 |
{{ page.title | escape }}
8 | 17 | 64 |
67 |
72 | {% include anchor_headings.html html=content beforeHeading=true anchorBody="" %}
73 |
74 |
75 |
76 | {%- if site.disqus.shortname -%}
77 | {%- include disqus_comments.html -%}
78 | {%- endif -%}
79 |
80 |
81 |