Version 2.3.0

KaX Terminal Enhanced

Overview

KaX Terminal Enhanced is a modern, extensible terminal application built with CustomTkinter and Tkinter. It features a polished graphical interface, modular command system, dynamic module loading, and interactive utilities like a notepad and a customizable ball physics simulation game.

---

Features

• Modern UI: CustomTkinter-powered sidebar, theming, and custom widgets.
• Command Execution: Modular command handler with aliases and error handling.
• Command History: Navigate previous/next commands with arrow keys.
• Dynamic Modules: Easily add new features and interfaces.
• Custom Widgets: Enhanced entry and display widgets for better usability.
• Theming: Switch between dark, light, and custom color themes.
• Logo & Branding: Custom logo and branding in the UI.
• Integrated Utilities:
  • Notepad: Simple text editor interface.
  • Ball Physics Game: Highly customizable physics simulation with sidebar settings.
• Settings & Customization:
  • Ball radius, color, outline, opacity, initial velocity, gravity, bounce factor, simulation speed, circle size, circle outline, background color, random color, pause/resume.
• Error Handling: Friendly error messages and robust input validation.
• Extensible Structure: Add new commands, modules, and interfaces with ease.

---

Project Structure

KaX-Terminal-Enhanced
├── src
│   ├── main.py                # Main application entry point
│   ├── ui
│   │   ├── custom_widgets.py   # Custom widget classes
│   │   └── themes.py           # Theme definitions and manager
│   ├── logic
│   │   ├── commands.py         # Command handler and implementations
│   │   └── history.py          # Command history management
│   └── utils
│       └── helpers.py          # Utility functions
├── assets
│   ├── KaX_Terminal_BlackBG_WhiteTxt.png  # Logo image
│   └── Interfaces
│       ├── notepad
│       │   └── notepad.py      # Notepad interface
│       └── ballSimulationGame
│           └── ballPhysGame.py  # Ball physics simulation game
├── config
│   └── modules
│       └── sample_module.py     # Example module
├── requirements.txt             # Project dependencies
└── README.md                    # Project documentation

---

Installation

1. Clone the repository:

   git clone <repository-url>

2. Navigate to the project directory:

   cd KaX-Terminal-Enhanced

3. Install dependencies:

   pip install -r requirements.txt

---

Usage

1. Run the application:

   python src/main.py

2. Terminal Commands:
   • clear, cls — Clear the terminal display.
   • exit, quit — Close the terminal.
   • help, h, hlp, hl, hel, helpme — Show help and available commands.
   • notepad — Open the notepad interface.
   • ballgame, ball, game, ballPhysicsGame — Launch the ball physics simulation game.
   • echo <message> — Display a message.
   • version — Show terminal version.
   • resources — Display system resource usage.
   • Add your own commands via src/logic/commands.py!

---

Ball Physics Game

Launch via terminal command:
ballgame or ballPhysicsGame

Features:

• Place balls with left-click inside the circle.
• Drag balls with right mouse button.
• Balls bounce and collide with each other.
• Sidebar settings:
  • Ball radius, color, outline, opacity
  • Initial velocity (X/Y)
  • Gravity, bounce factor
  • Simulation speed
  • Circle size, outline thickness
  • Background color
  • Random color toggle
  • Pause/resume simulation

---

Customization

• Themes:
  Change appearance mode and color theme in src/ui/themes.py.
• Add Commands:
  Extend src/logic/commands.py for new commands.
• Add Modules/Interfaces:
  Place new modules in assets/Interfaces/ and load them dynamically.
• UI Widgets:
  Customize or extend widgets in src/ui/custom_widgets.py.

---

Documentation

Adding a New Command

1. Open src/logic/commands.py.
2. Add your command to the commands_list dictionary.
3. Implement its logic in execute_command.

Extending the Ball Physics Game

• Add new settings to the sidebar in ballPhysGame.py.
• Use sliders, entries, checkboxes, and buttons for user input.
• Update ball or simulation logic as needed.

Error Handling

• Use display_error and display_message methods in main.py for user feedback.

---

Credits

• CustomTkinter
• Tkinter

Screenshots

Terminal:

Ball Physics Simulation Game:

Notepad:

Version 1.3.0

New Features

• Countdown command:
  Adds a countdown command that can count down in seconds, minutes and hours.
• Modules:
  Adds a module folder where users can write their own code and place modules in this folder to customize KaX Terminal even more, there is already an official repository created by us, the repository for the official modules can be found here: https://github.com/D3stinyDev/KaX-Terminal-Modules/tree/main
  You can also install unofficial modules, these are created by our community, when installing unofficial modules then you could potentially risk your device, as the unofficial modules are not checked or overviewed by our developers. We are not responsible for any harm caused on your computer by an unofficial module!

Version 1.2.0

Release Notes

In this release, we've introduced several significant updates and improvements:

1. New Command for Settings: We've replaced the previous Settings interface with a streamlined command. You can now configure your terminal colors using the command:

setColor <TextColor> <BackgroundColor>

2. Bug Fixes: We've addressed several critical bugs that were affecting the terminal's usability, ensuring a smoother and more stable experience.

3. Notepad Feature: A new Notepad feature has been added, allowing you to write and save text as .txt files. Additionally, you can now drag and drop text files directly into the Notepad to open them seamlessly.

4. Removal of the Alias Command: We have removed the alias command due to its inconsistent behavior and inability to meet expectations. This decision was made to improve overall functionality and user experience.

5. New Ball Physics Game: We've added an interactive game that simulates a ball within a circular boundary, complete with physics-enabled movement. You can start the game by executing the following command:

ballPhysicsGame

Version 1.1.0

About

In this update, we have fixed major bugs that happened wile usage or inside the code. We also added a small, minimalistic ball physics game that you can play while you are bored, you can open it with the command 'ballPhysicsGame'.

Details

• Bugs: Inside the code, and while usage.
• Added: Ball Physics Simulation Game.