# 🌍 Advanced System Analyzer - Help Guide
# Guía de Ayuda - Guide d'Aide - Hilfe-Anleitung - Guida di Aiuto - ヘルプガイド

## 📞 Support Contact
**For technical support and assistance:**
- **Phone**: +31 61 380 3782 (TEL1.NL)
- **Email**: support@tel1.nl
- **Hours**: Monday-Friday 9:00-18:00 CET

---

## 🇺🇸 English - Step by Step Guide

### System Requirements
- **Operating System**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 or higher
- **Memory**: 512 MB RAM minimum, 2 GB recommended
- **Storage**: 100 MB free space
- **Network**: Internet connection for initial setup

### Installation Steps

#### Step 1: Download and Extract
```bash
# Download the software package
# Extract to a folder of your choice
cd /path/to/cleanup
```

#### Step 2: Install Python Dependencies
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# Or create virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Step 3: Run the Application
```bash
# One-click startup (recommended)
python run.py

# Or start web server directly
python advanced_app.py

# Or run command-line analysis
python system_analyzer.py
```

#### Step 4: Access the Dashboard
- Open your web browser
- Navigate to: `http://localhost:5000`
- The dashboard will load automatically

### Using the Web Dashboard

#### 1. System Overview
- View system information, health status, and performance metrics
- Monitor CPU, memory, disk, and network usage in real-time
- Check system health indicators (green = good, yellow = warning, red = critical)

#### 2. Start Analysis
- Click the "Start Analysis" button
- Wait for the comprehensive system scan to complete
- Review results in the dashboard

#### 3. System Cleanup
- Click "System Cleanup" to remove temporary files
- Monitor cleanup progress and results
- View space freed and operations performed

#### 4. Download Reports
- Click "Download Report" to save analysis results
- Reports are saved as JSON files with timestamps
- Use for documentation or sharing with support

### Troubleshooting

#### Common Issues
1. **Port 5000 already in use**
   ```bash
   # Use different port
   python advanced_app.py --port 8080
   ```

2. **Permission errors**
   ```bash
   # Run with administrator privileges
   sudo python run.py  # Linux/macOS
   # Run as Administrator on Windows
   ```

3. **Missing dependencies**
   ```bash
   # Reinstall dependencies
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Getting Help
- Check the log file: `system_analyzer.log`
- Contact support: +31 61 380 3782
- Email: support@tel1.nl

---

## 🇪🇸 Español - Guía Paso a Paso

### Requisitos del Sistema
- **Sistema Operativo**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 o superior
- **Memoria**: 512 MB RAM mínimo, 2 GB recomendado
- **Almacenamiento**: 100 MB de espacio libre
- **Red**: Conexión a internet para configuración inicial

### Pasos de Instalación

#### Paso 1: Descargar y Extraer
```bash
# Descargar el paquete de software
# Extraer a una carpeta de su elección
cd /ruta/a/cleanup
```

#### Paso 2: Instalar Dependencias de Python
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# O crear entorno virtual (recomendado)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Paso 3: Ejecutar la Aplicación
```bash
# Inicio con un clic (recomendado)
python run.py

# O iniciar servidor web directamente
python advanced_app.py

# O ejecutar análisis en línea de comandos
python system_analyzer.py
```

#### Paso 4: Acceder al Panel
- Abrir navegador web
- Navegar a: `http://localhost:5000`
- El panel se cargará automáticamente

### Uso del Panel Web

#### 1. Vista General del Sistema
- Ver información del sistema, estado de salud y métricas de rendimiento
- Monitorear uso de CPU, memoria, disco y red en tiempo real
- Verificar indicadores de salud del sistema (verde = bueno, amarillo = advertencia, rojo = crítico)

#### 2. Iniciar Análisis
- Hacer clic en el botón "Start Analysis"
- Esperar a que se complete el escaneo completo del sistema
- Revisar resultados en el panel

#### 3. Limpieza del Sistema
- Hacer clic en "System Cleanup" para eliminar archivos temporales
- Monitorear progreso y resultados de limpieza
- Ver espacio liberado y operaciones realizadas

#### 4. Descargar Reportes
- Hacer clic en "Download Report" para guardar resultados del análisis
- Los reportes se guardan como archivos JSON con marcas de tiempo
- Usar para documentación o compartir con soporte

### Solución de Problemas

#### Problemas Comunes
1. **Puerto 5000 ya en uso**
   ```bash
   # Usar puerto diferente
   python advanced_app.py --port 8080
   ```

2. **Errores de permisos**
   ```bash
   # Ejecutar con privilegios de administrador
   sudo python run.py  # Linux/macOS
   # Ejecutar como Administrador en Windows
   ```

3. **Dependencias faltantes**
   ```bash
   # Reinstalar dependencias
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Obtener Ayuda
- Verificar archivo de registro: `system_analyzer.log`
- Contactar soporte: +31 61 380 3782
- Email: support@tel1.nl

---

## 🇫🇷 Français - Guide Étape par Étape

### Exigences Système
- **Système d'Exploitation**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 ou supérieur
- **Mémoire**: 512 MB RAM minimum, 2 GB recommandé
- **Stockage**: 100 MB d'espace libre
- **Réseau**: Connexion internet pour configuration initiale

### Étapes d'Installation

#### Étape 1: Télécharger et Extraire
```bash
# Télécharger le package logiciel
# Extraire vers un dossier de votre choix
cd /chemin/vers/cleanup
```

#### Étape 2: Installer les Dépendances Python
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# Ou créer environnement virtuel (recommandé)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Étape 3: Exécuter l'Application
```bash
# Démarrage en un clic (recommandé)
python run.py

# Ou démarrer serveur web directement
python advanced_app.py

# Ou exécuter analyse en ligne de commande
python system_analyzer.py
```

#### Étape 4: Accéder au Tableau de Bord
- Ouvrir navigateur web
- Naviguer vers: `http://localhost:5000`
- Le tableau de bord se chargera automatiquement

### Utilisation du Tableau de Bord Web

#### 1. Vue d'Ensemble du Système
- Voir informations système, état de santé et métriques de performance
- Surveiller utilisation CPU, mémoire, disque et réseau en temps réel
- Vérifier indicateurs de santé système (vert = bon, jaune = avertissement, rouge = critique)

#### 2. Démarrer l'Analyse
- Cliquer sur le bouton "Start Analysis"
- Attendre la fin du scan complet du système
- Examiner les résultats dans le tableau de bord

#### 3. Nettoyage du Système
- Cliquer sur "System Cleanup" pour supprimer fichiers temporaires
- Surveiller progression et résultats du nettoyage
- Voir espace libéré et opérations effectuées

#### 4. Télécharger Rapports
- Cliquer sur "Download Report" pour sauvegarder résultats d'analyse
- Les rapports sont sauvegardés en fichiers JSON avec horodatage
- Utiliser pour documentation ou partage avec support

### Dépannage

#### Problèmes Courants
1. **Port 5000 déjà utilisé**
   ```bash
   # Utiliser port différent
   python advanced_app.py --port 8080
   ```

2. **Erreurs de permissions**
   ```bash
   # Exécuter avec privilèges administrateur
   sudo python run.py  # Linux/macOS
   # Exécuter en tant qu'Administrateur sur Windows
   ```

3. **Dépendances manquantes**
   ```bash
   # Réinstaller dépendances
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Obtenir de l'Aide
- Vérifier fichier journal: `system_analyzer.log`
- Contacter support: +31 61 380 3782
- Email: support@tel1.nl

---

## 🇩🇪 Deutsch - Schritt-für-Schritt Anleitung

### Systemanforderungen
- **Betriebssystem**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 oder höher
- **Arbeitsspeicher**: 512 MB RAM mindestens, 2 GB empfohlen
- **Speicherplatz**: 100 MB freier Speicher
- **Netzwerk**: Internetverbindung für Erstkonfiguration

### Installationsschritte

#### Schritt 1: Herunterladen und Entpacken
```bash
# Softwarepaket herunterladen
# In einen Ordner Ihrer Wahl entpacken
cd /pfad/zu/cleanup
```

#### Schritt 2: Python-Abhängigkeiten installieren
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# Oder virtuelles Environment erstellen (empfohlen)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Schritt 3: Anwendung ausführen
```bash
# Ein-Klick-Start (empfohlen)
python run.py

# Oder Webserver direkt starten
python advanced_app.py

# Oder Kommandozeilen-Analyse ausführen
python system_analyzer.py
```

#### Schritt 4: Dashboard aufrufen
- Webbrowser öffnen
- Navigieren zu: `http://localhost:5000`
- Dashboard lädt automatisch

### Verwendung des Web-Dashboards

#### 1. Systemübersicht
- Systeminformationen, Gesundheitsstatus und Leistungsmetriken anzeigen
- CPU-, Speicher-, Festplatten- und Netzwerkauslastung in Echtzeit überwachen
- Systemgesundheitsindikatoren prüfen (grün = gut, gelb = Warnung, rot = kritisch)

#### 2. Analyse starten
- "Start Analysis" Button klicken
- Auf vollständigen System-Scan warten
- Ergebnisse im Dashboard überprüfen

#### 3. Systembereinigung
- "System Cleanup" klicken für temporäre Dateien entfernen
- Bereinigungsfortschritt und -ergebnisse überwachen
- Freigegebenen Speicherplatz und durchgeführte Operationen anzeigen

#### 4. Berichte herunterladen
- "Download Report" klicken für Analyseergebnisse speichern
- Berichte werden als JSON-Dateien mit Zeitstempel gespeichert
- Für Dokumentation oder Support-Sharing verwenden

### Fehlerbehebung

#### Häufige Probleme
1. **Port 5000 bereits belegt**
   ```bash
   # Anderen Port verwenden
   python advanced_app.py --port 8080
   ```

2. **Berechtigungsfehler**
   ```bash
   # Mit Administratorrechten ausführen
   sudo python run.py  # Linux/macOS
   # Als Administrator unter Windows ausführen
   ```

3. **Fehlende Abhängigkeiten**
   ```bash
   # Abhängigkeiten neu installieren
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Hilfe erhalten
- Protokolldatei prüfen: `system_analyzer.log`
- Support kontaktieren: +31 61 380 3782
- Email: support@tel1.nl

---

## 🇮🇹 Italiano - Guida Passo per Passo

### Requisiti di Sistema
- **Sistema Operativo**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 o superiore
- **Memoria**: 512 MB RAM minimo, 2 GB raccomandato
- **Archiviazione**: 100 MB di spazio libero
- **Rete**: Connessione internet per configurazione iniziale

### Passi di Installazione

#### Passo 1: Scaricare ed Estrarre
```bash
# Scaricare il pacchetto software
# Estrarre in una cartella di vostra scelta
cd /percorso/verso/cleanup
```

#### Passo 2: Installare Dipendenze Python
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# O creare ambiente virtuale (raccomandato)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Passo 3: Eseguire l'Applicazione
```bash
# Avvio con un clic (raccomandato)
python run.py

# O avviare server web direttamente
python advanced_app.py

# O eseguire analisi da riga di comando
python system_analyzer.py
```

#### Passo 4: Accedere alla Dashboard
- Aprire browser web
- Navigare a: `http://localhost:5000`
- La dashboard si caricherà automaticamente

### Utilizzo della Dashboard Web

#### 1. Panoramica del Sistema
- Visualizzare informazioni sistema, stato salute e metriche prestazioni
- Monitorare utilizzo CPU, memoria, disco e rete in tempo reale
- Verificare indicatori salute sistema (verde = buono, giallo = avviso, rosso = critico)

#### 2. Avviare Analisi
- Cliccare pulsante "Start Analysis"
- Attendere completamento scansione completa sistema
- Esaminare risultati nella dashboard

#### 3. Pulizia Sistema
- Cliccare "System Cleanup" per rimuovere file temporanei
- Monitorare progresso e risultati pulizia
- Visualizzare spazio liberato e operazioni eseguite

#### 4. Scaricare Report
- Cliccare "Download Report" per salvare risultati analisi
- I report vengono salvati come file JSON con timestamp
- Utilizzare per documentazione o condivisione con supporto

### Risoluzione Problemi

#### Problemi Comuni
1. **Porta 5000 già in uso**
   ```bash
   # Usare porta diversa
   python advanced_app.py --port 8080
   ```

2. **Errori di permessi**
   ```bash
   # Eseguire con privilegi amministratore
   sudo python run.py  # Linux/macOS
   # Eseguire come Amministratore su Windows
   ```

3. **Dipendenze mancanti**
   ```bash
   # Reinstallare dipendenze
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Ottenere Aiuto
- Controllare file di log: `system_analyzer.log`
- Contattare supporto: +31 61 380 3782
- Email: support@tel1.nl

---

## 🇯🇵 日本語 - ステップバイステップガイド

### システム要件
- **オペレーティングシステム**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8以上
- **メモリ**: 512 MB RAM最小、2 GB推奨
- **ストレージ**: 100 MB空き容量
- **ネットワーク**: 初期設定用インターネット接続

### インストール手順

#### ステップ1: ダウンロードと展開
```bash
# ソフトウェアパッケージをダウンロード
# 任意のフォルダに展開
cd /cleanupへのパス
```

#### ステップ2: Python依存関係のインストール
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# または仮想環境を作成（推奨）
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### ステップ3: アプリケーションの実行
```bash
# ワンクリック起動（推奨）
python run.py

# またはWebサーバーを直接起動
python advanced_app.py

# またはコマンドライン分析を実行
python system_analyzer.py
```

#### ステップ4: ダッシュボードへのアクセス
- Webブラウザを開く
- 移動先: `http://localhost:5000`
- ダッシュボードが自動的に読み込まれる

### Webダッシュボードの使用

#### 1. システム概要
- システム情報、ヘルスステータス、パフォーマンスメトリクスを表示
- CPU、メモリ、ディスク、ネットワーク使用量をリアルタイムで監視
- システムヘルスインジケーターを確認（緑=良好、黄=警告、赤=重要）

#### 2. 分析の開始
- "Start Analysis"ボタンをクリック
- 包括的システムスキャンの完了を待つ
- ダッシュボードで結果を確認

#### 3. システムクリーンアップ
- "System Cleanup"をクリックして一時ファイルを削除
- クリーンアップの進行状況と結果を監視
- 解放された容量と実行された操作を表示

#### 4. レポートのダウンロード
- "Download Report"をクリックして分析結果を保存
- レポートはタイムスタンプ付きJSONファイルとして保存
- ドキュメント化またはサポートとの共有に使用

### トラブルシューティング

#### 一般的な問題
1. **ポート5000が既に使用中**
   ```bash
   # 別のポートを使用
   python advanced_app.py --port 8080
   ```

2. **権限エラー**
   ```bash
   # 管理者権限で実行
   sudo python run.py  # Linux/macOS
   # Windowsで管理者として実行
   ```

3. **依存関係が不足**
   ```bash
   # 依存関係を再インストール
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### ヘルプの取得
- ログファイルを確認: `system_analyzer.log`
- サポートに連絡: +31 61 380 3782
- メール: support@tel1.nl

---

## 🇳🇱 Nederlands - Stap-voor-Stap Handleiding

### Systeemvereisten
- **Besturingssysteem**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
- **Python**: 3.8 of hoger
- **Geheugen**: 512 MB RAM minimaal, 2 GB aanbevolen
- **Opslag**: 100 MB vrije ruimte
- **Netwerk**: Internetverbinding voor initiële configuratie

### Installatiestappen

#### Stap 1: Downloaden en Uitpakken
```bash
# Softwarepakket downloaden
# Uitpakken naar een map naar keuze
cd /pad/naar/cleanup
```

#### Stap 2: Python-afhankelijkheden installeren
```bash
# Windows
python -m pip install -r requirements_simple.txt

# macOS/Linux
python3 -m pip install -r requirements_simple.txt

# Of virtuele omgeving maken (aanbevolen)
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install -r requirements_simple.txt
```

#### Stap 3: Applicatie uitvoeren
```bash
# Eén-klik start (aanbevolen)
python run.py

# Of webserver direct starten
python advanced_app.py

# Of commandoregel-analyse uitvoeren
python system_analyzer.py
```

#### Stap 4: Dashboard openen
- Webbrowser openen
- Navigeren naar: `http://localhost:5000`
- Dashboard laadt automatisch

### Gebruik van Web Dashboard

#### 1. Systeemoverzicht
- Systeeminformatie, gezondheidsstatus en prestatiemetrieken bekijken
- CPU-, geheugen-, schijf- en netwerkgebruik in realtime monitoren
- Systeemgezondheidsindicatoren controleren (groen = goed, geel = waarschuwing, rood = kritiek)

#### 2. Analyse starten
- "Start Analysis" knop klikken
- Wachten op voltooiing volledige systeemscan
- Resultaten in dashboard bekijken

#### 3. Systeemopschoning
- "System Cleanup" klikken voor tijdelijke bestanden verwijderen
- Opschoningsvoortgang en -resultaten monitoren
- Vrijgemaakte ruimte en uitgevoerde bewerkingen bekijken

#### 4. Rapporten downloaden
- "Download Report" klikken voor analyseresultaten opslaan
- Rapporten worden opgeslagen als JSON-bestanden met tijdstempel
- Gebruiken voor documentatie of delen met ondersteuning

### Probleemoplossing

#### Veelvoorkomende problemen
1. **Poort 5000 al in gebruik**
   ```bash
   # Andere poort gebruiken
   python advanced_app.py --port 8080
   ```

2. **Machtigingsfouten**
   ```bash
   # Uitvoeren met beheerdersrechten
   sudo python run.py  # Linux/macOS
   # Als beheerder uitvoeren op Windows
   ```

3. **Ontbrekende afhankelijkheden**
   ```bash
   # Afhankelijkheden opnieuw installeren
   pip install -r requirements_simple.txt --force-reinstall
   ```

#### Hulp krijgen
- Logbestand controleren: `system_analyzer.log`
- Ondersteuning contacteren: +31 61 380 3782
- Email: support@tel1.nl

---

## 📞 Support Information

### Technical Support
- **Phone**: +31 61 380 3782 (TEL1.NL)
- **Email**: support@tel1.nl
- **Hours**: Monday-Friday 9:00-18:00 CET
- **Languages**: English, Dutch, German, French, Spanish, Italian

### Emergency Support
For critical system issues outside business hours, please email with "URGENT" in the subject line.

### Documentation
- **User Guide**: This file (HELP_GUIDE.md)
- **Technical Documentation**: README.md
- **API Documentation**: Available in the web dashboard
- **Log Files**: system_analyzer.log

### Common Support Topics
1. Installation issues
2. Permission problems
3. Port conflicts
4. Performance optimization
5. System health issues
6. Report generation
7. API integration
8. Custom configurations

---

*Last updated: June 2025*
*Version: 1.0*
*Support: TEL1.NL - +31 61 380 3782*