huuck / katalina

Katalina is like Unicorn but for Dalvik bytecode. It provides an environment that can execute Android bytecode one instruction at a time.

Katalina

Katalina is like Unicorn but for Dalvik bytecode. It provides an environment that can execute Android bytecode one instruction at a time. Requires Python >= 3.10

How to install:

pip install -r requirements.txt

How to run:

python3 main.py -xe classes.dex

How it looks like:

What works:

• most instructions
• same-class method invocations
• Static fields/method invocations
• String APIs
• Base64 APIs

What kinda works:

• Iterator APIs
• Arrays APIs
• cross-class non static method invocations and fields

What's broken:

• MultiDex
• I/O
• Windows support might be broken because of the timeout mechanism, please use WSL to run it

katalina's Issues

Error in Simple App's classes.dex file

I created a sample app without using multi dex and then extracted classes.dex file and run Katalina, but this error shows.

ERROR ←[35mError running La0/d;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/activity/ComponentActivity;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/app/a;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/AppCompatTextView;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/SearchView$SearchAutoComplete;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/d;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/h;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/k;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/appcompat/widget/p;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/core/content/FileProvider;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/fragment/app/Fragment;->onCreateContextMenu: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/fragment/app/g;->onCreateView: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Landroidx/fragment/app/g;->onCreateView: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/appbar/AppBarLayout;->onCreateDrawableState: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/button/MaterialButton;->onCreateDrawableState: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/chip/Chip;->onCreateDrawableState: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/internal/CheckableImageButton;->onCreateDrawableState: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/internal/NavigationMenuItemView;->onCreateDrawableState: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/google/android/material/textfield/TextInputEditText;->onCreateInputConnection: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/photovideomaker/MainClas;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m
ERROR ←[35mError running Lcom/photovideomaker/SomeApp;->onCreate: module 'signal' has no attribute 'SIGALRM'←[0m

SyntaxError: invalid syntax

Traceback (most recent call last):
File "main.py", line 6, in
from vm import VM
File "/mnt/d/source_code/Python/Katalina/vm.py", line 4, in
from instructions import *
File "/mnt/d/source_code/Python/Katalina/instructions.py", line 111
match self.opcode:
^
SyntaxError: invalid syntax

wsl， python3.8