Linux Scripts Collection

A comprehensive collection of shell scripts and utilities for Debian/Ubuntu-based Linux systems, optimized for AMD Ryzen processors and gaming performance.

📁 Directory Structure

linux-scripts/
├── ai-tools/           # AI CLI tools and integrations
├── power-management/   # CPU/GPU power profiles and system optimization
├── gaming/             # Gaming launchers and performance optimizers
├── 3d-printing/        # 3D model conversion and rendering utilities
├── system-setup/       # System initialization and configuration
├── utilities/          # General-purpose utility scripts
├── automation/         # Configuration packaging and deployment
├── python/             # Python-based utilities
└── documentation/      # Manuals and reference materials

🚀 Quick Start

Clone the Repository

git clone https://github.com/ilPez00/linux-scripts.git
cd linux-scripts
chmod +x **/*.sh **/*

System Setup (New Installation)

# Run the base system initialization
sudo ./system-setup/base

# Or use the comprehensive installer
./system-setup/install_praxis_system.sh

📖 Script Categories

🤖 AI Tools (ai-tools/)

Script	Description	Dependencies
ai.sh	Installs AI CLI tools: Claude Code, OpenCode, Gemini CLI, Qwen Code	curl, npm
grok.sh	Opens Grok AI chat in Firefox	firefox
summon_clis.sh	Opens 3 terminal windows running Gemini, Claude, and Qwen	xfce4-terminal
cad.sh	Opens Tinkercad 3D modeling dashboard	firefox
cccp.sh	Opens DeepSeek AI chat	firefox
lmbook	Opens Google NotebookLM	firefox
check_keys.sh	Validates Gemini API keys in parallel	curl, bash, awk, xargs
test_generation.sh	Tests real generation on every Gemini key	curl, bash, awk, xargs, python3

⚡ Power Management (power-management/)

Script	Description	Dependencies
balanced-mode	Sets CPU governor to ondemand, balanced P-State EPP	sudo, /sys access
performance-mode	Sets CPU governor to performance, disables ASPM	sudo, /sys access
powersave-mode	Sets CPU governor to powersave, enables ASPM	sudo, /sys access
power-status	Displays current power profiles and schedulers	Read /sys access
power	Quick power profile switcher (gaming/battery/balanced)	sudo
power.sh	Toggles performance/powersave with GameMode and TLP	cpupower, gamemoded, tlp
full-system-optimize.sh	Complete AMD laptop optimization	sudo, apt, Debian
minecraft-system-optimize.sh	One-time Minecraft optimization	sudo, apt, systemd
omen.sh	HP Omen 16 Debian optimization	sudo, apt, Debian 13

🎮 Gaming (gaming/)

Script	Description	Dependencies
game	Universal game optimizer for AMD GPU	sudo, gaming platforms
steam-launch	Steam launcher with AMD GPU optimizations	steam
steam-optimizer.sh	System performance tweaks for Steam	sudo, gamemoderun
mct	Minecraft TLauncher optimized launcher	TLauncher, Java
minecraft-optimize.sh	Applies performance optimizations for Minecraft TLauncher	bash, Minecraft TLauncher, Java
minecraft-launch-optimized.sh	Launches Minecraft with optimized JVM arguments and RAM allocation	bash, Java, TLauncher

🖨️ 3D Printing (3d-printing/)

Script	Description	Dependencies
stl2u3d.sh	Converts STL to U3D format	meshlabserver
render_stl.sh	Batch-renders STL files to PNG	Blender
render_3d_previews.py	Renders 3D model previews	Python 3, trimesh, numpy

🔧 System Setup (system-setup/)

Script	Description	Dependencies
base	System initialization: installs deps, Flatpak, Oh My Zsh	apt, internet
install_praxis_system.sh	Praxis system installer with multiple flags	Various
setup_friend_debian	Sets up fresh Debian with custom configs	pack_friend_configs
locale_it.sh	Enables Italian locale (it_IT.UTF-8)	sudo, locale-gen
rice-macos	Makes XFCE look like macOS (WhiteSur theme)	git, wget, plank
sync_debian	Full backup to external drive	External drive
sync_debian_SAFE	Safe version with more detailed backups	External drive
update_sign_repo.sh	Signs local Debian APT repository	dpkg-scanpackages, GPG
thunar.sh	Configures Thunar file manager actions	xfce4-terminal, micro, xclip

🛠️ Utilities (utilities/)

Script	Description	Dependencies
meteo	Interactive weather forecast via wttr.in	curl
numerology	Full numerological analysis from names	None
numogram	Numerology charting tool	None
occult_engine	Gematria/occult calculations	None
esp.sh	ESP trainer game with ncurses	tput
ff2w3m.sh	Exports Firefox cookies to w3m	sqlite3, firefox
shutthefetchup	Joke script mocking fetch tools	None
mx-anywhere-3-config.sh	Configures Logitech MX Anywhere 3	solaar
mount.sh	Auto-mounts all unmounted partitions	lsblk, mount
usb / usb.sh	Disables USB autosuspend	sudo
dotfiles.sh	Backup dotfiles and sync to git	bash, git, apt-mark, deb-get, flatpak

📦 Automation (automation/)

Script	Description	Dependencies
pack_friend_configs	Packages dotfiles and configs for sharing	None

🐍 Python (python/)

Script	Description	Dependencies
file_sorter.py	Auto-categorization system with AI learning	Python 3, trimesh

⚙️ Requirements

Core Dependencies

Most scripts require these common tools:

sudo apt install -y \
  curl \
  git \
  sudo \
  sqlite3 \
  tput \
  xfce4-terminal \
  firefox \
  blender \
  meshlabserver \
  solaar \
  cpupower \
  tlp \
  gamemode \
  python3 \
  python3-pip

Python Dependencies

pip3 install trimesh numpy

Optional Dependencies

• AI Tools: npm (for Gemini CLI)
• Gaming: Steam, TLauncher, GameMode
• 3D Printing: Blender, MeshLab
• System Setup: Flatpak, deb-get, Oh My Zsh

📋 Usage Examples

Switch Power Profiles

# Performance mode (gaming)
sudo ./power-management/performance-mode

# Battery saving
sudo ./power-management/powersave-mode

# Check current status
./power-management/power-status

# Quick switcher
sudo ./power-management/power gaming

Optimize for Gaming

# Launch game with optimizations
./gaming/game

# Launch Steam optimized
./gaming/steam-launch

# Launch Minecraft
./gaming/mct

Weather Check

./utilities/meteo

Install AI Tools

./ai-tools/ai.sh

🔒 Permissions

Make all scripts executable:

chmod +x -R linux-scripts/

Many scripts require sudo for system-level changes. Run them with:

sudo ./power-management/full-system-optimize.sh

📚 Documentation

Additional documentation is available in the documentation/ directory:

• manuale - Italian system configuration manual
• manuale.txt - Command-line usage guide (Italian)
• tui-programs.txt - Catalog of 40+ terminal UI programs

🗂️ Related Projects

• friend-configs/ - Packaged dotfiles for sharing themes and configs
• sorter/ - File sorting module for Python utilities

⚠️ Notes

• Tested on: Debian 13, XFCE desktop
• Optimized for: AMD Ryzen processors, AMD GPUs
• Warning: Some scripts modify system settings. Review before running on production systems.
• Duplicate scripts: shutthefetchup and shutup.sh are identical; usb and usb.sh perform the same function.

📄 License

MIT License - See LICENSE file

👤 Author

Created by ilPez00 (Giovanni Pezzin)

🤝 Contributing

Feel free to fork, modify, and improve these scripts. Pull requests welcome!

📧 Support

For issues or questions, open an issue on GitHub.