batch24-28

A versatile terminal based utility, gaming and productivity suite featuring interactive tracking tools, computational modules, custom terminal art and text games.

Installation

Install directly from PyPI using pip:

pip install batch24-28

Features & Usage Guide

1. Welcome Art Banner

Display a clean, structured notification header or welcome banner in your terminal applications.

from batch24_28 import print_hello

print_hello()

2. Productivity Timers Suite

Run live tracking utilities right inside your script. Both tools use carriage returns (\r) to overwrite the line dynamically, keeping your terminal workspace completely clean without spamming new lines.

from batch24_28 import run_interactive_timer, start_stopwatch, start_countdown

# Option A: Interactive countdown setup that asks you for the duration
run_interactive_timer()

# Option B: Pass the minutes directly (e.g., a 5-minute timer)
start_countdown(5)

# Option C: Live stopwatch — press Ctrl + C to stop and view total time
start_stopwatch()

3. Advanced Calculator

A fast mathematical calculation utility to compute numerical data dynamically within your workspace scripts.

from batch24_28 import AdvancedCalculator

calc = AdvancedCalculator()
calc.interact()

4. Rock Paper Scissors Game

Launch an interactive text-based Rock, Paper, Scissors mini-game straight from the command prompt.

from batch24_28 import RockPaperScissors

game = RockPaperScissors()
game.play()

5. Terminal Chess Engine

Launch interactive full chess mechanics straight from the command prompt. Perfect for lightweight CLI based entertainment.

from batch24_28 import TerminalChess

game = TerminalChess()
game.play()

6. System Performance Monitor

Keep track of your system health in real-time. This module displays your current CPU and memory usage, using carriage returns (\r) to ensure your terminal stays clean and readable without filling up the screen.

from batch24_28 import start_system_monitor

# Launches a live monitor. Press Ctrl + C to stop.
start_system_monitor()

7. System Performance Sentinel

Monitor your CPU usage and receive real-time alerts when it exceeds a set threshold.

from batch24_28 import monitor_performance

# Monitor for CPU usage > 80%
monitor_performance(threshold=80)

8. System Information Reporter

Generates a comprehensive snapshot of system hardware and environment status.

from batch24_28 import generate_system_report

# Generate report to a file
generate_system_report("system_report.txt")

9. System Performance Sentinel

Monitor a directory for file system changes (created, modified, or deleted).

from batch24_28 import start_file_watcher

# Watch the current directory
start_file_watcher(path=".")

10. Computer Vision & Emotion Analysis Toolkit

An interactive computer vision pipeline powered by MediaPipe hand-tracking and deep learning emotion recognition. Includes virtual mid-air drawing (Air Canvas) and facial expression tracking via webcam, static images, or video files.

from batch24_28 import VisionAnalyzer

analyzer = VisionAnalyzer()

# Option A: Run live Air Canvas and Emotion detection via webcam
analyzer.run_air_canvas(run_draw=True, run_emotion=True)

# Option B: Analyze facial expression from a static image file
emotion, score, img = analyzer.analyze_image_file("path_to_image.jpg")
print(f"Detected: {emotion} ({int(score * 100)}%)")

# Option C: Stream and analyze a video file for expressions
analyzer.analyze_video_file("path_to_video.mp4")