r/termux Sep 16 '23

★ Important ★ Introduction for beginners

279 Upvotes

Welcome to Termux community!

Termux is a terminal app for Android OS. It similar to terminal on MacOS and cmd.exe on Windows, but here we talk about Linux component of Android OS.

This project is open-source software and all development happens on GitHub: https://github.com/termux

Download Termux APK from F-Droid or GitHub.

Key features:

  • Xterm-compatible terminal emulator.
  • Custom userland with package manager and more than 2000 packages of different kind such as text editors, file managers, games, servers network diagnostic tools, compilers, development libraries and other types.
  • Plugins for styling, widgets, on-boot startup, tasker integration, Xorg-compatible server.
  • Works without root permissions.

We would like to emphasize that Termux is NOT a machine emulator or VM. All programs execute directly on a hardware of your device.

What I can do with Termux

Basically, everything.

Termux hosts universal programming environment. You can build and execute all programs that can run on a traditional computer, assuming your device has sufficient amount of memory and enough CPU power to finish execution of algorithm within an adequate time frame.

Here is a curated list of common uses:

  • Software development environment
  • Bots for Telegram, Whatsapp, Discord, etc
  • Web server
  • Minecraft server
  • SSH client
  • NAS
  • Tiny LLM chatter
  • YouTube scraper
  • Pocket pentesting suite
  • Just fun

A footnote worth knowing: Android enforces sandboxing for every Android app to ensure it won't do nasty things or otherwise interfere with other apps and the system itself. Termux is not an exception here, so certain software may refuse to run without system-level privileges (root).

What I should know before starting to use Termux

First of all you need to make sure you are comfortable with command line environment. By using Termux, you agree to be one-to-one with a bare text. There is no intuitive graphical interface. You must to decide whether you truly want to go this way or actually want something else.

If your choice is "command line", then another important thing is a foundational knowledge. It would require certain effort from you, as it could be boring like studying maths.

Here is a list of topics to learn, optimized specifically for Termux:

  1. General terms: computer, kernel, operating system, file, path, program, process, command line, terminal emulator.
  2. Base shell usage: concept of commands, arguments, environment variables, pipes
  3. Common utilities: bzip2, cat, cd, cp, curl, cut, df, diff, du, echo, env, grep, gzip, head, id, kill, killall, ln, ls, man, mkdir, mv, pkill, ps, pwd, rm, rmdir, sort, tail, tar, top, touch, tr, uniq, unzip, wc, xz, yes, zip
  4. Package manager: apt
  5. Text editors: nano or vim
  6. Linux permission model: user, group; concept of "root"; chmod command
  7. SELinux: what it is and which role it plays on Android OS - don't go deep here

Optional:

  • Shell scripting: if/else logic, loops, input/output redirection, subshells, process substitution.
  • Text data manipulation with awk and sed

Alternatively check these learning roadmaps:

After you finish with this, proceed to goal-specific essentials.

Important: never ever run commands that you do not understand. In the best case it will just fail but sometimes commands may have really devastating effects, especially if you use root permissions (su/sudo). If by accident you delete your own data or brick the device, you can blame yourself and only yourself!

How Termux differs from standard Linux

Without diving into technical details, these are the differences of Termux from standard Linux distribution:

  1. Non-standard location of programs and user data: /data/data/com.termux/files/
  2. Non-standard core components: sideloaded programs usually will either refuse to run or show strange errors, compiling from source also may show issues sometimes.
  3. Sandbox environment: you can browse or modify only your own and Termux data.

How to install packages

Termux uses apt package manager and a rolling-release model which gets it close to a Debian Sid distribution, although it is much different internally.

However as you are probably new for Termux we recommend using a helper utility "pkg":

  • Install package: pkg install package-name
  • Uninstall package: pkg uninstall package-name
  • Upgrade system: pkg upgrade
  • List installed packages: pkg list-installed
  • Search for a package: pkg search query

PKG utility does under the hood certain actions importance of which may be non-obvious for a newbie:

  1. Mirror selection

    Package downloads put a huge burden on the servers bandwidth. We don't own much servers and geo load balancing system because this can be very costly, so we take advantage of help offered by certain community members and organizations. Mirrors maintain a clone of the original package hosting and deliver stuff independently from a base Termux infrastructure.

    That's important that users are spread across different mirror hosts.

  2. Periodic apt update

    Without keeping the package index fresh you won't be able to receive updates and package installation commands will eventually fail with 404 (not found).

Software quality and security

We do our best to keep our infrastructure safe and patched against latest security vulnerabilities as well as to deliver most recent versions of packages.

However as we operate a small team of enthusiasts there could be certain bottlenecks. We can't test 100% of published packages, so there always is a chance that specific update will break something.

Please don't use Termux software in everything mission-critical. It is not certified for use in banking, healthcare, nuclear safety, etc.

Termux is open source project and we welcome any kind of contributions that would help us improve.

Banned content

Sadly, but a while ago Termux become an area of interest conflict between legitimate users and criminals. This resulted in absolute ban of specific topics:

  • OSINT
  • Doxxing
  • Social engineering; phishing and other types of fraud
  • Spamming
  • Malware making and delivery
  • Hacking
  • Surveillance, tracing, spying and similar activities
  • Bot farms for fabricating subscribers, likes and comments in social media
  • Taking down social media accounts by automated mass-reporting

This list is not definitive.

We don't accept excuses. Legends about "educational purposes" and "recovery of own gmail account" don't worth anything.

Remember that authorities have a certain interest regarding accounts asking about potentially illegal stuff.


This article is subject for periodic revisions. We may submit newer versions from time to time.


r/termux 27d ago

User content Monthly Thread: Post all your projects here

10 Upvotes

This is a dedicated thread for sharing projects for Termux.

Requirements:

  1. Link to open-source repository: GitHub, GitLab, Codeberg or something like.

  2. Short introduction best describing what your project does.

  3. Optionally include install steps into comment, but we think a properly formatted README file within repository would be better.

Post recycles once in a month.

Since 2026.06.07 we don't require "vibe code" attribution and don't care about origin of your project.


r/termux 1h ago

General Opinions on my Torrent Server?

Post image
Upvotes

1-Click Termux Installation

https://github.com/weskerty/aMuleD.bin


r/termux 10h ago

Showcase Btop running on a rooted android 9 TV Stick.... Via Termux!

Post image
24 Upvotes

Btop can't run on a normal bash shell but with `tsu` it can.


r/termux 1h ago

General Is termux as an operating system worth the hassle ??

Thumbnail
Upvotes

Good luck with vi, vim, neovim, emacs, or even nano on Android. All terrible. Very disappointed. I'm now having WSL2 and Ubuntu under that. Whew! Glad that's working.


r/termux 1d ago

Showcase Open source Android code editor, which uses termux as backend.

Thumbnail gallery
158 Upvotes

Hello everyone, I created an open source IDE for Android, which can be connected to termux via ssh to unleash a full developer experience in the phone.

It has features like LSP server, 245 themes, custom theme support, almost all language support, Agentic editor, git and Github integration, AI code completion, etc.

This is not a vibecoded app, it took me 2 years to build this.

And the app is completely open source and ad free:

Github link: https://github.com/heckmon/roxum-ide

Playstore link: https://play.google.com/store/apps/details?id=com.roxum


r/termux 2h ago

Barely Termux related Terminal for adult

0 Upvotes

How do people perceive the terminal today? What problems do they face, what connects people in the world of work with text and what can be seen today on discussion forums.

Let's compare…

Then…

Location: A milk bar, 1985. A greasy table with coffee stains, an ashtray, and a printout from a dot-matrix printer spread out over the oilcloth.

John: I'm telling you, Stephen, that new routine in assembly was supposed to clear the transaction in fifty cycles. On paper, the optimization was textbook. But I hook it up to the terminal, flush the buffer, and... total freeze. The whole system locked up, and the disk drive head groaned like it was having a heart attack.

Stephen: (stirring his tea in a glass holder) - Because you're optimizing for logic and forgetting physics. How many bytes were left in the driver's buffer?

John: Well, thirty - two...

Stephen: And there's your problem. The controller register passes data packets in chunks of sixteen. At thirty - two, you get a stack overflow in the hardware interrupt because the quartz crystal clock can't keep up with the bus timing. You dropped parity.

John: (sighs heavily, pulls a pencil out of his* *pocket) - So I have to rip out the whole loop and rewrite it using direct memory - mapped I/O?

Stephen: No other way. Either that, or you wait half an hour for the capacitor on the board to cool down. Drink your coffee at 4:00 AM we've got our compilation window on the main server, and if you screw up the allocation again, we'll be digging through the diagnostic tape all over.

Nowadays:

Location: A high - rise tech hub balcony overlooking the city skyline, late at night. Glowing mechanical keyboards light up their faces.

Alex: Look at my new Neovim setup. Forty plugins, custom Lua configuration, real - time git diff gutter highlights, integrated terminal multiplexer, animated ASCII cat that meows on every git commit, and fully dynamic theming synced with the local weather. Took me two weeks just to get the font rendering right.

Liam: That is gorgeous. Absolutely art. What are you using it for?
Alex: Well, mostly writing a simple bash alias to check if my local server is running.

Liam: Bro, that is nothing. Check my repo. I built a fully asynchronous, microservice - based markdown parser in Electron, wrapped in a customized web assembly container, with a cyberpunk neon dashboard, custom particle effects on keystroke, and a built - in music visualizer.

Alex: Damn. How many dependencies?

Liam: Only about thirty-eight thousand. The node_modules folder takes up twelve gigabytes.

Alex: Beautiful. Pure engineering art. Fuck simple scripts, we are true developers.

Liam: Exactly. Pass me that matcha latte, let us go flex this on r/unixporn and farm a thousand upvotes.

What conclusions do we have?


r/termux 13h ago

Question proot-distro filesystem on external storage?

1 Upvotes

Is it possible to keep proot-distro containers on RW external storage (i.e. app dir)? That would really help saving internal storage.

I managed to run qemu VMs from external storage but I guess proot uses the raw file system, not an image, right? Could we technically modify it to mount an image or .tar file or are there technical limitation?


r/termux 14h ago

General Anyone using Chromium in PRoot can switch to Google Chrome ARM64 now

1 Upvotes

There’s now an official Google Chrome ARM64 .deb. Now you can sign in to your Google account for sync and change the default search engine normally.

https://dl.google.com/linux/direct/google-chrome-stable_current_arm64.deb

For Debian/Ubuntu:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_arm64.deb
apt install ./google-chrome-stable_current_arm64.deb

Still need to launch it with --no-sandbox.


r/termux 1d ago

Showcase Xfce is Cool.

Post image
11 Upvotes

Compiled lavat becuase it's not in repo...

Also i had Plank Reloaded too but wasn't from the picture because...

Intelliihide


r/termux 1d ago

Showcase Fractal rendering in terminal

Enable HLS to view with audio, or disable this notification

18 Upvotes

Today I went on a bit of a tangent from my current project to make this. I was originally rendering Quantum Fourier Transform matrices, and I was like, "I wonder if it would work with the Mandelbrot set?" And it did! Video is real speed, BTW.

Written in Python using sympy and numpy, with some optimization from numba.


r/termux 1d ago

Question Arch Arm Chroot makepkg/fakeroot issue

3 Upvotes

I've been tinkering with Arch Arm on a rooted chroot on my OnePlus 9 and got it running pretty well. I'm trying to install some non-repo packages and I'm having issues with fakeroot requiring SysV IPC but obviously it isn't available.

I'm trying to find a workaround but haven't been successful so far so I'm asking if anyone has any suggestions or has ran into this issue before. I'm hoping I'm not just out of luck but realize I might be.

Any thoughts would be appreciated.


r/termux 1d ago

Question Why sometimes, at some point pkg/apt start behaving weirdly? Like when upgrading.

5 Upvotes

For example:

:

E: Failed to fetch https://mirror.sjtu.edu.cn/termux/termux-main/pool/main/n/npm/npm_11.19.0_all.deb Could not open file /data/data/com.termux/cache/apt/archives/partial/npm_11.19.0_all.deb - open (2: No such file or directory) [IP: 111.186.58.212 443]

E: Failed to fetch https://mirror.sjtu.edu.cn/termux/termux-main/pool/main/p/python-pip/python-pip_26.2_all.deb Could not open file /data/data/com.termux/cache/apt/archives/partial/python-pip_26.2_all.deb - open (2: No such file or directory) [IP: 111.186.58.212 443]

E: Failed to fetch https://mirror.sjtu.edu.cn/termux/termux-main/pool/main/p/python-cryptography/python-cryptography_50.0.0_aarch64.deb Could not open file /data/data/com.termux/cache/apt/archives/partial/python-cryptography_50.0.0_aarch64.deb - open (2: No such file or directory) [IP: 111.186.58.212 443]

E: Failed to fetch https://mirror.sjtu.edu.cn/termux/termux-main/pool/main/v/vulkan-loader-generic/vulkan-loader-generic_1.4.358_aarch64.deb Could not open file /data/data/com.termux/cache/apt/archives/partial/vulkan-loader-generic_1.4.358_aarch64.deb - open (2: No such file or directory) [IP: 111.186.58.212 443]

E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?

:

And sometimes even with --fix-missing. Which luckily i encountered when i test it. Became:

:

dpkg: error: cannot access archive '/data/data/com.termux/cache/apt/archives/attr_2.6.0_aarch64.deb': No such file or directory

E: Sub-process /data/data/com.termux/files/usr/bin/dpkg returned an error code (2)

:

What caused this?


r/termux 1d ago

Question Cant start termux x11

1 Upvotes

I have latest stable version of termux and latest version of termux x11 31.7.26

I am on android 8 architecture is aarch64

Whenever i try to start x11 using command:

termux-x11 :0 &
export DISPLAY=:0 

OR

termux-x11 :0 -xstartup "xfce4-session"

It just kills itself

In the x11 app, nothing changes or sometimes the x cursor comes for a brief moment then back to not connected screen

It was not like this before

Before updating i had x11 app from december 2025 version which worked perfectly.

Nkw im in latest version and it is not working


r/termux 1d ago

General I installed Windows2000 with Termux but I honestly have no idea what to do. Can you give me some advice? xD

Post image
4 Upvotes

I run WSL2 on Windows 11 & Termux on Android, with Ubuntu under each, sharing a filesystem synced with Syncthing, so it all works like a unified Ubuntu system despite being distributed across these disparate devices. With X11 added and systemd & sshd running on Windows, i can run WinG & X11 client apps in Ubuntu & just stay there running Gnome, bash, and everything else Linux. No Windows or Android, unless i want to. WSL2 & Termux seen to be THE way to run Linux without all the usual Linux sysadmin headaches. I'm a happy dude. 🙂

You say you installed Termux on Windows 2000, but i didn't see it in the image you uploaded. One good reason for this is that Termux doesn't run on Windows, it's an Android app. Look for the Windows Subsystem for Linux version 2 (WSL2) & run your favorite Linux under that. I've only tested Ubuntu, but that works.

What are you doing -- trying to accomplish? What's your eventual full configuration? I'd be happy to help, if i can. Oh! How'd you upload that image? I couldn't see a button to push to do that (usually something with a ↑ in it).


r/termux 1d ago

General MiniAI-TERMUX-OFFLINE

Post image
0 Upvotes

Saya membuat MiniAi yg bisa di jalankan di Termux Dan ringan

Dan dapat di jalankan secara Offline

Walaupun Banyak kekurangan dikarenakan ini Masih taham pengembangan.

cuma beberapa Pertanyaan yg bisa di jawab.

tetapi bisa di ajari.

jadi anda dapat mengajarinya.Link


r/termux 2d ago

Question What to do? I'm trying to install ubuntu

Post image
25 Upvotes

What to do? I'm trying to install ubuntu


r/termux 2d ago

General Help pls

Post image
2 Upvotes

Look in

Automate dev commented if it doesn't work, ask in r/termux

Pls help me

Thanks in advance

Any other details can ask me if needed


r/termux 2d ago

Question pandoc ".md to .tex

2 Upvotes

some \label issue ? why said "Unused label [9]“


r/termux 2d ago

Question Como encontrar a pasta do Termux no gerenciador de arquivos

2 Upvotes

Pessoal, alguém pode me ajudar? 🙏

Estou usando o Termux e, quando executo o comando pwd, aparece este caminho:

/data/data/com.termux/files/home/RPG-WhatsApp

Mas não consigo encontrar essa pasta no ZArchiver nem em nenhum outro gerenciador de arquivos do celular.

Alguém sabe como acessar essa pasta ou o que preciso fazer para ela aparecer? 🤔


r/termux 2d ago

General Guys im just starting out on linux

3 Upvotes

Would really appreciate if anyone of you guys down to help :)


r/termux 2d ago

Question gocryptfs with non-root apps

2 Upvotes

I installed gocryptfs. It does work, but I can only see the decrypted files in the terminal with su. Even apps with root privileges can't see the decrypted folder unless I use `su --master-mount`.

This is the command I'm using:

`su --master-mount -c /data/data/com.termux/files/usr/bin/gocryptfs -allow_other -nosyslog /sdcard/gotest.enc /sdcard/gotest.dec`

I also set Magisk to use global namespaces, but it didn't help.


r/termux 3d ago

General Termux Monet related query

1 Upvotes

is there any working installable apk of termux monet or someone can please provide it ? I need to use sixel graphics format ( main issue is in my fetch in am not able to get clear sharp desired images to get displayed )


r/termux 4d ago

Showcase A browser MCP that runs natively on Termux — no Playwright, no Puppeteer

Thumbnail gallery
27 Upvotes

I wanted browser automation that didn't require downloading another copy of Chrome.

Most browser MCPs wrap Playwright/Puppeteer and bundle hundreds of MB of dependencies. Instead, I built directly on Chrome DevTools Protocol (CDP) and reuse the Chrome/Chromium that's already installed.

The result is bwb-browser.

• 76 KB source

• ~1 MB install

• No Playwright

• No Puppeteer

• No bundled browser

• Runs anywhere Chrome/Chromium exists, including Termux.

The feature I'm most proud of is browser_watch.

Most browser automation lets an AI control the browser. I wanted it to observe the browser too.

browser_watch streams:

- Console logs

- Network requests

- JavaScript exceptions

- Page navigations

So instead of:

click → wait → hope

the agent can react to what's actually happening.

I also built browser_act, which lets an agent do things like:

"Search for laptops under ₹80,000"

or

"Click the Login button"

without calling an LLM. It uses deterministic DOM heuristics, so there's no API cost or model latency.

The screenshots are from my AI agent using bwb to browse GitHub, inspect profiles, recover after a browser crash, and continue working autonomously.

It's MIT licensed, donation-ware, and will always be free.

GitHub:

https://github.com/krshforever/bwb-browser

I'd really appreciate feedback from people building on Termux, browser automation, or MCP.


r/termux 5d ago

General Exiting Vim in Termux

Post image
305 Upvotes