MC4Y-Taskleiste – Desktop-Taskleiste der MC4Y-Produktivitätssuite
===================================================================
English version: README.txt

WAS IST DAS?
  Eine kleine Leiste, die immer auf Ihrem Bildschirm liegt – auch wenn kein Browser offen ist. Sie zeigt die
  Bereiche (Kategorien) der Suite; ein Klick klappt deren Werkzeuge auf, ein weiterer Klick öffnet ein
  Werkzeug in einem eigenen Fenster. Dazu gibt es eine Suche, Ihre Favoriten und eine Uhr, die den Kalender
  öffnet. Auch eigene Programme wie Word lassen sich einbinden. Die Leiste ist freiwillig – die Suite
  funktioniert auch ohne sie.


WAS SIE BRAUCHEN
  - Die Adresse Ihrer Suite und Ihr Anmeldename mit Kennwort – also dieselben Angaben wie bei der Anmeldung
    im Browser. Haben Sie die Taskleiste in der Suite heruntergeladen (Seite „Ihr Konto“, Abschnitt
    „Desktop-Taskleiste und App“), ist die Adresse schon eingetragen.
    Ohne Suite können Sie die Leiste nur für Programme, Dateien und Weblinks Ihres Rechners nutzen.
  - Python 3.8 oder neuer mit „tkinter“. Python ist eine Programmiersprache; die Taskleiste ist darin
    geschrieben. Unter Windows bietet die Installation an, Python selbst einzurichten. Auf dem Mac
    installieren Sie es vorher von python.org (siehe unten).
  - Kein Administratorkennwort: Die Taskleiste wird nur für Ihr eigenes Benutzerkonto eingerichtet.
  - Etwa 5 bis 10 Minuten.


INSTALLIEREN UNTER WINDOWS 10 UND 11
  1. Öffnen Sie den Explorer (Windows-Taste + E) und klicken Sie links auf „Downloads“.
  2. Rechte Maustaste auf „mc4y-taskleiste“ › „Eigenschaften“. Steht unten bei „Sicherheit“ „Die Datei stammt
     von einem anderen Computer …“: Häkchen bei „Zulassen“ setzen. Dann „OK“.
  3. Rechte Maustaste auf „mc4y-taskleiste“ › „Alle extrahieren …“ › „Extrahieren“.
  4. Öffnen Sie den neuen Ordner und darin „MC4Y-Taskleiste“.
  5. Doppelklicken Sie auf „installieren-windows“.
     Kommt ein blaues Fenster „Der Computer wurde durch Windows geschützt“: „Weitere Informationen“ ›
     „Trotzdem ausführen“.
     Sie sehen jetzt ein schwarzes Fenster mit der Zeile „MC4Y-Taskleiste - Installation fuer …“.
  6. Fragt es „Soll Python jetzt mit winget (nur fuer Ihr Benutzerkonto) installiert werden? [j/N]“:
     j tippen und die Eingabetaste drücken. Das dauert ein paar Minuten.
  7. Die Taskleiste startet, und es öffnet sich das Fenster „Mit der MC4Y-Produktivitätssuite verbinden“.
     Weiter bei „Erster Start“ unten.
  Die Taskleiste startet ab jetzt bei jeder Anmeldung an Windows; im Startmenü heißt sie „MC4Y Taskleiste“.

INSTALLIEREN AUF DEM MAC
  Vorher einmal: Python installieren (falls noch nicht geschehen)
    a. Öffnen Sie im Browser https://www.python.org/downloads/macos/
    b. Laden Sie den neuesten „macOS 64-bit universal2 installer“ herunter.
    c. Doppelklicken Sie im Ordner „Downloads“ auf die .pkg-Datei und folgen Sie den Schritten
       („Fortfahren“, „Akzeptieren“, „Installieren“, Ihr Mac-Kennwort).
  Dann die Taskleiste:
  1. Doppelklicken Sie im Finder (Ordner „Downloads“) auf „mc4y-taskleiste.zip“, falls Safari die Datei nicht
     schon ausgepackt hat. Sie sehen jetzt einen Ordner „MC4Y-Taskleiste“ (bzw. „mc4y-taskleiste“ mit
     „MC4Y-Taskleiste“ darin).
  2. Öffnen Sie das Terminal: cmd + Leertaste, „Terminal“ tippen, Eingabetaste.
     (Das Terminal ist ein Fenster für Befehle. Einfügen: cmd + V; ausführen: Eingabetaste.)
  3. Tippen Sie cd und ein Leerzeichen, ziehen Sie den Ordner „MC4Y-Taskleiste“ aus dem Finder ins
     Terminal-Fenster und drücken Sie die Eingabetaste. (Fragt macOS nach dem Zugriff auf „Downloads“: „OK“.)
  4. Kopieren Sie diesen Befehl ins Terminal und drücken Sie die Eingabetaste:

       bash installieren-macos.command

  5. Bei „Soll die Taskleiste beim Anmelden am Mac automatisch starten? [J/n]“ die Eingabetaste drücken (= ja)
     – oder n tippen, wenn Sie sie lieber selbst starten.
  6. Die Taskleiste startet, und es öffnet sich „Mit der MC4Y-Produktivitätssuite verbinden“. Fragt macOS
     später nach dem Zugriff auf den Schlüsselbund, wählen Sie „Immer erlauben“.
  7. Das Terminal können Sie jetzt schließen (cmd + Q) – die Taskleiste läuft weiter.
  Im Ordner „Programme“ Ihres Benutzers liegt jetzt das Programm „MC4Y Taskleiste“ mit Symbol (siehe „So starten
  Sie die Taskleiste später“). Bitte die Dateien des Pakets nicht per Doppelklick im Finder starten – macOS
  blockiert das bei Dateien aus dem Internet. Über das Terminal mit „bash …“ gibt es dieses Problem nicht.
  Haben Sie die Suite selbst auf dem Mac installiert, bot deren Installation die Taskleiste schon an – dann
  brauchen Sie diese Schritte nicht.

INSTALLIEREN UNTER LINUX
  Python mit tkinter installieren (zum Beispiel  sudo apt install python3 python3-tk ; Fedora: python3-tkinter),
  das Paket auspacken, im Ordner „MC4Y-Taskleiste“ ein Terminal öffnen und  sh installieren-linux.sh  eingeben.
  Die Frage nach dem Start beim Anmelden mit der Eingabetaste (= ja) oder n beantworten. Danach steht „MC4Y
  Taskleiste“ im Anwendungsmenü bzw. in der Programmübersicht; das Terminal können Sie schließen.


SO STARTEN SIE DIE TASKLEISTE SPÄTER
  - Windows: Startmenü › „MC4Y Taskleiste“ (bzw. Windows-Taste drücken und „MC4Y“ tippen).
  - Mac: Launchpad (im Dock das Symbol mit den bunten Kacheln; unter macOS 26 heißt es „Apps“) › „MC4Y
    Taskleiste“ – oder Spotlight: cmd + Leertaste, „MC4Y“ tippen, Eingabetaste – oder Finder › Gehe zu ›
    Benutzerordner › Programme. Tipp: das Symbol ins Dock ziehen.
  - Linux: Anwendungsmenü bzw. Programmübersicht › „MC4Y Taskleiste“.
  Läuft sie schon, holt ein erneuter Start sie nach vorn (auf den Bildschirm mit dem Mauszeiger).

  Start beim Anmelden ein- oder ausschalten:
  - Windows: Windows-Einstellungen › Apps › Autostart („MC4Y Taskleiste“).
  - Mac und Linux: in der Leiste auf 🔍 klicken, unten „Einstellungen“ › Häkchen „Beim Anmelden am Rechner
    starten“ › „Speichern“. Am Mac ab macOS 13 außerdem: Apple-Menü › Systemeinstellungen › Allgemein ›
    Anmeldeobjekte, Bereich „Im Hintergrund erlauben“ – ist er dort ausgeschaltet, startet die Leiste nicht.

  Zum Unterschied: In der Suite gibt es unter „Ihr Konto“ › „Darstellung“ auch eine Taskleiste IM BROWSER. Sie
  gehört zum Browserfenster und schließt sich mit ihm. Die Desktop-Taskleiste ist ein eigenes Programm und
  bleibt offen, bis Sie sie mit ✕ beenden.


ERSTER START
  1. Im Fenster „Mit der MC4Y-Produktivitätssuite verbinden“ steht bei „Adresse der Suite“ schon eine Adresse,
     wenn Sie die Taskleiste aus der Suite geladen haben. Sonst tragen Sie dieselbe Adresse ein, die Sie im
     Browser nutzen (zum Beispiel http://127.0.0.1:8090/ für die Suite auf diesem Rechner).
  2. Tragen Sie Ihren „Anmeldenamen“ und Ihr „Kennwort“ der Suite ein. Bei „Name dieses Geräts“ können Sie
     den Vorschlag lassen.
  3. Klicken Sie auf „Verbinden“.
     Sie sehen jetzt die Leiste unten links auf dem Bildschirm.
  Das Kennwort wird nicht gespeichert: Die Suite gibt der Taskleiste einen eigenen Geräteschlüssel. Ohne Suite:
  „Ohne Suite nutzen“ anklicken. Oben rechts im Fenster wählen Sie mit „DE | EN“ die Sprache der Leiste.


SO PRÜFEN SIE, OB ES GEKLAPPT HAT
  1. Klicken Sie in der Leiste auf einen Bereich (zum Beispiel „Produktivitäts-Tools“) und dann auf ein
     Werkzeug. Es öffnet sich in einem eigenen Fenster – Sie sind schon angemeldet.
  2. Melden Sie sich vom Rechner ab und wieder an: Die Leiste ist wieder da.


SO BEDIENEN SIE DIE LEISTE
  - Klick auf einen Bereich: Werkzeuge aufklappen · Klick auf ein Werkzeug: öffnen · ☆: als Favorit merken.
  - 🔍: Werkzeug suchen (Eingabetaste öffnet den ersten Treffer), zuletzt bearbeitete Dokumente, Einstellungen.
  - Griff ⠿ links: Leiste mit der Maus verschieben (auch auf einen anderen Bildschirm); Doppelklick = zurück an
    den Standardplatz unten links; rechte Maustaste = Menü.
  - ⇅ / ⇆: senkrecht bzw. waagerecht · Uhr: Kalender · ✕ am Ende: Taskleiste beenden (mit Rückfrage; wieder
    starten wie unter „So starten Sie die Taskleiste später“ bzw. beim nächsten Anmelden).
  - ⚙ Anpassen: eigene Bereiche anlegen, Reihenfolge ändern, Bereiche ausblenden, Programme Ihres Rechners
    (zum Beispiel Word) und Weblinks einbinden. „Aus den Programmen und Apps dieses Rechners wählen …“ zeigt
    alle installierten Programme zum Ankreuzen.
  - 🌐 Server / 💻 Lokal zeigt, woher die Werkzeuge kommen, wenn Sie mit mehreren Suiten verbunden sind.
  - Sprache: Die Leiste spricht Deutsch oder Englisch – Standard ist die Sprache Ihres Systems. Umschalten mit
    „DE | EN“ oben in der Suche 🔍 bzw. im Anmeldefenster, mit der rechten Maustaste auf den Griff ⠿ › „🌐 Sprache ·
    Language“ oder in den Einstellungen (dort auch „Automatisch – wie das System“). Werkzeuge der Suite öffnen
    sich in derselben Sprache, solange Sie im Browser keine eigene Wahl getroffen haben.


HÄUFIGE PROBLEME
  - „Anmeldename oder Kennwort falsch“: Gemeint ist Ihr Konto in DIESER Suite – dieselben Angaben wie bei der
    Anmeldung im Browser unter der eingetragenen Adresse. Den Anmeldenamen ohne Domäne eingeben.
  - Windows: Python wird nicht gefunden und winget fehlt: Python von https://www.python.org/downloads/windows/
    installieren (Häkchen „Add python.exe to PATH“ setzen) und Schritt 5 wiederholen.
  - Mac: „Für die Taskleiste fehlt Python …“: Python wie oben von python.org installieren, dann Schritt 4
    wiederholen. (Das Python, das macOS selbst anbietet, reicht nicht – es hat ein zu altes tkinter.)
  - Die Leiste ist nicht zu sehen: Starten Sie „MC4Y Taskleiste“ noch einmal (siehe „So starten Sie die
    Taskleiste später“) – die Leiste kommt dann auf den Bildschirm, auf dem der Mauszeiger ist.
  - Die Leiste verschwindet, wenn Sie den Browser schließen: Das ist die Taskleiste IM BROWSER – starten Sie das
    Programm „MC4Y Taskleiste“.
  - Mac, Fassung bis 1.4.1: Dort hieß das Programm „MC4Y-Taskleiste“ (ohne Symbol) und startete aus dem
    Terminal heraus. Einfach die Installation mit dem neuen Paket wiederholen – das alte Programm wird ersetzt.
  - Ein Virenschutzprogramm meldet die Taskleiste: Bitte melden Sie den Fehlalarm dem Hersteller und mir.
    Ausnahmen richten Sie bitte nur ein, wenn Sie das Paket aus Ihrer eigenen Suite bzw. von
    www.my-coaching4you.de geladen haben.


ENTFERNEN
  Windows: Im ausgepackten Ordner „MC4Y-Taskleiste“ auf „deinstallieren-windows“ doppelklicken.
  Mac:     Im Terminal:  bash ~/"Library/Application Support/MC4Y/Taskleiste/deinstallieren-macos.command"
           (entfernt das Programm „MC4Y Taskleiste“, den Start beim Anmelden und die Programmdateien)
  Linux:   sh deinstallieren-linux.sh
  Mit „-EinstellungenLoeschen“ (Windows) bzw. „--einstellungen“ (Mac, Linux) verschwinden auch Ihre
  Einstellungen und der Geräteschlüssel. Das Gerät in der Suite entfernen Sie auf der Seite „Ihr Konto“ im
  Abschnitt „Desktop-Taskleiste und App“.


FÜR FACHLEUTE

Installation
  Windows: installieren-windows.bat/.ps1 kopiert nach %LOCALAPPDATA%\Programs\MC4Y-Taskleiste, legt „MC4Y
           Taskleiste“ im Startmenü und im Autostart-Ordner an (ein-/ausschalten: Windows-Einstellungen › Apps ›
           Autostart), startet die Leiste. -Desktop: zusätzlich Desktop-Verknüpfung; -OhneAutostart; -OhneStart.
           Auch zum Aktualisieren erneut ausführen. Reste früherer Fassungen (%LOCALAPPDATA%\MC4Y\Taskleiste,
           Verknüpfung „MC4Y-Taskleiste“) räumt das Skript weg; was gesperrt ist, nennt es.
  macOS:   installieren-macos.command kopiert nach ~/Library/Application Support/MC4Y/Taskleiste und legt das
           Programm ~/Applications/MC4Y Taskleiste.app an (Info.plist, Symbol mc4y-taskleiste.icns, Anzeigename
           deutsch/englisch; Startprogramm Contents/MacOS/mc4y-taskleiste startet Python mit der Taskleiste und
           meldet sich sichtbar, wenn etwas fehlt). Start beim Anmelden auf Wunsch (Rückfrage; --autostart bzw.
           --ohne-autostart ohne Rückfrage): LaunchAgent ~/Library/LaunchAgents/de.my-coaching4you.mc4y-taskleiste
           .plist, der dieses Startprogramm aufruft (RunAtLoad, LimitLoadToSessionType Aqua; ab macOS 13 unter
           Anmeldeobjekte sichtbar). Gestartet wird über macOS (open), nicht als Teil des Terminals; --ohne-start
           startet nicht. Bis 1.4.1: „MC4Y-Taskleiste.app“ (AppleScript, ohne Symbol) – wird ersetzt. Sucht
           Python in /Library/Frameworks/Python.framework (python.org), /usr/local/bin, /opt/homebrew/bin;
           /usr/bin/python3 nur, wenn die Befehlszeilenwerkzeuge von Apple schon installiert sind (sonst würde
           macOS deren Installation anbieten). Braucht Tk 8.6 oder neuer. Auch zum Aktualisieren erneut ausführen.
  Linux:   installieren-linux.sh – Menüeintrag „MC4Y Taskleiste“ (~/.local/share/applications), Start beim
           Anmelden auf Wunsch (XDG-Autostart; --autostart / --ohne-autostart / --ohne-start wie am Mac),
           gestartet in eigener Sitzung (setsid) – läuft weiter, wenn das Terminal geschlossen wird.

Server und dieser Rechner
  - Die Leiste kann mit mehreren Suiten verbunden sein, zum Beispiel mit dem Server Ihrer Organisation UND der
    Suite auf diesem Rechner – jede mit eigenem Geräteschlüssel. Standard („automatisch“): Die Werkzeuge kommen
    vom Server; ist er nicht erreichbar (etwa unterwegs), von der Suite dieses Rechners. Alle fünf Minuten prüft
    die Leiste, ob der Server wieder da ist, und schaltet zurück.
  - Klick auf 🌐 Server / 💻 Lokal: fest auf eine Suite umschalten, zurück auf „automatisch“ oder „＋ Weitere
    Suite verbinden …“. Dasselbe in den Einstellungen unter „Verbindung“, dort auch „trennen“ je Suite.
  - Liegt dem Programm eine Server-Adresse bei (Download aus der Suite des Servers), lädt es beim Start einmal
    zur Anmeldung dort ein. „Abbrechen“ merkt sich das.
  - Adresse ohne http:// bzw. https://: für Server gilt https, nur für 127.0.0.1/localhost http.

Eigene Kategorien und Programme
  Eigene Kategorien (Werkzeuge der Suite und Weblinks) gelten für Ihr Konto, also auch für die Taskleiste im
  Portal und auf Ihren anderen Rechnern. Programme und Dateien dieses Rechners stehen NUR in den Einstellungen
  auf diesem Rechner (nicht in der Suite). Die Programmliste liest die Taskleiste nur lokal (Startmenü bzw.
  Programme-Ordner, ohne Registrierung, ohne andere Programme zu starten) und überträgt sie nicht.

Was speichert das Programm?
  In Ihrem Benutzerordner (Windows: %APPDATA%\MC4Y\taskleiste.json, macOS: ~/Library/Application Support/MC4Y/,
  Linux: ~/.config/mc4y/): Adresse der Suite, Anmeldename, Gerätename, Lage und Darstellung der Leiste, die
  gewählte Sprache, wie Werkzeuge geöffnet werden, die eingebundenen Programme und Dateien (Name, Pfad, Argumente,
  Kategorie) und eine Kopie Ihrer Kategorien. Den Geräteschlüssel legt es im Tresor Ihres Systems ab: Windows-Datenschutz (DPAPI),
  macOS-Schlüsselbund bzw. unter Linux secret-tool (fehlt es, in einer nur für Sie lesbaren Datei). Ein Gerät,
  das lange nicht genutzt wurde (Standard 90 Tage), muss sich neu anmelden. Das Programm verbindet sich nur mit
  der Adresse Ihrer Suite und sendet nichts an Dritte. Die Werkzeugliste lädt es beim Start und alle fünf
  Minuten neu.

Öffnen der Werkzeuge
  In einem eigenen, schlanken Fenster ohne Adressleiste (Microsoft Edge, Google Chrome, Chromium oder Brave) –
  oder, wenn Sie es so einstellen, als Tab im Standardbrowser. Unter macOS hat die Suche ein eigenes Fenster mit
  Rahmen (rahmenlose Fenster bekommen dort keine Tastatureingaben). Die Leiste hängt ihre Sprache an die Adresse
  an (&lang=de bzw. &lang=en); die Suite übernimmt sie, solange Sie dort keine eigene Wahl getroffen haben.

Sprache (seit 1.4)
  Deutsch oder Englisch (britisches Englisch). „Automatisch“ (Standard) folgt der Sprache des Systems: Windows –
  Sprache der Windows-Oberfläche; macOS – bevorzugte Sprache aus den Systemeinstellungen; Linux – LANGUAGE,
  LC_ALL, LC_MESSAGES bzw. LANG. Deutsch, wenn das System deutsch eingestellt ist, sonst Englisch. Die Namen der
  Werkzeuge und Kategorien der Suite übersetzt die Leiste selbst; eigene Kategorien, Programme und Weblinks
  bleiben, wie Sie sie benannt haben. Seit 1.4.1 folgen auch die Installationsskripte und die Ausgaben auf der
  Kommandozeile (--fassung, --selbsttest …) dieser Einstellung; für einen einzelnen Aufruf wählen Sie mit
  --lang de bzw. --lang en (Installationsskript unter Windows: -Sprache de).

Virenscanner
  Fassung 1.1.2 (18.10.2026) legte die Autostart-Verknüpfung über ein im Hintergrund gestartetes PowerShell an –
  ein Muster, das Bitdefender fälschlich als Schadsoftware einstufte. Seit 1.2 startet das Programm dafür nichts,
  schreibt nicht in den Autostart-Ordner und ändert nichts an der Registrierung; Verknüpfungen legt nur das
  Installationsskript an, das Sie selbst starten. Das Programm liegt seit 1.2 in einem neuen Ordner, die
  Verknüpfung heißt „MC4Y Taskleiste“.

Erprobt unter Windows 11. Am Mac ist die Installation der Suite auf einem echten Gerät erprobt (Oktober 2026);
das Programm „MC4Y Taskleiste“ mit dem Start beim Anmelden (seit 1.4.2) ist dort noch zu bestätigen. Linux ist
unterstützt, aber noch nicht auf echten Geräten erprobt – über Rückmeldungen freue ich mich.

Lizenz: GPL-3.0-or-later · Peter Hoenig, MY COACHING FOR YOU (https://www.my-coaching4you.de)
Ohne Gewähr; Haftung nur nach den gesetzlichen Vorschriften.
