Welcome to the documentation for malehTerminal! This is a powerful terminal that combines the ease of use of modern shells with the flexibility of Bash.
Features
- Many built-in commands
- Customizable style
- Open-source
- You can integrate own commads
Requirements
# Minimal requirements
OS: Linux, macOS, Windows
Memory: 512MB RAM
Storage: 50MB free space
Note
I tested malehTerminal on Linux so its best on any linux distro you like
cat
Usage
Print file contents
$ cat [file]
help
Usage
Get help for built-in commands
$ help [command]
cd
Usage
Change current working directory
$ cd [directory]
clear
Usage
Clear the terminal
$ clear
echo
Usage
Print text
$ echo [args]
ls
Usage
List contents of directory
$ ls [directory]
malehterminal
Usage
Get informations about malehTerminal
$ malehterminal
Arguments
--help Get help for malehTerminal
--info Get informations about malehTerminal
--update Update malehTerminal
mkdir
Usage
Create folders
$ mkdir [folder]
mv
Usage
Move files or folders
$ mv [path] [destination]
rm
Usage
Delete files
$ rm [file]
rmdir
Usage
Delete folders
$ rmdir [folder]
whoami
Usage
Print user
$ whoami
wget
Usage
Download files from web
$ wget [url] [destination]
Installation
The installation is quick and easy.
Download using git and python
Please make sure you have Python 3 or later installed on your device.
You can download the latest version from here
$ git clone https://github.com/Melih61/malehTerminal3.git
$ cd malehTerminal3
$ pip install -r requirements.txt
$ python terminal.py
Built-in Commands - Übersicht
malehTerminal bietet eine umfangreiche Sammlung von eingebauten Befehlen, die in verschiedene Kategorien unterteilt sind.
help
Zeigt Hilfe für verfügbare Befehle an
$ help [command]
version
Zeigt die aktuelle Version von malehTerminal an
$ version
clear
Löscht den Terminalinhalt
$ clear
Datei-Commands
Befehle für die Dateiverwaltung und -manipulation.
ls
Listet Dateien und Verzeichnisse auf
$ ls [-la] [directory]
cat
Zeigt Dateiinhalt an
$ cat filename.txt
touch
Erstellt eine leere Datei oder aktualisiert Zeitstempel
$ touch newfile.txt
rm
Löscht Dateien oder Verzeichnisse
$ rm [-rf] file_or_directory
Vorsicht
Der rm -rf Befehl löscht Dateien unwiderruflich. Verwenden Sie ihn mit Bedacht.
System-Commands
Befehle für Systeminformationen und -verwaltung.
ps
Zeigt laufende Prozesse an
$ ps [aux]
kill
Beendet einen Prozess
$ kill [-9] PID
env
Zeigt Umgebungsvariablen an
$ env
Navigation
Befehle für die Navigation im Dateisystem.
cd
Wechselt das Verzeichnis
$ cd [directory]
pwd
Zeigt das aktuelle Verzeichnis an
$ pwd
find
Sucht nach Dateien und Verzeichnissen
$ find /path -name "*.txt"
Configuration
malehTerminal can be customized the way you want
Config file
~/.malehterminalrc
Default config
PROMPT_STYLE="$USER@$OS $DIR$ "
USER_COLOR="red"
OS_COLOR="red"
DIR_COLOR="cyan"
SHOW_UPDATE_NOTIFICATION="true"
Themes
Passen Sie das Aussehen Ihres Terminals mit benutzerdefinierten Themes an.
Verfügbare Themes
- default - Standard-Theme
- dark - Dunkles Theme
- light - Helles Theme
- ocean - Blau-basiertes Theme
- forest - Grün-basiertes Theme
Theme wechseln
$ maleh theme set dark
Eigenes Theme erstellen
Erstellen Sie eine neue Theme-Datei:
# ~/.maleh/themes/custom.yml
name: "Custom Theme"
colors:
background: "#1e1e1e"
foreground: "#ffffff"
accent: "#00ff00"
error: "#ff0000"
warning: "#ffff00"
prompt:
format: "%u@%h:%w$ "
colors:
user: "#00ff00"
host: "#0000ff"
path: "#ffff00"
Aliases
Erstellen Sie Kurzbefehle für häufig verwendete Kommandos.
Alias erstellen
$ alias ll='ls -la'
$ alias grep='grep --color=auto'
$ alias ..='cd ..'
Persistente Aliases
Bearbeiten Sie ~/.maleh/aliases.yml:
# Datei-Aliases
ll: "ls -la"
la: "ls -A"
l: "ls -CF"
# Git-Aliases
gs: "git status"
ga: "git add"
gc: "git commit"
gp: "git push"
# System-Aliases
update: "sudo apt update && sudo apt upgrade"
install: "sudo apt install"
Alias verwalten
# Alle Aliases anzeigen
$ alias
# Alias entfernen
$ unalias ll
# Aliases neu laden
$ maleh reload aliases
Plugins
Erweitern Sie malehTerminal mit Plugins für zusätzliche Funktionalität.
Plugin installieren
$ maleh plugin install git-enhanced
$ maleh plugin install auto-suggestions
$ maleh plugin install weather
Verfügbare Plugins
git-enhanced
Erweiterte Git-Integration mit Statusanzeige
auto-suggestions
Intelligente Befehlsvorschläge basierend auf Historie
weather
Wetterinformationen direkt im Terminal
Plugin entwickeln
Erstellen Sie Ihr eigenes Plugin:
# ~/.maleh/plugins/my-plugin/plugin.yml
name: "My Custom Plugin"
version: "1.0.0"
description: "Ein benutzerdefiniertes Plugin"
commands:
- name: "hello"
script: "./hello.sh"
description: "Sagt Hallo"
hooks:
- event: "prompt_render"
script: "./prompt-hook.sh"
Scripting
malehTerminal unterstützt erweiterte Scripting-Funktionen.
Basis-Syntax
#!/usr/bin/maleh
# Variablen
name="World"
echo "Hello, $name!"
# Bedingungen
if [ "$name" = "World" ]; then
echo "Default greeting"
fi
# Schleifen
for i in {1..5}; do
echo "Count: $i"
done
Erweiterte Features
# JSON-Parsing
response=$(curl -s "https://api.github.com/user" | maleh json .name)
# HTTP-Requests
maleh http get "https://httpbin.org/get"
# Datei-Verarbeitung
maleh file process "data.csv" --format json
API Referenz
Programmiere Schnittstelle für die Integration mit malehTerminal.
JavaScript API
// Terminal-Instanz erstellen
const terminal = new MalehTerminal({
container: '#terminal',
theme: 'dark'
});
// Befehl ausführen
terminal.execute('ls -la');
// Event-Listener
terminal.on('command', (cmd) => {
console.log('Executed:', cmd);
});
REST API
# Terminal-Status abfragen
GET /api/v1/status
# Befehl ausführen
POST /api/v1/execute
{
"command": "ls -la",
"cwd": "/home/user"
}
Fehlerbehebung
Lösungen für häufige Probleme mit malehTerminal.
Häufige Probleme
Terminal startet nicht
Problem
malehTerminal startet nicht oder zeigt Fehlermeldungen beim Start.
Lösungsansätze:
# Konfiguration zurücksetzen
maleh config reset
# Logs überprüfen
maleh logs --tail
# Neuinstallation
maleh reinstall
Langsame Performance
Das Terminal reagiert langsam oder friert ein.
# Cache leeren
maleh cache clear
# Plugin-Konflikte prüfen
maleh plugin diagnose
# Performance-Modus aktivieren
maleh config set performance_mode true
Themes werden nicht geladen
# Theme-Cache zurücksetzen
maleh theme cache clear
# Verfügbare Themes auflisten
maleh theme list
# Theme neu installieren
maleh theme reinstall [theme-name]
Debug-Modus
Für erweiterte Fehlerbehebung:
# Debug-Modus starten
maleh --debug
# Verbose-Logging aktivieren
export MALEH_LOG_LEVEL=debug
maleh
Support kontaktieren
Wenn Sie weitere Hilfe benötigen:
- GitHub Issues: https://github.com/username/maleh-terminal/issues
- Discord Community: #maleh-support
- Email: support@maleh-terminal.com
Mitwirken
Tragen Sie zur Entwicklung von malehTerminal bei!
Entwicklungsumgebung einrichten
# Repository forken und klonen
git clone https://github.com/yourusername/maleh-terminal.git
cd maleh-terminal
# Abhängigkeiten installieren
npm install
# Entwicklungsserver starten
npm run dev
Code-Standards
Bitte folgen Sie diesen Richtlinien:
- ESLint-Regeln befolgen
- Tests für neue Features schreiben
- Commit-Messages nach Conventional Commits
- Dokumentation aktualisieren
Pull Request erstellen
# Feature-Branch erstellen
git checkout -b feature/neue-funktionalität
# Änderungen committen
git commit -m "feat: neue Funktionalität hinzugefügt"
# Tests ausführen
npm test
# Push und PR erstellen
git push origin feature/neue-funktionalität
Bereiche für Beiträge
Core Features
Grundfunktionen des Terminals erweitern
Plugins
Neue Plugins entwickeln
Themes
Visuelle Themes erstellen
Dokumentation
Docs verbessern und übersetzen
Architektur
Überblick über die interne Struktur von malehTerminal.
Komponenten
malehTerminal/
├── core/ # Kernfunktionalität
├── plugins/ # Plugin-System
├── themes/ # Theme-Engine
├── parser/ # Command-Parser
├── renderer/ # UI-Rendering
└── api/ # REST/WebSocket API
Datenfluss
So funktioniert die Befehlsverarbeitung:
- Benutzer gibt Befehl ein
- Parser analysiert und tokenisiert
- Command-Router findet Handler
- Befehl wird ausgeführt
- Ausgabe wird gerendert
Plugin-Architektur
// Plugin-Interface
interface MalehPlugin {
name: string;
version: string;
commands?: Command[];
hooks?: Hook[];
init(terminal: MalehTerminal): void;
destroy(): void;
}
Event-System
// Verfügbare Events
terminal.on('command:before', handler);
terminal.on('command:after', handler);
terminal.on('prompt:render', handler);
terminal.on('theme:change', handler);
Changelog
Versionshistorie und Änderungen.
Version 1.2.0 (2024-07-28)
✨ Neue Features
- Plugin-System mit Hot-Reloading
- Erweiterte Git-Integration
- Multi-Tab Support
- Verbesserte Auto-Completion
🐛 Bugfixes
- Theme-Switching Probleme behoben
- Memory-Leaks in Plugin-System
- Cursor-Position nach Resize
Version 1.1.0 (2024-06-15)
✨ Neue Features
- Benutzerdefinierte Aliases
- Theme-System
- Command-Historie
🔧 Verbesserungen
- Bessere Performance
- Reduzierte Bundle-Größe
- Verbesserte Dokumentation
Version 1.0.0 (2024-05-01)
🎉 Initial Release
- Basis-Terminal Funktionalität
- Standard Built-in Commands
- Einfache Konfiguration
Migration Guide
Für Updates von älteren Versionen siehe unseren Migration Guide.
Schnellstart
Los geht's mit malehTerminal in wenigen Minuten!
1. Installation
curl -sSL https://install.maleh-terminal.com | bash
2. Ersten Befehl ausführen
$ maleh
maleh> help
3. Konfiguration anpassen
maleh> maleh config edit
4. Plugin installieren
maleh> maleh plugin install git-enhanced
Tipp
Verwenden Sie maleh tutorial für eine interaktive Einführung!