Just Enough Shell

Gemacht für den Alltag, nicht für Bilder.

Für wen ist JES?

• Desktop-PCs mit FHD+-Auflösung (der Autor verwendet UWQHD)
• Nutzer von SwayFX / Hyprland / Niri / DriftWM oder Enthusiasten mit Zeit für die Ersteinrichtung (die Shell selbst läuft auf jedem WM, aber dann fehlen die Tastenkombinationen und Tiling-Einstellungen)
• Wer Performance und Architektur über Trends stellt
• Wer eine angenehme und für CPU/GPU leichtgewichtige Oberfläche braucht

Wenn Sie zu dieser Zielgruppe gehören — willkommen. Wenn nicht — dann ist das Projekt vielleicht nichts für Sie, und das ist völlig in Ordnung.

-- WICHTIG -- :

• Nvidia-Grafikkarten funktionieren FURCHTBAR, alles kann jederzeit grundlos einfrieren, der Autor plant nicht, dieses Problem zu lösen, da es sich um Probleme auf Treiberseite handelt!
• Der Autor hat keine Erfahrung mit Arch Linux, die Installation unter Arch kann daher fehlerhaft sein. Sollte das der Fall sein, beschreiben Sie das Problem bitte in einem Issue und schlagen Sie nach Möglichkeit einen Fix vor
• Die Installationsanleitung befindet sich ganz unten
• Der Autor ist offen für Vorschläge und hilft beim Einstieg in das Projekt; bei Problemen bitte ein Issue erstellen

Wer lebendige Videohintergründe möchte, kann zwischen Videohintergründen und Shadern wählen (Letzteres funktioniert möglicherweise nicht gut mit der automatischen Theme-Generierung von JES)

Hintergründe aus den Screenshots: hier

Struktur von JES

-- Was sich in JES anpassen lässt --:

• wm - auto, aber für die Anbindung eines WM, das nicht in der Liste der verfügbaren steht, muss der Name großgeschrieben angegeben werden
• wm_type - auto, aber für ein WM außerhalb der Liste stehen workspaces oder coordinates zur Auswahl
• mainRad - Eckenradius, standardmäßig 10, funktioniert einwandfrei mit Werten von 0-25
• barOnTop - Steuerleiste oben sowie die zugehörigen Widgets, standardmäßig aktiviert
• minibar - macht die Leiste 1920px breit, standardmäßig deaktiviert
• BarHeight - Höhe der Leiste, standardmäßig 30
• fontSize - Schriftgröße, standardmäßig 17
• fontFamily - Schriftart, standardmäßig Mononoki Nerd Font Propo
• custom_wallpaper_engine - integrierte Hintergründe deaktivieren, standardmäßig false
• disableGenerate — Umschaltung des JES-matugen-Themas auf base16, standardmäßig false
• doNotDisturb - stiller Modus, standardmäßig false
• timezone — die Stadt für das Wetter-Widget; standardmäßig nicht vorhanden, der Wert wird aus der user-config.toml-Datei der NixOS-Konfiguration übernommen.

Wichtig: config.toml liegt im Quickshell-Ordner (~/.config/JES/)
In der .bashrc hat der Autor einen Alias hinterlegt – wer es sich sparen möchte, alles einzutippen, gibt einfach in der Konsole ein:
	jes-cli editConf 
Im Alias wird micro verwendet, zum Beenden Strg+Q, zum Speichern Strg+s

JES für DriftWM

-- Tastenkombinationen für SwayFX, Hyprland und Niri -- :

• Um das Plugin-Center zu öffnen, klicken Sie mit der rechten Maustaste auf den Netzschalter.
• Um den Kalender zu öffnen, klicken Sie mit der rechten Maustaste auf die Uhrzeit; ein Linksklick tauscht Uhrzeit und Datum.

Die Wahl der Taste für Screenshots wurde nach oben verlegt, da nicht jedem home zusagt oder die Taste fehlen kann – wie beim Autor, dessen Tastatur keine print-screen-Taste hat

Tastenkombinationen für DriftWM

-- So sieht JES aus --:

Desktop

Steuerleiste (die DriftWM-Version unterscheidet sich, siehe DriftWM_deu.md)

Hintergrundauswahl

Player

Energie-Buttons

fastfetch

Lautstärke- und Ton-Popup

App-Launcher

Bildschirmsperre

bash-Zeile

1 [02:00 - orflem:~]$  cd gits/just_enough_shell/
2 [02:00 - orflem:~/gits/just_enough_shell main]$  

Befehlsnummer, Datum, Benutzer, Verzeichnis, Git-Status (beim Öffnen eines mit Git verknüpften Projekts)

-- Plugins --:

Installation

1. Öffnen Sie ~/.config/JES/
2. Legen Sie den Plugin-Ordner dort ab
3. Öffnen Sie config.toml
4. Tragen Sie folgende Zeilen ein:
	 [[plugin]]
	 name = "plugin name" # Daten aus der Eigenschaft name in manifest.json
	 active = true

Ausführliche Anleitung zur Plugin-Erstellung

Plugin-Repository

Wichtig: Das Repository ist nur auf Englisch verfügbar, da dieser Teil stark von der Community des Projekts beeinflusst wird und es äußerst schwierig ist, alle kurzen Beschreibungen in verschiedene Sprachen zu übersetzen.

-- Installation von JES --:

NixOS clear

• Installieren Sie NixOS
• Führen Sie das Installationsprogramm aus:

nix-shell -p git --run "git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install.sh"

• Wählen Sie die vollständige Installation
• Starten Sie mit reboot neu

NixOS develop

• Installieren Sie NixOS
• Führen Sie das Installationsprogramm aus:

nix-shell -p git --run "git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install.sh"

• Wählen Sie die Installation nur von JES
• Fügen Sie in imports ./JES.nix und in der Konfiguration

services.jes = {
  enable = true;
  users = [ " your user" ];
};

hinzu

• Bauen Sie das System mit den gewünschten Parametern neu
• Starten Sie mit reboot neu

NixOS flake

• Geben Sie in flake Folgendes an:

{
	inputs = {
    jes.url = "github:ORFLEM/just_enough_shell";
	}
	outputs = { your inputs, jes, ... }@inputs:
  let
    system = "x86_64-linux";
    hostname = "nixos";

    specialArgs = { inherit inputs system hostname; };

  in {
    nixosConfigurations.${hostname} = nixpkgs.lib.nixosSystem {
      inherit system specialArgs;
      modules = [
				jes.nixosModules.default
			];
		};
	};
}

• Bauen Sie den Flake neu
• Geben Sie in configuration.nix

services.jes = {
  enable = true;
  users = [ " your user" ];
};

an

• Bauen Sie NixOS neu

Arch Linux oder Arch-basiert (kann fehlerhaft sein; bei Problemen bitte ein Issue erstellen)

• Installieren Sie Arch Linux (der Einfachheit halber wird EndeavourOS empfohlen)
• Starten Sie das Installationsprogramm:

git clone https://github.com/ORFLEM/just_enough_shell.git && cd just_enough_shell && ./install_arch.sh

• Im Falle von Fehlern installieren Sie manuell:

1. Installieren Sie Arch Linux (der Einfachheit halber wird EndeavourOS empfohlen)
2. Installieren Sie yay oder paru (yay: git clone https://aur.archlinux.org/yay.git && cd yay && makepkg -si)
3. Installieren Sie die offizielle Software (sudo pacman -Syu && pacman -S $(cat ./installer/arch_official.txt))
4. Installieren Sie Benutzer-Software (yay -S $(cat ./installer/arch_aur.txt))
5. Installieren Sie das zenburn-Theme für qt und gtk
6. Bei Bedarf können Sie die Systemthemes (GTK/Qt) auf zenburn anpassen und die Schriftart ter-v32n installieren
7. Erstellen Sie ein Backup der Benutzerkonfigurationen (cp -r ~/.config/ ~/backups/ && cp ~/.bashrc ~/backups)
8. Kopieren Sie die Dateien aus ".config/" nach "~/.config" und aus ".local/" nach "~/.local" (cp -r ./.local/* ~/.local/ && cp -r ./.config/* ~/.config/ && cp ./.bashrc ~/.bashrc)
9. Geben Sie reboot ein

-- Lizenz --:

Die Benachrichtigungen wurden aus dem Projekt blxshell übernommen und sowohl visuell als auch teilweise technisch modernisiert, Lizenz GNU GPL v3 Ein Blick darauf lohnt sich

Diese Konfigurationen werden unter der Lizenz GNU GPL v3 veröffentlicht.

Vereinfacht bedeutet das:

• Sie dürfen diesen Code frei verwenden, untersuchen und verändern.
• Wenn Sie Ihre Änderungen oder darauf basierenden Code mit anderen teilen (zum Beispiel einen Fork veröffentlichen), müssen Sie Ihren Quellcode ebenfalls offen und für alle zugänglich unter derselben Lizenz bereitstellen.

Das stellt sicher, dass alle Verbesserungen und abgeleiteten Werke genauso frei und offen bleiben wie das Original.

Den vollständigen Lizenztext finden Sie in der Datei LICENSE.

Created by _ORFLEM_