search

KitsunedFox / termux-monet

Termux Monet - a terminal emulator application for Android 8+ OS extendible by variety of packages, with Monet support and experimental features.
https://github.com/KitsunedFox/termux-monet/releases/latest
GNU General Public License v3.0
1.02k stars 73 forks source link
android android-12 android-14 android-8 android12 android14 linux monet terminal termux

readme

Translation status



Termux-Monet is a unofficial, modified fork of Termux, an Android terminal application and Linux environment, with Monet Theming Implementations and Community-made changes.

This project is developed on my spare time, for me to learn more about Android development. Dont expect consistency, professionality or stability.

Translation status

Currently Using Weblate for Translations!

Join us in https://hosted.weblate.org/engage/termux-monet/

MONET IS ONLY AVAILABLE ON ANDROID 12+!

LOWER VERSIONS WILL DISPLAY A STATIC, BLACK AND WHITE MONET THEME

Termux-Monet can be updated by using Obtainium

Here's a quick tutorial on how to add it to the app.

Uploadit

Contents

Termux Monet and Plugins

The Termux Monet fork app comes with the following optional modified plugin apps:

These are Modified Plugins. All these repos are Forks from termux-app

Phantom Process Killer

NOTICE:

Termux may be unstable on Android 12+. Android OS will kill any (phantom) processes greater than 32 (limit is for all apps combined) and also kill any processes using excessive CPU. You may get [Process completed (signal 9) - press Enter] message in the terminal without actually exiting the shell process yourself. Check the related issue #2366, issue tracker, gist with details and this TLDR comment on how to disable trimming of phantom processes.

Deactivation Instructions (ADB):

Deactivation Instructions (ROOT):

Experimental Method (MAGISK)

Check if PhantomProcessKiller was Disabled (ROOT):

su -c /system/bin/dumpsys activity settings | grep max_phantom_processes
su -c /system/bin/device_config get activity_manager max_phantom_processes
su -c getprop persist.sys.fflag.override.settings_enable_monitor_phantom_procs

Nightly Builds

Termux-Monet application can be obtained on GitHub either from GitHub Releases for stablier releases or from GitHub Actions for the latest unstable releases.

Releases (Stablier)

Nightly (Unstable)

Security warning: APK files on GitHub are signed with a test key that has been shared with community. This IS NOT an official developer key and everyone can use it to generate releases for own testing. Be very careful when using Termux GitHub builds obtained elsewhere except https://github.com/termux/termux-app. Everyone is able to use it to forge a malicious Termux update installable over the GitHub build. Think twice about installing Termux builds distributed via Telegram or other social media. If your device get caught by malware, we will not be able to help you.

The test key shall not be used to impersonate @termux and can't be used for this anyway. This key is not trusted by us and it is quite easy to detect its use in user generated content.

Keystore information:

Alias name: alias
Creation date: Oct 4, 2019
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=APK Signer, OU=Earth, O=Earth
Issuer: CN=APK Signer, OU=Earth, O=Earth
Serial number: 29be297b
Valid from: Wed Sep 04 02:03:24 EEST 2019 until: Tue Oct 26 02:03:24 EEST 2049
Certificate fingerprints:
         SHA1: 51:79:55:EA:BF:69:FC:05:7C:41:C7:D3:79:DB:BC:EF:20:AD:85:F2
         SHA256: B6:DA:01:48:0E:EF:D5:FB:F2:CD:37:71:B8:D1:02:1E:C7:91:30:4B:DD:6C:4B:F4:1D:3F:AA:BA:D4:8E:E5:E1
Signature algorithm name: SHA1withRSA (disabled)
Subject Public Key Algorithm: 2048-bit RSA key
Version: 3

Wikis

True italic fonts

As described in https://github.com/termux/termux-app/pull/2829, true italic fonts support can be enabled when placing an italic font in ~/.termux/font-italic.ttf

Displaying images in Termux

As described in https://github.com/termux/termux-app/pull/2973, Termux can display images and gifs using sixel and iterm2 protocols.

For displaying images and gifs using Sixel, do pkg install libsixel and use img2sixel image.png

For displaying images using iTerm2, download the imgcat script, and use it with the command ./imgcat image.png

Dynamic Motd

As described in motds: add static motd back and use it as default instead of dynamic motd and add support for custom motd, in https://github.com/termux/termux-tools/pull/8, and in https://github.com/termux/termux-packages/pull/11250, Termux can now display both standard and dynamic motds.

For using your own custom dynamic motd, place a motd.sh executable file at ~/.termux/.

To use the dynamic motd provided by the latest termux-tools package, run ln -sf $PREFIX/etc/motd.sh ~/.termux/motd.sh.

Wallpaper support

As described in https://github.com/termux/termux-app/pull/3079, Wallpapers can be defined either by placing background_landscape.jpeg and background.jpeg on .termux folder or by selecting the option Set background image inside the terminal context menu, under "Appearance". Background image loading can also be enabled/disabled from settings. From Termux Settings -> Termux -> Termux Style -> Background Image.

An wallpaper overlay color can be defined through termux.properties, by using the key background-overlay-color=#COLOR. Supported color formats are #AARRGGBB and #RRGGBB

Running termux from ADB

As described in https://github.com/termux/termux-app/pull/1969, it is possible to access Termux directrly from adb shell via run-as. see the following example:

dreamlte:/ $ run-as com.termux
dreamlte:/data/data/com.termux $ PATH=/data/data/com.termux/files/usr/bin LD_PRELOAD=/data/data/com.termux/files/usr/lib/libtermux-exec.so /data/data/com.termux/files/usr/bin/bash -l
~ $ python
Python 3.9.2 (default, Feb 22 2021, 12:26:04)
[Clang 9.0.8 (https://android.googlesource.com/toolchain/llvm-project 98c855489 on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

Miscellaneous

Debugging

You can help debug problems of the Termux app and its plugins by setting appropriate logcat Log Level in Termux app settings -> <APP_NAME> -> Debugging -> Log Level (Requires Termux app version >= 0.118.0). The Log Level defaults to Normal and log level Verbose currently logs additional information. Its best to revert log level to Normal after you have finished debugging since private data may otherwise be passed to logcat during normal operation and moreover, additional logging increases execution time.

The plugin apps do not execute the commands themselves but send execution intents to Termux app, which has its own log level which can be set in Termux app settings -> Termux -> Debugging -> Log Level. So you must set log level for both Termux and the respective plugin app settings to get all the info.

Once log levels have been set, you can run the logcat command in Termux app terminal to view the logs in realtime (Ctrl+c to stop) or use logcat -d > logcat.txt to take a dump of the log. You can also view the logs from a PC over ADB. For more information, check official android logcat guide here.

Moreover, users can generate termux files stat info and logcat dump automatically too with terminal's long hold options menu More -> Report Issue option and selecting YES in the prompt shown to add debug info. This can be helpful for reporting and debugging other issues. If the report generated is too large, then Save To File option in context menu (3 dots on top right) of ReportActivity can be used and the file viewed/shared instead.

Users must post complete report (optionally without sensitive info) when reporting issues. Issues opened with (partial) screenshots of error reports instead of text will likely be automatically closed/deleted.

Log Levels

Disclaimer

There's no termux monet official groups other than github.com/termux-monet. If you see any Telegram or Threads group, that's not made by me! Any group that's not mentioned in this README.md is not official.

Do not report issues occurred in Termux Monet on termux-app repo, unless you're completely certain that this problem is also present in the regular Termux App.

By installing this app, you agree that you're aware of its unstableness.

I am not responsible for bricked devices, dead SD cards, thermonuclear war, or you getting fired because Termux didn't load. Please do some research if you have any concerns about features and code included in this forked App before installing it! YOU are choosing to replace your Termux app with this one, and if you point the finger at me for messing up your terminal and device, I will laugh at you.

Usage of Termux for attacking/hacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state and federal laws. Developers assume no liability and are not responsible for any misuse or damage caused by this program.

Forking

Special Thanks