soja — Hibernation Helper Module

A smart CLI helper & thermal/memory cooldown protector for Linux Hibernation.

---

🌙 Overview

soja (meaning "go to sleep") is an intelligent hibernation management module for Linux (Fedora, Arch, Debian/Ubuntu).

While hibernating continuously keeps your session open across days, running without a clean system reboot eventually accumulates kernel RAM fragmentation and hardware thermal load.

soja acts as a smart guardian:

• Tracks continuous uptime and hibernation spans across days.
• Under 5 Days: Instantly hibernates your machine (systemctl hibernate).
• 5+ Days Continuous Span: Warns you in the terminal that a system cooldown is recommended, giving you an interactive choice to [1] Shutdown, [2] Reboot, or [3] Hibernate anyway.

---

🚀 Quick Installation

Option 1: Direct Command Line Setup (Recommended)

Clone the repository and run setup.sh:

git clone https://github.com/VinayakGhai/soja.git
cd soja
sudo ./setup.sh

Now simply type soja anywhere in your terminal!

Option 2: Portable AppImage

Run the self-contained .AppImage binary without installation:

chmod +x soja-1.0.0-x86_64.AppImage
./soja-1.0.0-x86_64.AppImage

---

💻 Usage

Simply open any terminal window and run:

soja

Sample Terminal Output

Normal Hibernation (Span < 5 Days)

 🌙  SOJA - Hibernation Helper Module v1.0.0
=================================================

📊 Current System Uptime / Span: 1.8 days (43.2 hours)
🔄 Hibernations in last 5 days: 3 times

✅ System state is healthy. No cooldown required.

⚡ Initiating system hibernation... Sweet dreams! 😴

Cooldown Warning (Span ≥ 5 Days)

 🌙  SOJA - Hibernation Helper Module v1.0.0
=================================================

📊 Current System Uptime / Span: 5.4 days (129.6 hours)
🔄 Hibernations in last 5 days: 6 times

════════════════════════════════════════════════════════════════════════
⚠️  SYSTEM COOLDOWN ALERT
Your system has been hibernating continuously for over 5 days (5.4 days).
A fresh boot/shutdown is recommended to clear thermal load and RAM leaks.
════════════════════════════════════════════════════════════════════════

What would you like to do?
  [1] Shutdown now (Recommended for complete Cooldown)
  [2] Reboot now (Refresh system kernel state)
  [3] Hibernate anyway (Bypass warning)
  [4] Cancel

Select option [1-4] (default 1):

---

🛠️ Building the AppImage

To build a fresh AppImage from source:

./build_appimage.sh

---

📜 License

Distributed under the MIT License. See LICENSE for details.