Termux Troubleshooting & Errors

ModuleNotFoundError: No module named 'x'

This happens when a required Python library is missing. You need to install it manually using pip.

Solution:
Run the following command, replacing 'module_name' with the name from the error:
pip install module_name

Common missing modules examples:

pip install requests colorama bs4

Command Not Found / Package Missing

If you see 'command not found' (e.g., for git, python, or curl), the package is not installed in Termux.

Step 1: Update Repositories
pkg update && pkg upgrade -y
Step 2: Install the missing package
pkg install python git curl

I keep getting 'Missing Package' errors. How do I fix them all?

Instead of installing packages one by one, you can use the built-in 'Update Packages' feature in Settings. This installs all necessary Python and Termux dependencies automatically.

Step 1: Open Settings
python3 Settings.py
Step 2: Select Option 3
Choose 'Update Packages & Modules' from the menu. It will install ffmpeg, clang, flask, and everything else needed.

The 'Update Packages' process is stuck/frozen

Sometimes the script successfully updates modules, but the loading animation freezes. If the update takes more than 15 minutes, the installation is likely done, but the interface has hung.

Solution:
You can safely force close the program using the shortcut below. This will not break the installation.
CTRL + C

Permission Denied / Storage Issues

If scripts cannot save files or you get 'Permission Denied', Termux needs storage access. Run this command to request it from Android.

termux-setup-storage

After running this, click 'Allow' on the Android popup.

Fix Broken Packages (dpkg error)

If installations fail with repository errors or dpkg interruptions, try this command to fix the package manager.

apt --fix-broken install

Termux Pro Tips & Tricks

How to keep Termux running in the background?

If Termux closes or stops your attacks when you turn off the screen, you need to acquire a Wake Lock. This prevents Android from killing the process.

termux-wake-lock

To disable it, simply run: termux-wake-unlock

Download Speed is too slow / Repository Errors

If packages are downloading very slowly or failing, try changing your repository mirror to a faster one.

termux-change-repo

Select all three options using spacebar, then press enter and choose 'Grimler' or 'Mirrors.bfsu'.

How to clear cache & save space?

Over time, downloaded package files take up space. You can safely remove them without uninstalling your tools.

apt clean && apt autoclean

General Questions

How do I change the menu style (List/Grid/Number)?

DedSec Project supports 3 menu styles. If the 'Grid' style looks broken on your screen, you can switch to 'List' or 'Number' mode via Settings.

python3 Settings.py --menu list

Or simply run Settings.py and select option 5 'Change Menu Style'.

How do I uninstall DedSec Project safely?

Do not just delete the folder!

DedSec modifies your terminal startup files. To uninstall correctly and restore your original settings, use the uninstall option found in Settings.

python3 Settings.py

Select option 8: 'Uninstall DedSec Project'. This will restore your original bash.bashrc and remove the project.

Do I need a Rooted device?

No. 95% of the tools in DedSec Project are designed to work without Root. However, some advanced features (like WiFi hacking with Aircrack-ng) may require Root or an external adapter, but the core toolkit is Root-free.

How do I update the toolkit?

You can update the toolkit in three main ways: run the installation command again, go into the repository folder and pull the latest changes from GitHub, or open Settings.py and use the update option inside Project Settings. If you use the built-in settings menu, it is the easiest guided way to update the project from inside DedSec itself.

cd DedSec && git pull
python3 Settings.py

Then open Project Settings and choose the project update option.

Are these tools safe?

The code is open source, meaning you can read every line before running it. We do not include malware. However, your Antivirus might flag them as 'HackTools' because they are designed for penetration testing. Use them responsibly.

Why DedSec Project is helping you for free?

Because we know freedom is a human right and not something to buy.

I'm not a hacker why I would want to use the project?

You may not be a hacker, but you would like to keep your personal life private.

Internet connects everyone to everything, providing the government with all the information about your interests and habits, of course unknowingly to you that concerned, you know this right?

You are now less valuable than the data you produce.

Community, Support & Issues

I found a bug. How do I report it?

If you encounter any issues or errors that are not solved in this FAQ, please open an Issue on our GitHub repository. We actively check for bug reports.

How can I support the project?

DedSec Project is free and open source. If you like our work, you can support us in the following ways:

Star the Repository:
Give us a star on GitHub to help us grow!
Follow the Developer:
Follow dedsec1121fk for updates and new tools.
Sponsor the Project:
If you want to contribute financially, you can sponsor us via GitHub Sponsors.

Installing & Understanding Termux

What is Termux?

Termux is an Android terminal application and Linux environment. In practice, it gives your phone or tablet a command line, package manager, and access to tools like Python, Git, SSH, editors, and many other command-line programs.

Where should I install Termux from?

Good default: use the official F-Droid package or the official GitHub releases/builds. Official Termux docs also describe a Google Play branch as experimental compared with the stable F-Droid build, so most users are still better served by F-Droid or official GitHub sources.

Official F-Droid
Official GitHub

Do I need the F-Droid app itself?

No. Official Termux installation docs note that you can download the Termux APK directly from the official F-Droid package page. Many people still install the F-Droid app because it makes updates easier to manage.

What should I run first after installing Termux?

A good first setup is: update packages, install the basics you need, and then grant storage access.

pkg update && pkg upgrade -y && pkg install python git unzip -y && termux-setup-storage

Why do I need termux-setup-storage?

Because Termux does not automatically get access to your shared storage. Running termux-setup-storage asks Android for the permission and prepares the usual shared-storage links so folders like Downloads become easier to reach.

What useful Termux add-ons should I know?

Useful add-ons include Termux:API for Android/device integrations, Termux:Styling for colors and fonts, Termux:Widget for home-screen shortcuts, Termux:Boot for startup scripts, and Termux:Float for a floating terminal window.

Why should I update all Termux packages together?

Termux uses a rolling-release style package environment. Partial upgrades can leave binaries and libraries out of sync, so a full package update is usually safer than fixing one dependency at a time forever.

pkg update && pkg upgrade -y

What is the safest first-time setup order in Termux?

For most users, the clean order is: install official Termux, open it once, allow storage, update all packages, install the main tools you need, and only then move into project-specific commands.

Recommended order
termux-setup-storage && pkg update && pkg upgrade && pkg install python git unzip curl wget nano

After that, move into the project folder and follow that project’s own install steps.

What is the Downloads folder path in Termux?

On most Android phones, the shared Downloads folder appears in Termux at the path below after you run termux-setup-storage.

/storage/emulated/0/Download

This is the folder used by many install commands, ZIP extraction steps, and export features.

How do I unzip a downloaded project ZIP into a Termux folder?

Use unzip with a source ZIP path and a target folder. The -o flag overwrites older files when you are updating an existing project.

mkdir -p ~/DedSec && unzip -o "/storage/emulated/0/Download/PROJECT.zip" -d ~/DedSec

Replace PROJECT.zip with the real ZIP name you downloaded.

Basic Termux Commands & Daily Use

How do I move around folders in Termux?

These are the most common navigation commands.

pwd ls -la cd foldername cd .. cd ~

How do I create, copy, move, and delete files?

mkdir myfolder touch notes.txt cp notes.txt notes-backup.txt mv notes.txt myfolder/ rm notes-backup.txt rm -r oldfolder

How do I view or edit a file fast?

cat file.txt less file.txt nano file.txt

Use cat for quick output, less for easier reading, and nano for simple editing.

How do I run Python or shell scripts?

python script.py python3 script.py bash script.sh chmod +x script.sh && ./script.sh

How do I search for files or text?

find . -name "filename" grep -R "search text" foldername

How do I search, install, and remove packages?

pkg search python pkg install python pkg uninstall python

How do I stop a command, clear the screen, or exit?

Use Ctrl+C to interrupt a running command, clear to clean the terminal view, and exit to close the current shell session.

clear exit

How do I check free space or folder size?

df -h du -sh foldername

How do I return to my project folder fast?

Use cd to jump back into the folder where your scripts live. After changing folders, run pwd so you can confirm the exact location before launching anything.

cd ~/DedSec && pwd

How do I check that I am inside the correct folder before running a command?

Two of the safest commands are pwd and ls. pwd shows where you are. ls shows what files are there. If the script name is missing, move with cd first.

pwd && ls

How do I see what a script saved in Downloads?

When a script says it exported files to Android Downloads, list that folder directly from Termux.

ls -lh /storage/emulated/0/Download

DedSec Project Basics & Site Guide

What is DedSec Project in simple words?

DedSec Project is a Termux-centered toolkit and website that brings together installation help, tool descriptions, FAQs, project pages, and guided resources in one place. The goal is to make starting, learning, and using the project much easier.

Who is the project for?

It is aimed at beginners, curious learners, privacy-minded users, and more advanced users who want a more organized mobile toolkit and site guide. You do not need to be an expert to start.

Do I need programming experience?

No. Programming knowledge helps over time, but the site is designed so you can begin from the installation guide, copy commands, use menus, and learn gradually.

Where should I start on the site?

Best order: Home page for the overview, Guide For Installation for setup, Learn About The Tools for categories and script descriptions, and FAQ whenever you hit a problem or want fast answers.

How do I install DedSec Project quickly?

The basic flow is: install Termux, update packages, install Git, clone the repository, and run the setup script.

pkg update -y && pkg upgrade -y && pkg install git nano -y && termux-setup-storage git clone https://github.com/dedsec1121fk/DedSec cd DedSec && bash Setup.sh

Does DedSec Project work without root?

For the main site experience and onboarding, the project is presented as working on most phones without root. Root is not shown as the normal starting requirement.

Is the project available in Greek too?

Yes. The site includes English and Greek content, and the interface can switch language. The FAQ and assistant also support both languages.

Where do I learn what each tool does?

Use the Learn About The Tools page. It groups the project into categories and gives descriptions for each script so you can browse by purpose instead of guessing from filenames.

Where do I report bugs or contact the project?

Use GitHub Issues for reproducible bugs. Use the Contact & Credits page for broader support, project communication, and contact-style questions.

What page should a beginner open first on the site?

A simple beginner path is: Home for the overview, Guide For Installation for setup, Learn About The Tools for explanations, FAQ for quick fixes, and Contact & Credits when you want support or project links.

Where are exclusive or sponsors-only scripts explained?

Use the exclusive pages when you want details about locked, sponsor-tier, or specially documented scripts. Those pages explain what the tool is, the intended use, and where it fits on the site.

ButSystem Exclusive

Where do I find contact and credits information quickly?

Open the Contact & Credits page for support routes, project communication, and contributor credit information in one place.

Contact & Credits

Where do I learn what each script does before running it?

Use the Learn About The Tools page to read descriptions and understand the role of each script before you run anything in Termux.

Learn About The Tools

Website Assistant & Navigation

How does the website assistant work?

The assistant matches words, short phrases, categories, and quick prompts to the closest answer stored in the website data. It is designed to help you jump to the right page or get a short answer without opening every section manually.

What can I tap in the assistant?

You can tap starter prompts, category buttons, tool names, Termux topics, or short requests such as install termux, ButSystem.py, guide for installation, or contact the project.

Why does the assistant sometimes show related choices?

If more than one topic is close to your prompt, the assistant shows related choices so you can pick the best match instead of getting the wrong page directly.

How do I reset the assistant to the start screen?

Use the ⌂ button in the assistant header to return to the welcome screen. Use refresh to reload the live assistant data, and use close to hide the panel.

Termux Daily Usage & File Handling

Where is the Downloads folder in Termux?

After you run termux-setup-storage, the shared Downloads folder is usually available through /storage/emulated/0/Download and also through ~/storage/downloads.

ls -lh /storage/emulated/0/Download ls -lh ~/storage/downloads

How do I unzip and overwrite old files?

Install unzip if it is missing, then use the -o flag when you want a newer archive to replace older project files.

pkg install unzip -y unzip -o "archive.zip" -d target_folder

How do I run a Python script with spaces in its name?

Use quotes around the filename or path. This works for both running scripts and changing directories.

python "Offline Survival.py" cd "/storage/emulated/0/Download/My Folder"

How do I find a file quickly in Termux?

Use find from the most likely base folder first instead of searching your whole device at once.

find ~/storage/downloads -iname "*dedsec*" find . -maxdepth 2 -type f

DedSec Tools & Project Help

Where can I read what each tool does?

Use the Learn About The Tools page. It is the best place to read descriptions, outputs, and notes before running a script.

How do I know where a DedSec tool saves output?

Check both Learn About The Tools and the Assistant. Most tools list a save path such as ~/storage/downloads/... or /storage/emulated/0/Download/...

Which tools are sponsor-only?

Look for the Sponsors-Only section on the tools page. That section separates restricted tools from the public parts of the project.

Where should a new user start?

Best order: Guide For Installation first, Learn About The Tools second, FAQ third, and then Assistant for quick matches and follow-up help.