::GTX::> C:\Users\you\faq
::GTX::> cat FAQ.md

::GTX::> Frequently Asked Questions

Everything below comes straight from how GioTux actually works under the hood. Click a question to expand it.

General

Q. What is GioTux, exactly?

GioTux is a single .bat file that turns Command Prompt into a themed, Linux-flavored shell. When you launch it, it boots like a small OS — mounting a "filesystem," loading "drivers," dropping a custom color theme, then expanding to fill the screen — and lands you on a ::GTX::> prompt.

There's no virtual machine and nothing is replaced behind the scenes. It's still your real Command Prompt, running real commands against your real files and processes underneath the theme.

Q. Does it actually do anything, or is it just a reskin?

It's a working shell, not just a paint job. Commands like ls, cd, cat, grep, find, ps, kill, ipconfig, and df all run against your actual system — they list real files, kill real processes, and read your real network config.

Q. What platforms does it run on?

Windows only, since it's built entirely out of batch scripting plus a bit of PowerShell for extras (system info, the fullscreen switch, secure password prompts). Both come standard on any modern Windows install — nothing extra to install for the core shell.

Q. How do I get out of GioTux?

Type exit. If you're in admin mode or DOS mode it drops you back to the normal prompt first; typing it again (or from the normal prompt) logs you out cleanly and closes the window. shutdown is a different, much more serious command — see below.

Shell & files

Q. What file commands are available?

The core set covers everyday file work: ls / list (and dir for your current path), pwd, cd, mkdir, rmdir (add -r for non-empty folders), touch, rm (also supports -r), cp, mv, and cat.

On top of that there's grep [text] [file] to search inside a file, find [name] to search by filename from the current directory down, and history to see what you've typed.

Q. Is there a text editor?

Yes — nano or vi both open a bundled editor for the file you name. It needs a nano.exe sitting in a nano\ folder next to GioTux; if it's missing, GioTux tells you instead of failing silently.

Q. What system-info commands are there?

whoami, hostname, date, and uptime give you the basics. ps lists running processes and kill [PID] stops one. df shows disk space, and ping [host] / ipconfig cover networking.

ginfo is the standout: a full-screen dashboard showing OS, hostname, terminal, user, CPU, GPU, and memory, plus a live ANSI color test — press ENTER to return to the shell.

Q. Can I open files or programs from the prompt?

open [file or program] launches it with whatever app Windows has set as the default — same as double-clicking it in Explorer.

.gtux apps & games

Q. What's a .gtux app?

A tiny scripting format GioTux interprets line by line. It supports echo, cls, title, color, wait, pause, cowsay, set (variables), calc, random, input, conditional if statements with goto, and exit — enough to build a small branching program, not just a script that prints top to bottom.

Run one with run [appname] (or just type the app's name directly), and see everything installed in the current folder or next to GioTux with apps.

Q. How do games work?

Drop a batch-based game directly into a games\ folder that sits next to GioTux.bat — GioTux creates that folder automatically if it doesn't exist. Then run it with game [filename]. It launches in its own separate console window, so it never touches GioTux's own shell, and it can only ever point at files that live directly inside games\ — no paths, slashes, or drive letters allowed in the name.

Admin mode

Q. What does admin mode actually let me do?

Real system-level controls, gated behind a confirmation screen: restarting or shutting down the computer, locking the workstation, listing users, starting/stopping services, toggling the firewall, flushing DNS, resetting networking, kicking off a Defender scan, opening Windows Update, cleaning temp files, opening Event Viewer, forcing a Group Policy update, refreshing environment variables, checking disks, running sfc /scannow or DISM's RestoreHealth, and managing file ownership/permissions.

Type admin to unlock it (after acknowledging a warning screen), or run admin help any time to see the full command list.

Q. Is admin mode dangerous to turn on by accident?

It's built to make that hard. Entering it always shows a warning screen you have to explicitly accept, and if you've set a passcode (see below), that's required too. Individual destructive actions — like shutdown, disk repairs, or removing a passcode — ask for a separate confirmation on top of that. Nothing fires without you saying yes at least once, usually twice.

Q. Can I lock admin mode behind a passcode?

Yes — admin setpass sets a password or PIN. It's encrypted with Windows' own Data Protection API and tied to your specific Windows user account, so the saved file can't be read or reused by anyone else, even on the same machine. The file is also locked down (hidden, read-only, delete-denied) and can only be changed or removed through admin setpass / admin removepass while already in admin mode.

Q. What happens if I enter the wrong passcode?

You get three attempts. Get all three wrong and GioTux locks you out of admin mode for that session — no bypassing it from the shell.

ADB / Fastboot & other modes

Q. Does GioTux include Android device tools?

Yes. Typing adb with no arguments drops you into a dedicated ADB/Fastboot console with its own prompt and help screen — commands like devices, shell, install, uninstall, push, pull, reboot, and logcat, plus fastboot-prefixed commands for flashing partitions, reading bootloader variables, and rebooting. You can also run a single command directly with adb [args] without entering the full mode.

It looks for platform-tools in C:\platform-tools; if it's missing, GioTux tells you and opens the official Android developer download page.

Q. What's the difference between "cmd" mode and just closing GioTux?

cmd switches you into a real, unmodified black-and-white console — genuine DOS-style Command Prompt — while GioTux's own commands (ls, ginfo, admin, etc.) keep working alongside whatever native Windows commands you run. Typing exit from there brings back the themed prompt. It's a safety net for when you need the unmodified console without leaving GioTux entirely.

Q. What's the "gui" command?

gui launches a companion Python desktop app (giotux_gui.py) that's expected to sit next to GioTux.bat. It requires Python to be installed and on your PATH — GioTux checks for both and tells you plainly if either is missing rather than failing silently.

Customization & fun stuff

Q. Can I change the colors?

customize walks you through picking a background and text color from the standard 16-color console palette, and the choice is saved permanently to a small config file in your user profile — it's restored automatically every time you boot GioTux. Run customize default to reset back to the classic light-green-on-black look.

Q. What are the "just for fun" commands?
  • cowsay [text] — an ASCII cow says whatever you typed
  • fortune — a random developer-flavored fortune cookie
  • matrix — ambient falling-character rain in the terminal (Ctrl+C to stop)
  • sudo [command] — a harmless, joking "permission granted" wrapper
  • hack [target] — a fake, harmless "breach sequence" for laughs
Q. I heard there's a hidden command. Is that true?

Yes — there's a secret easter egg triggered by a specific sequence typed at the prompt. We're not going to spoil it here. If you find it, you'll know.

Safety & data

Q. Does GioTux leave anything behind when I exit?

Typing exit from the normal prompt logs out cleanly. The only thing that persists between sessions is the small color-preference file mentioned above (and, if you've set one, the encrypted admin passcode file) — both live quietly in your user profile.

Q. Will any command shut down or restart my computer without warning?

No. The real shutdown command and admin mode's restart/shutdown subcommands all require you to type an explicit confirmation before anything happens. Nothing destructive fires without you confirming first.

Q. Does GioTux need an internet connection?

No — the core shell works fully offline. A couple of specific commands reach out to the network on purpose: ping (obviously), the ADB download link if platform-tools isn't found, and the hidden easter egg's final step, which fetches a small ASCII animation if curl is available.

Full command reference

Every command GioTux understands, grouped by where you'd type it. Run help, admin help, or adbhelp in-app for the same lists live.

Main shell

ls / listList files in the current directory.
dirShow the directory you're currently in (use list to see files).
pwdPrint the current working directory.
cd [path]Change directory; no path returns you to your user folder.
mkdir [name]Create a new directory.
rmdir [name]Remove an empty directory; add -r to remove one with contents.
touch [file]Create a new empty file.
rm [file]Delete a file; add -r to delete a folder and its contents.
cp [src] [dst]Copy a file to a new location or name.
mv [src] [dst]Move or rename a file.
cat [file]Print a file's contents to the screen.
echo [text]Print text back to the screen.
nano [file] / vi [file]Open the file in the bundled text editor.
clear / clsClear the screen.
psList running processes.
kill [PID]Force-kill a process by its process ID.
whoamiShow the current Windows username.
hostnameShow the computer's network name.
dateShow the current date and time.
uptimeShow how long the computer has been running since last boot.
ginfoFull-screen system dashboard: OS, hostname, terminal, user, CPU, GPU, memory, and a live color test. Press ENTER to return.
dfShow free/total disk space for every drive.
ping [host]Ping a hostname or IP address.
ipconfig / ifconfigShow network adapter configuration.
open [file/app]Open a file or program with its default Windows app.
grep [text] [file]Search for text inside a file.
find [name]Find files by name, searching from the current directory down.
historyShow your command history for this session.
appsList installed .gtux apps found next to GioTux or in the current folder.
run [app]Run a .gtux app (or just type the app's name directly).
game [file]Launch a batch game from the games\ folder in its own window.
adbEnter ADB/Fastboot mode (or run adb [args] to fire a single command directly).
customizeInteractively pick and permanently save a background/text color pair.
customize defaultReset colors to the default light-green-on-black.
guiLaunch the companion Python GUI desktop (giotux_gui.py), if present.
cmdEnter DOS Mode — a real black-and-white console where native Windows commands run directly alongside GioTux's own.
cowsay [text]An ASCII cow says whatever text you give it.
fortunePrint a random developer-flavored fortune.
matrixFalling-character "digital rain" animation; Ctrl+C to stop.
sudo [cmd]Joke command — prints a fake password prompt, then just runs the command anyway.
hack [target]Fake, harmless "breach sequence" animation for laughs.
adminEnter admin mode after a warning screen (and passcode, if one is set). admin help lists its subcommands.
exitLeave DOS Mode or admin mode if active; otherwise log out of GioTux entirely.
shutdownShut down the real computer for real, after typing YES to confirm.

Admin mode (type admin first, or use admin <cmd> directly)

admin statusShow whether GioTux is running elevated, whether admin mode is active, and whether a passcode is set.
admin elevateRelaunch GioTux with a UAC elevation prompt.
admin restartRestart the computer (confirmation required).
admin shutdownShut down the computer (confirmation required).
admin lockLock the workstation immediately.
admin usersList local Windows user accounts.
admin servicesList all installed services and their state.
admin service start/stop <name>Start or stop a specific Windows service.
admin firewall statusShow the Windows Firewall state for all profiles.
admin firewall onEnable the Windows Firewall.
admin firewall offDisable the Windows Firewall (confirmation required).
admin dns flushFlush the local DNS resolver cache.
admin network resetReset IP and Winsock networking (confirmation required; needs a reboot after).
admin defender scanStart a Windows Defender quick scan.
admin updatesOpen the Windows Update settings page.
admin temp cleanDelete files in your TEMP folder (confirmation required).
admin logsOpen Event Viewer.
admin gpupdateForce a Group Policy update.
admin env refreshReload PATH from the registry for the current session.
admin disksShow a table of disk volumes.
admin checkdisk <drive>Run chkdsk on the given drive.
admin repairRun sfc /scannow to repair system files.
admin restorehealthRun DISM's /RestoreHealth to repair the Windows component store.
admin ownership <path>Take ownership of a file or folder (recursively).
admin permissions <path>View the ACL permissions on a file or folder.
admin setpassSet or change the encrypted admin-mode passcode.
admin removepassRemove the saved passcode (must already be in admin mode).

ADB / Fastboot mode

devicesList connected Android devices.
shellOpen an interactive shell on the connected device.
install [apk]Install an APK onto the device.
uninstall [package]Uninstall a package from the device.
push [local] [remote]Copy a file from your PC to the device.
pull [remote] [local]Copy a file from the device to your PC.
rebootReboot the connected device normally.
reboot bootloaderReboot the device straight into the bootloader.
logcatStream the device's system log.
get-stateShow the current ADB connection state.
fastboot devicesList devices currently in fastboot mode.
fastboot flash [part] [file]Flash an image file to a bootloader partition.
fastboot rebootReboot the device out of fastboot mode.
fastboot reboot-bootloaderReboot back into the bootloader.
fastboot getvar [var]Read a bootloader variable's value.
fastboot erase [part]Erase a bootloader partition.
exitLeave ADB mode and return to the normal GioTux prompt.

.gtux app scripting directives

echo [text]Print text to the screen.
clsClear the screen.
title [text]Set the console window title.
color [code]Set the console background/text color.
wait [seconds]Pause execution for roughly the given number of seconds.
pauseWait silently for a keypress.
cowsay [text]Print the ASCII cow saying the given text.
set [name] [value]Store a literal text value in an app variable.
calc [name] [expr]Store the result of an arithmetic expression, e.g. calc tries tries+1.
random [name] [max]Store a random whole number from 1 to max (default 100).
input [name] [prompt]Ask the user a question and store their answer.
goto [label]Jump unconditionally to a :label line in the app.
if [var] [op] [val] goto [label]Conditional jump; op is one of EQU, NEQ, GTR, LSS, GEQ, LEQ.
exitEnd the app immediately.