Das Grundeinkommen kann entscheidender Faktor für stabile Lebensverhältnisse und die Steigerung der Qualität und Teilhabe am gesellschaftlichen Leben sein. Ich selber verfolge das Projekt Mein Grundeinkommen e.V. bereits lange und verbinde es mit persönlichen Lebensumständen unmittelbar nach dem Studium, in denen ich es mir immer gewünscht hätte zu den glücklichen Gewinnern zu gehören. Umso mehr habe ich geschmunzelt, als mich das Glück ereilte zu den Gewinnenden zu gehören.

Was ein solcher Gewinn für mich persönlich bedeutete, was er ermöglichte und wie ich im Detail den monatlichen Obolus genutzt habe, möchte ich in diesem Post festhalten.

Lebenssituation

Ich habe im Jahr 2019 für mich entschieden, dass fünf Arbeitstage in der Woche in keinem gesunden menschenwürdigen Verhältnis zu lediglich zwei Wochen­end­tagen stehen und bin damals auf eine 4-Tage-Woche à 32 Wochenstunden gewechselt. Mir ist völlig klar, dass dies nicht jeder Mensch machen kann und ich ein Privileg genieße. In meinem persönlichen Fall habe ich die Entscheidung gewissenhaft durchgerechnet und für mich entschieden, dass ich alles habe, was ich zum Leben brauche und Geld ab einem Gewissen Punkt keinen zusätzlichen Zauber mehr ins Leben bringt. Statt eines fünften Arbeitstages habe ich jetzt einen altruistischen freien Tag an dem ich mich Menschen, Themen und Aufgaben widme, die primär nicht mir, sondern anderen zu Gute kommen. Das ist gut für den Kopf, schafft Abstand zur beruflichen Tätigkeit und bringt mich schneller gedanklich ins Wochenende.

“Wer zu viel arbeitet, begeht einen doppelten Betrug: Er betrügt sich selbst um sein Leben und seine Arbeit um ihre Güte.”

– Marie von Ebner-Eschenbach

Ich würde mich selbst als Puristen beschreiben, der Verpflichtungen lieber aus sicherer Entfernung betrachtet und auch eine Dekade nach Beendigung des Studiums den Studierendenmodus nie gänzlich verlassen hat. Ich habe, abseits von meiner Miete, keine hohen Ausgaben, habe keine laufenden Langzeit­verträge. Ich habe keine Schulden, kein Haus, das ich abbezahlen muss, keinen Handyvertrag. Ich führe keinen teuren Scheidungskrieg, muss keinen Unterhalt zahlen und fahre seit jeher nur treue 190er Benz, die ich ausnahmslos alle Bar auf die Kralle bezahlt habe und liebevoll mein Bluesmobil nenne.

Meine teuersten Investitionen der letzten Dekade waren ein MacBook Air M1 und ein iPhone 12, sowie mein aktueller 190er. Alles zusammen keine 6000 €. Mit dem Konsum ist es für mich wie mit dem Geld und der Arbeit: Irgendwann ist weniger mehr.

Erste Gedanken zum Gewinn

Als ich von dem Gewinn erfahren habe, waren es im Kern drei Gedanken, die mir initial durch den Kopf schossen:

1. Ich habe das Grundeinkommen im Tandem mit einer wunderbaren Person gewonnen, deren Lebensverhältnisse nicht deckungsgleich mit meinen waren und die in einem toxischen Bürojob gefangen war. Ihr Tag war geprägt von Arbeitskollegen mit unterkomplex vernetzten Gehirnen, Alltagsrassismen und intellektueller Stumpfheit. Diesen Job konnte sie nun glücklicherweise kündigen. Für ihr Leben würde der Gewinn sehr viel mehr ermöglichen, als für mich und daher habe ich mich in erster Linie viel mehr für sie gefreut, als über meinen eigenen Gewinn.
2. Mit zusätzlichen 1000 € im Monat hätte ich temporär meine Arbeitszeit weiter reduzieren und für ein Jahr auf eine 3-Tage-Woche à 24 Wochenstunden wechseln können. Den Gedanken habe ich aber relativ schnell verworfen, denn vermutlich wäre es mental für mich nicht verkraftbar gewesen erneut von drei auf vier Arbeitstage zu wechseln, sobald die Zahlungen des Grundeinkommens eingestellt würden.
3. Warum sollte ich den Gewinn ausschließlich für mich nutzen? Wäre es nicht zielführender das Geld, gemäß den Grundsätzen des Effektiven Altruismus, zum Nutzen Anderer einzusetzen und Gutes zu tun?

Ich habe mich dafür entschieden die Hälfte des Geldes für mich zu nutzen und die andere Hälfte wurde verwendet für Menschen, Organisationen, Open-Source-Projekte, etc., bei denen es Besser aufgehoben war, als bei mir.

Verwendungszwecke

An dieser Stelle sollen exemplarisch einige Ausgaben gelistet werden, für die ich das Grundeinkommen genutzt habe:

• Weihnachtsgeschenke: Persönlich hervorzuheben sei ein höherpreisiges Lego-Set für meinen ältesten Neffen, das er sich selber ausgesucht hat und mir sonst vermutlich zu teuer gewesen wäre. Da er meine kindheitliche Liebe für Lego teilt und der Weg hin zu Lego Technik geebnet werden muss, war es mir ein Anliegen ihm diesen Wunsch zu erfüllen.
• Ich habe meinem geschätzten Nachbarn und guten Freund einen Fender Akustik Bass gekauft, damit wir im Sommer zusammen stümperhaft Lieder von Nirvana im Vorgarten covern und dabei warmes Perli trinken können. Leider erwies sich sein Gehirn und Physiognomie als zu steiff und ungelenk, um sich der musischen Entfaltung auf (lediglich) vier Saiten hinzugeben. Vielleicht wird das ja in Zukunft noch was… Bis dahin habe ich einen formschönen Staubfänger im Wohnzimmer, den ich als Linkshänder nur bedingt spielen kann.
• Da ich seit zwei Jahrzehnten drei Paar Sneaker pro Jahr durchlaufe, habe ich schon länger einen nachhaltigeren Ansatz für die Fußbeplankung angesonnen und daher zwei Paar Schuhe aus dem tradierten Hause Solovair gekauft, und zwar die Modelle 6 Eye Astronaut Boot und Black Greasy Dealer Boot. Insbesondere letzteres Modell ist schlichtweg ein Traum, wenn man schnell mal in bequeme Schuhe springen muss. Für den Astronaut Boot empfehle ich den eigenen Horizont zu erweitern und einen Berlutti-Knoten zu lernen, da diese Schuhe ohne gewachste Schnürsenkel ausgeliefert werden.
• Ich habe einem feinen Menschen, den ich mehr schätze als ihr vermutlich bewusst ist, bei einer ausstehenden Zahlung und endlosem Inkasso-Papierkrieg-Terror mit dem Job Center unter die Arme gegriffen und zeitgleich, in Teilen, die Kosten für eine anstehende Katzenoperation bezahlt. Gut Pfote, Mush, und auf weitere sechs Leben!
• Ich habe das lokale Kinderhospiz mit einer Spende beglückt, da ich aus meiner Zivildienstzeit weiß, wie unglaublich wichtig deren Arbeit ist. Das mache ich generell jährlich, aber dieses Jahr konnte ich einen höheren Betrag auf den Tisch legen und das hat mich innerlich freudig gestimmt.
• Ich habe das gesamte Mehrparteienhaus zum Essen beim Italiener eingeladen, weil es allesamt tolle Menschen sind und ich mich glücklich schätzen kann, dass wir so eine innige und umgängliche Nachbarschaft formen, trotz anonymen Großstadtlebens. Haupttreiber der Einladung war der feierliche Auszug eines verwirrten Hausbewohners, der die gesamte Hausgemeinschaft auf Trab hielt und dessen Eskapaden in dem separaten Beitrag Ein Krawallant im Haus festgehalten wurden.
• Da ich selber ein großer Freund von Open-Source-Software und freiem Wissen bin, habe ich diverse Projekte und Dienste unterstützt, unter Anderem:
  • Signal, da es mir bis heute unverständlich ist, wie Menschen einen Messenger wie WhatsApp nutzen können, ohne sich dabei selber ihrer äffischen Abstammung bewusst zu werden.
  • Die Mozilla Foundation, die - trotz ihrer unsäglichen AI-Irrwege - nach wie vor den einzigen brauchbaren freien Browser Firefox entwickelt.
  • Die Matrix Foundation, da sie mit dem Messenger Element eine (noch nicht ganz brauchbare) Alternative zu Microsoft Teams und Discord entwickeln und mich an gute alte förderierende XMPP-Zeiten erinnert.

Restrospektive

Das vergangene Jahr mit einem Grundeinkommen hinterlässt rückblickend auf für mich folgende Erkenntnisse:

1. Der Gedanke, jederzeit kündigen zu können und ein Jahr lang keine finanziellen Sorgen zu haben, ist wunderschön und sollte gesellschaftlicher De-Facto-Standard werden. Ich bin der festen Überzeugung, dass viele Menschen sich beruflich umorientieren und genau die Sicherheit des Grundeinkommens nutzen würden, um in Ruhe, ohne Druck und mit Bedacht Ausschau nach einem Job zu halten, ohne sich den bekannten Gängeleien des Job Centers hingeben zu müssen.
2. Würde ich ein kontinuierlich ausgezahltes Grundeinkommen beziehen, hätte ich gekündigt und einen lang gehegten Traum verfolgt und eine Ausbildung zum Gitarrenbauer begonnen.
3. Mit dem Grundeinkommen ist es wie mit dem Glück, und es gilt “Sharing is caring”. Andere an seinem Gewinn teilhaben zu lassen, war und ist für mich der schönste Gedanke, der sich bei mir verfestigt hat.

Allen zukünftigen Gewinnern kann man nur aus tiefstem Herzen gratulieren, denn ein Grundeinkommen macht was im Kopf!

Vorhaben

Ziel dieses Beitrags ist Home Assistants mächtige Funktion der Automation Templates näherzubringen und diese zu nutzen, um die bestehende Custom App zu optimieren. Dazu wird die Automation erweitert und die Trigger Data verwendet, um den dargestellten Text des Bitcoin Kurse einzufärben. Steigt der Kurs, gegenüber dem zuletzt gelieferten Ausgangswert, wird der Text grün dargestellt. Fällt der Kurs, wird er in roter Textfarbe ausgegeben. Ist der Wert gleichbleibend erfolgt eine Ausgabe in Gelb:

Zur Einfärbung des Texts muss die State Trigger Data herangezogen werden, die zwei Variablen namens trigger.from_state und trigger.to_state bereitstellt:

Automation anpassen

Die Farbausgabe auf dem Display wird über den Payload Key color definiert. Zuvor muss jedoch ermittelt werden, ob der letzte gelieferte Wert des Sensors sensor.exchange_rate_1_btc größer oder kleiner ist als der aktuelle Wert:

alias: notify_pixelclock_bitcoin
trigger:
  - trigger: state
    entity_id: sensor.exchange_rate_1_btc
action:
  - action: mqtt.publish
    data:
      qos: 2
      retain: true
      topic: pixelclock/custom/bitcoin
      payload: >-
        {
          "text": "{{ states('sensor.exchange_rate_1_btc') | round(0) }}",
          "icon": "bitcoin",
          "color":  {% if is_number(trigger.from_state.state) and (float(trigger.to_state.state,default=0) > float(trigger.from_state.state,default=0)) %}
                      "#006400"
                    {% elif is_number(trigger.from_state.state) and (float(trigger.to_state.state,default=0) < float(trigger.from_state.state,default=0)) %}
                      "#FF0000"
                    {% else %}
                      "#FFCC00"
                    {% endif %}
        }

Handelt es sich beim aktuellen Sensorwert um einen numerischen Wert (is_number()) und ist dieser größer als der vorherige Wert wird der Text nun in Grün ausgegeben:

Fällt der aktuelle Kurs, wird der Text Rot ausgegeben:

Im Falle eines gleichbleibenden Werts, wird der Text in gelber Farbe ausgegeben.

Mein Neffe ist ein waschechter Pufferküsser mit einer ausgeprägten Begeisterung für Züge, insbesondere für alte Dampflokomotiven. Da er regelmäßig sämtliche Bildschirme einnimmt, um Videos von Schienen­fahrzeugen zu konsumieren, habe ich mich ans Werk gesetzt und ihm ein kleines feines Gerät gebaut, mit dem er diese eigenständig schauen kann.

Initialer Funke für den Eigenbau war ein Video des Youtube Kanals thelastoutpostworkshop, das mir zufällig über den Weg lief. In diesem Video wird eindrucksvoll demonstriert, was ein kleiner ESP32-Microcontroller, in der Größe einer Briefmarke, in Puncto Videowiedergabe alles zu leisten vermag:

Endprodukt meines Eigenbaus ist der LocoTV, ein kleiner Handheld im Hoch­kant­format, mit einem gedrucktem Gehäuse, einer Batterie und Ladeelektronik:

Hardware

Zentrale Rolle in diesem Projekt spielt das Cheap Yellow Display, kurz auch CYD genannt. Der Name ist etwas sonderbar, beschreibt aber anschaulich, worum es sich hierbei handelt: Es ist eine kompakte Displayplatine mit einer Auflösung von 320x240 Pixeln und Touch-Funktionalität mit diversen Zusatzkomponenten, bspw. einem Helligkeitssensor, einer LED und einem Micro SD-Kartenleser. Die Platine kommt in gelber Farbe daher, besitzt einen SD-Card Slot und ist unter 10 € zu erwerben. Cheap! Angetrieben wird es durch einen ESP32 Microcontroller.

Das Display ist in unzähligen Varianten erhältlich, die sich hauptsächlich in den Anschlüssen der Stromversorgung (Micro USB vs. USB-C), SPI-Taktung, aber auch in der eingesetzten Variante des ESP32 unterscheiden. Ich nutze für dieses Projekt die Version 2.0 des CYD mit USB-C Anschluss.

Die Materialkosten für die Hardware belaufen sich mit Versand auf ca. 30 €:

Software

Wie bereits in der Einführung erwähnt, stammt der Code vom Autoren thelastoutpostworkshop. Das Repository esp32-2432S028_video_player ist bei Github verfügbar. Als Codebase für meinen Eigenbau habe ich jedoch den Fork cyd-video-player verwendet, da dieser Support für den Touchscreen ergänzt. Dies ermöglicht, mit einem kindgerechten Touch auf das Display, das nächste Video abzuspielen.

Alle meine Anpassungen sind im Repository schneekluth/locotv verfügbar:

schneekluth/locotv

A children’s video player based on the Cheap Yellow Display.

C++

0

0

Die benötigten Schritte zum Bezug der Software:

1. Den Code als ZIP Datei herunterladen und entpacken.
2. Den Ordnernamen von locotv-main in locotv umbenenen.
3. Ein Doppelklick auf die Datei locotv.ino öffnet die Arduino IDE.

SD Karte vorbereiten

Im ersten Schritt muss die SD-Karte im FAT32-Dateisystem formatiert werden:

Anschließend in den heruntergeladenen Ordner locotv/ ins Verzeichnis SD Content/ wechseln. Darin befindet sich ein Ordner mjpeg mit Beispielvideos. Dieser Ordner muss auf die SD-Karte kopiert werden:

Die SD-Karte ist damit einsatzbereit und kann in den SD-Kartenleser vom Cheap Yellow Display gesteckt werden.

Das Cheap Yellow Display kann nun per USB mit dem Computer verbunden werden. Ab Werk begrüßt das Display den Nutzer mit einer Demo-Anwendung, mit der auch der Touchscreen ausprobiert werden kann.

Arduino IDE

Programmiert habe ich das Displayboard mit der Arduino IDE in Version 2.3.5. Dazu muss, sofern nicht bereits erfolgt, als erstes der ESP32 in der Arduino IDE als Board hinterlegt werden.

Dazu die Einstellungen der IDE mit CTRL+, aufrufen und auf den Button hinter dem Eingabefeld mit der Bezeichnung Additional board manager URLs klicken:

In das sich öffnende Textfeld muss die folgende URL eingetragen und anschließend mit OK bestätigt werden:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

Der ESP32 ist nun in allen gängigen Varianten mit der Arduino IDE nutzbar und steht im Board Manager zur Verfügung.

Board konfigurieren

Um den ESP32 als Board zuweisen zu können, muss zuerst der Board Manager unter Tools > Board > Board Manager… aufgerufen werden. Ins Suchfeld den Begriff esp32 eingeben und anschließen im Dropdown Menü die Version 3.2.0 auswählen und installieren:

Weiterführend muss als Microcontroller der Eintrag ESP32 Dev Module ausgewählt und der korrekte Port des USB-Anschluss zugewiesen werden:

Anschließend muss nur noch unter Tools > Upload Speed die Baudrate auf den Wert 115200 gesetzt werden und schon ist das Board programmierbereit.

Libraries installieren

Folgende Libraries müssen in den expliziten Version verwendet werden. Dazu, analog wie im Board Manager, in der Arduino IDE die jeweiligen Versionen im Library Manager unter Tools > Manage Libraries suchen und installieren:

Zusätzlich liegt in dem heruntergeladenen Ordner noch eine lokale Bibliothek TFT_Touch_v0.3.zip für die Touchscreen-Unterstützung bei. Diese muss in der Arduino IDE importiert werden. Dazu unter Sketch > Include Library > Import .ZIP Library… klicken und die Datei TFT_Touch_v0.3.zip auswählen.

Code Upload

Die Datei locotv.ino kann aus der Arduino IDE mit dem Shortcut CTRL+U kompiliert und auf das Cheap Yellow Display geladen werden:

Treten beim Kompilieren keine Fehler auf, sollten nach dem Upload die zuvor auf die SD-Karte kopierten Beispielvideos auf dem Display erscheinen. Durch berühren des Displays wird zum nächsten Video gewechselt.

Code Anpassungen

Das Cheap Yellow Display existiert in zigfachen Ausführungen, die sich nicht immer gleich verhalten. Ich habe für meine Version und mein Vorhaben insgesamt drei Änderungen am Code vorgenommen:

1. Die Farben des Displays invertieren:

   vorher

   gfx->fillScreen(RGB565_BLACK);
   // gfx->invertDisplay(true); // on some cheap yellow models, display must be inverted
   Serial.printf("Screeen size Width=%d,Height=%d\n", gfx->width(), gfx->height());

   nachher

   gfx->fillScreen(RGB565_BLACK);
   gfx->invertDisplay(true); // on some cheap yellow models, display must be inverted
   Serial.printf("Screeen size Width=%d,Height=%d\n", gfx->width(), gfx->height());

2. Zusätzlich muss für meine gewählte Einbaurichtung im Gehäuse der Portraitmodus des Displays gespiegelt werden, indem die Werte setRotation() und touch.setRotation() angepasst werden:

   vorher

   gfx->setRotation(0);
   touch.setRotation(0);

   nachher

   gfx->setRotation(2);
   touch.setRotation(2);

3. Das Display mit 80 Mhz statt 40 Mhz Taktung per SPI betreiben:

   vorher

   // Some model of cheap Yellow display works only at 40Mhz
   //#define DISPLAY_SPI_SPEED 80000000L // 80MHz
   #define DISPLAY_SPI_SPEED 40000000L // 40MHz
   

   nachher

   // Some model of cheap Yellow display works only at 40Mhz
   #define DISPLAY_SPI_SPEED 80000000L // 80MHz
   //#define DISPLAY_SPI_SPEED 40000000L // 40MHz
   

Eigene Videos erstellen

Ideale Quelle für Videos von Lokomotiven sind YouTube Shorts. Diese sind, dem spinösen Zeitgeist verschuldet, im Hochkantformat vorhanden und somit optimales Ausgangsmaterial, wenn das Display in dieser Ausrichtung betrieben wird.

Im Folgenden gilt es Videos herunterzuladen und ins Motion Jpeg Format Format zu konvertieren. Das Format MJPEG wird gewählt, da der ESP32 hardwareseitig die Funktion besitzt JPEG-Dateien zu Encoden und Decoden.

Für den Download und die Konvertierung der Videos nutze ich zwei Kommandozeilen-Tools:

• yt-dlp: Zum Herunterladen der Videos
• ffmpeg: Zum Konvertieren der Videos

Beide Tools können unter Windows 11 einfach über die Paketverwaltung winget installiert werden. Dazu das Terminal öffnen und den Einzeiler eintippen:

winget install yt-dlp.yt-dlp Gyan.FFmpeg

Nach der Installation muss das Terminal geschlossen und erneut geöffnet werden.

Einzelkonvertierung

Als Beispiel für die einzelne Konvertierung eines Videos dient dieser Short. Seine URL lautet: https://www.youtube.com/shorts/cKKkR6O_jYQ.

Zum Herunterladen kann nun yt-dlp im Terminal verwendet werden:

cd ~\Desktop
yt-dlp "https://www.youtube.com/shorts/cKKkR6O_jYQ" -o test

Und schon befindet sich das Video mit dem Dateinamen test.webm auf dem Desktop.

Zur Konvertierung sind im Repository des ursprünglichen Autoren diverse ffmpeg Kommandos gelistet. Diese skalieren Videos jedoch nur auf die benötigte Bildschirmauflösung von 320x240 Pixel. Dies ist ein Problem, da YouTube Shorts in der Regel hochkant im Format 16:9 aufgenommen werden. Das Display besitzt jedoch ein Bildschirmverhältnis von 4:3. Ich habe das Kommando angepasst, dass mit ffmpeg im ersten Schritt ein Zoom in das Video und anschließend ein Zuschnitt auf die 320x240 Pixel erfolgt. Somit gehen in der Höhe zwar Teile des Videos verloren, jedoch entstehen so keine schwarzen Balken auf der linken und rechten Seite neben dem Video.

Das folgende optimierte Kommando wird zur Konvertierung der heruntergeladenen Datei test.webm in das mjpeg Format verwendet:

cd ~\Desktop
ffmpeg -y -i .\test.webm -pix_fmt yuvj420p -q:v 7 -vf "fps=24,crop=in_w:in_w*4/3:0:(in_h-in_w*4/3)/2,scale=240:-1:flags=lanczos" test.mjpeg

Die generierte Datei test.mjpeg liegt ebenfalls auf dem Desktop und kann so direkt auf die SD-Karte kopiert und auf dem Display abgespielt werden.

Batchkonvertierung

Da das einzelne Herunterladen und Konvertieren mühsam ist, macht es Sinn dies im Batch zu erledigen. Dazu in das Verzeichnis locotv/script wechseln. Darin liegen zwei Dateien:

./locotv/script
  ├── 00_convert.ps1
  └── 00_videos.txt

In der Datei 00_videos.txt können nun zeilenweise Links zu YouTube Shorts mit einem Texteditor hinterlegt werden:

https://www.youtube.com/shorts/cKKkR6O_jYQ
https://www.youtube.com/shorts/S3O2S8ZE8ec
https://www.youtube.com/shorts/-1p6VCfEhfw
https://www.youtube.com/shorts/lFymosFJC1c
https://www.youtube.com/shorts/QhkMK151dy8
https://www.youtube.com/shorts/X2mo7eP74u4
https://www.youtube.com/shorts/tXyq57_Cvc0
https://www.youtube.com/shorts/Q2YHydMnHRQ
https://www.youtube.com/shorts/hI4E1KZAd84
https://www.youtube.com/shorts/Ou3pGGidRgM
https://www.youtube.com/shorts/nM4f9Vzdo4Y
https://www.youtube.com/shorts/6WNYhWgIdS4
https://www.youtube.com/shorts/ewbTSRsFC-0
https://www.youtube.com/shorts/af9Om_3LcQk
https://www.youtube.com/shorts/mKP9dpXhcx0
https://www.youtube.com/shorts/tfQvw7QjGa8

Die Datei 00_convert.ps1 enthält den Code für die Konvertierung der Videos ins MJPEG-Format. Es liest zeilenweise den Inhalt der Datei 00_videos.txt ein, lädt die darin hinterlegten Videos herunter, konvertiert sie und löscht die Ursprungsdateien.

In diesem Ordner einen Rechtsklick machen und den Eintrag In Terminal öffnen auswählen:

Anschließend kann das Skript über diesen Befehl gestartet werden:

.\00_convert.ps1

Das Skript 00_convert.ps1 macht im Detail folgendes in dieser Reihenfolge:

• Erstellt einen Ordner locotv/script/mjpeg.
• Lädt sämtliche Videos aus der Datei 00_videos.txt in den Ordner locotv/script/ herunter.
• Prüft mit ffprobe, ob das Video im Hochkant- oder Querformat aufgenommen wurde.
• Konvertiert das Video in MJPEG-Format. Für Hochkant- und Querformate werden unterschiedliche ffmpeg Kommandos angewandt, um keine schwarzen Balken in den Videos vorzufinden.
• Die konvertierten Dateien werden im Ordner locotv/script/mjpeg abgelegt. Ein Dateinamenpräfix portrait_ (Hochkantformat) und landscape_ (Querformat) wird angewandt.
• Die Ursprungsvideos werden gelöscht. Lediglich die konvertierten Videos bleiben erhalten.

Wer nicht regelmäßig mit PowerShell auf dem eigenen Computer arbeitet, muss in der Regel noch die notwendigen Rechte zur Ausführung von Skripten setzen:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

MAX_FILES anpassen

Der Arduino Code in der Datei locotv.ino hat per Default einen Counter, der nach jedem abgespielten Video um das Inkrement 1 erhöht wird. Die maximale Anzahl an abzuspielenden Videodateien ist leider hardgecoded und wird nicht dynamisch ermittelt. Standardmäßig steht der Wert bei 20 Dateien. Hat man mehr als 20 Dateien werden also trotzdem nur die ersten 20 Dateien abgespielt. Der Wert sollte also, gemäß der vorhandenen Anzahl an Videodateien auf der SD-Karte, angepasst werden:

#define MAX_FILES 20 // Maximum number of files, adjust as needed

Das vorgestellte PowerShell Skript zur Batch-Konvertierung mehrerer Videos ermittelt die Anzahl der Dateien und gibt diesen Wert, nach dem Konvertierungsvorgang, im Terminal aus:

Wichtig: Eine Anpassung des Codes erfordert stets auch einen neues Kompilieren und einen erneuten Upload über die Arduino IDE.

Gehäuse drucken

UPDATE 12.02.26:
Das Gehäuse wurde optimiert. Die SD-Karte kann nun ohne Auseinanderschrauben entnommen und neu mit Videomaterial bestückt werden. Gleichzeitig gibt es nun ein kleines Sichtloch, um den aktuellen Ladezustand des TP 4056 Batterielademoduls anzuzeigen:

• LED leuchtet ROT = Batterie lädt
• LED leuchtet GRÜN = Batterie geladen

Ich habe in Autodesk Inventor ein simples Gehäuse, bestehend aus Ober- und Unterseite, entworfen. Die Gehäusehälften werden mittels Schrauben und passender Hülsenmuttern zusammengehalten. Die ermöglicht ein zukünftiges verschleißfreies Auseinanderbauen.

In der Unterseite finden Batteriehaltertung, Ladeelektronik und der Spannungs­wandler platz. In der oberen Gehäusehälfte sind das Display und der Ein-Aus-Schalter verbaut. Aussparungen für die SD-Karte und den USB-C Anschluss zum Laden der Batterie sind enthalten.

Verwendet wird das gröbste Druckprofil Draft im Cura Slicer mit einer Druckstärke von 0,3 mm auf meinem in die Jahre gekommenen Anycubic i3 Mega.

Die STL-Dateien der Gehäusehälften sind im Ordner locotv/stl zum Nachdrucken vorhanden.

Spannungswandler einstellen

Für diesen Schritt wird ein Multimeter benötigt. Als Vorbereitung für den Zusammenbau muss vorerst der Spannungswandler so eingestellt werden, dass bei 3,7 V Eingangsspannung eine Ausgangsspannung von 5 V erreicht wird, die das Display für seinen Betrieb erfordert. Dazu wird die Justierschraube auf dem MT3608 verwendet. Videos dazu gibt es im Weltnetz zu Hauf:

Die 18650er-Batterie in das Batteriegehäuse stecken, das rote Kabel an den VIN+ und das schwarze Kabel an den VIN- Kontakt anschließen. Das kann mit Krokodilsklemmen, geschickter Positionierung oder über ein temporäres Löten erfolgen. Anschließend das Multimeter auf Gleichstrommessung stellen und analog das rote Kabel des Multimeters an VOUT+ und das schwarze an VOUT- halten. Nun muss die Justierschraube des MT3608 so eingestellt werden, dass 5 V Ausgangs­spannung auf dem Multimeter angezeigt wird:

Verdrahtung

Zusammenbau

Für den Zusammenbau des Gehäuses und der Verdrahtung der elektronischen Bauteile werden, neben Lötkolben und Kabelage, folgende Bauteile benötigt:

Gehäuseoberseite

Im ersten Schritt wird das Display mit den M2x5 Schrauben befestigt. Es empfiehlt sich die Schrauben vorher ohne Display vorsichtig in die dafür vorgesehenen Löcher zu schrauben, um das Gewinde im PLA zu formen. Dabei immer wieder vor- und zurückschrauben, bis die benötigte Tiefe erreicht ist.

Im zweiten Schritt muss der JST-Connector auf einer Seite, direkt hinter dem Stecker, mit einem Seitenschneider abgetrennt werden. Von den vier verfügbaren Pins werden nur die beiden Äußeren in den Farben Rot und Grün verwendet. Die Mittleren können ebenfalls abgetrennt werden:

Der JST-Connector kann nun an dem vorhandenen Anschluss am Displayboard gesteckt werden.

Als finaler Schritt wird der Power Button eingesetzt. Den Feststellring habe ich aus Platzgründen entfallen lassen, da der Button auch ohne ihn gut fixiert platziert war. Theoretisch ist der Platz aber vorhanden, falls er beim Nachbau platziert werden muss.

Die Oberseite ist damit fertig bestückt und Einsatzbereit.

Gehäuseunterseite

Die Gehäuseunterseite ist anspruchsvoller. Ich habe zuerst alle Komponenten darin platziert und dann die Kabellängen markiert und zugeschnitten. Danach habe ich alle Bauteile wieder herausgeholt und zuerst alle Bauteile verlötet, die in der Unterseite platziert werden. Danach legt/stellt man die Vorderseite so nah es geht daneben und lässt für diese die Kabel länger, damit die Verbindungen nicht reißen, wenn das Gehäuse mal geöffnet werden muss:

Batterielademodul, Spannungswandler und die Batteriehalterung habe ich anschließend mit Heißkleber in der unteren Gehäusehälfte fixiert:

Hochzeit

Nachdem beide Gehäusehälften montiert und verdrahtet sind, können sie zusammengefügt werden. Dabei darauf achten, dass die Kabel nicht zu sehr unter Spannung sind oder Schaden beim Schließvorgang nehmen.

Die beiden Gehäusehälften werden durch Hülsenmuttern und Schrauben der Gewindegröße M4 zusammengehalten. Das hat den Vorteil, dass nicht selber ins Druckmaterial geschraubt werden muss und eine zukünftige verschleißfreie Öffnung des Gehäuse gegeben ist. Hülsen- und Schraubenlänge kann variiert werden, solange die errechnete ideale Klemmweite von 34,2 mm erreicht wird:

Für meinen Eigenbau habe ich eine M4x18 Tellerkopfschraube und eine Hülsenmutter mit M4 Innengewinde einer Länge von 25 mm verwendet. Diese stammen aus einem IKEA Pax Schrank und haben bei IKEA die Teilenummern 100644 und 100402:

Resultat

Das Ergebnis ist ein kleines, neckische, portables Brikett, das auch in der Zukunft mit Videomaterial aller Art bespielt werden kann. Es dient nur dem Zweck der Video­wiedergabe, hat keine nervige Sound-Ausgabe und der abgespielte Content liegt zu 100% in eigener Hand:

Betätigt man den Power-Button, rastet dieser ein, der LED-Ring des Buttons beginnt zu leuchten und ca. eine Sekunde später beginnt die Videowiedergabe:

Ist die Batterie einmal leer gesaugt, kann sie mit einem handelsüblichen USB-C Ladegerät wieder aufgeladen werden.

Neue Videos hinterlegen

Es wird notgedrungen immer wieder zu der Situation kommen, dass neue Videos auf der SD-Karte hinterlegt werden müssen. Da das CYD in zig Varianten existiert, ist der sicherste weg den JST-Connector, vor einem erneuten Code Upload zu trennen, bevor der USB-C anschluss mit dem Computer verbunden wird, um Voltage Backfeeding zu vermeiden.

Generell empfiehlt es sich den Wert für MAX_FILES relativ hoch, bspw. 300 anzusetzen, da so nur kein neuer Code Upload erfoderlich ist, wenn die reale anzahl der gespeicherten Video den Wert in der Variable MAX_FILES überschreitet.

Einbindung über Phoscon App

Der Rauchmelder kann über die deCONZ Integration eingebunden und muss zuvor über die Phoscon App verbunden werden. Wie bereits in allen anderen Beiträgen zum Thema Zigbee Geräte nutze ich dafür das offizielle deCONZ Add-On.

Der Pairing Mode des Rauchmelders wird über drei schnelle kurze Klicks auf den einzigen Button des Geräts aktiviert. Anschließend steht der Rauchmelder in der Phoscon App in der Sektion Sensoren zur Verfügung:

Der Rauchmelder erscheint in Homeassistant als Binary Sensor, der detektierten Rauch mit einem State on anzeigt. Zusätzlich sind drei weitere Sensoren vorhanden:

1. Ein Binary Sensor, der einen niedrigen Batteriestand mit dem State on anzeigt.
2. Ein Binary Sensor, der die Ausführung des Test-Modus mit dem State on anzeigt.
3. Ein numerischer Sensor, der den Batteriestand in Prozent anzeigt.

Rauchmelder Gruppe erstellen

Da ein Rauchmelder selten alleine daherkommt, werden alle Geräte in einer Gruppe mittels Group Integration zusammengefasst. Dazu folgenden Eintrag in der group.yaml erstellen und die Namen der Entities entsprechend anpassen:

rauchmelder:
  name: Rauchmelder
  entities:
    - binary_sensor.rauchmelder_flur
    - binary_sensor.rauchmelder_ballsaal
    - binary_sensor.rauchmelder_schlafzimmer

Der Eintrag erzeugt in Homeassistant nun eine Gruppe:

Der Vorteil der Group Integration liegt darin, dass nur einer der Sensoren einen Feueralarm melden muss, um den State der Gruppe auf on zu setzen. Dieser State der Gruppe wird in der nun zu erstellenden Automation genutzt.

Automation für Push-Message

Die folgende Automation erzeugt eine Push-Nachricht, die den Namen des Rauchmelders enthält, der einen Brand/Rauch detektiert hat. Trigger ist der State der anglegten Gruppe. Im Falle eines Brandes werden alle Lichter des Hauses blinkend geschaltet, mittels des Parameters flash: long der Action light.turn_on.

- alias: Feueralarm
  trigger:
    - trigger: state
      entity_id: group.rauchmelder
      to:  'on'
  action:
    - action: notify.mobile_app_iphone
      data:
        title: "🔥 Feueralarm 🔥"
        message: "{{ states | selectattr('entity_id','in', state_attr('group.rauchmelder','entity_id')) | selectattr('state','eq','on') | map(attribute='name') | join(', ') }}"
        data:
          tag: "push_feueralarm"
          channel: Alarm
    - action: light.turn_on
      data:
        entity_id:
          - light.deconz_licht_wohnzimmer
          - light.deconz_licht_flur
          - light.deconz_licht_schlafzimmer
          - light.deconz_licht_ballsaal
        flash: long

Automation Testen

Hält man den Button des Rauchmelders lange gedrückt, wird der Test-Modus aktiviert. Die erzeugte Gruppe wechselt in den State on und die Automation wird getriggert:

Nachricht auf Ulanzi Pixelclock

Wer eine Ulanzi Pixelclock im Eigenheim betreibt, kann zusätzlich auf dieser eine Warnung ausgeben:

    - action: mqtt.publish
      data:
        qos: 2
        retain: false
        payload: >-
          {
            "text": "Feuer!",
            "icon": "fire",
            "hold": true
          }
        topic: pixelclock/notify

Als Icon nutze ich dafür die animierte Flamme mit der Icon ID 7756, die unter dem Dateinamen fire.gif auf der Pixelclock abgespeichert ist:

Home Assistant hat die Konfiguration für Template Sensoren überarbeitet und mich mit haufenweise Warnmeldungen überschüttet. Siehe: Deprecation of legacy template entities in 2025.12

Die Deprecation Warnings betrafen unter Anderem den Post Room Based Presence mit Motion Sensoren, was ich als Anlass genommen habe das Setup neu zu überdenken. Da ich vor kurzem arbeitsfrei geworden bin, ist die Zeit dafür vorhanden.

Vorhaben

Befindet sich im trauten Eigenheim ein Bewegungssensor in jedem Raum, kann man über diese ermitteln, in welchem Raum zuletzt eine Bewegung erkannt wurde. In einem Single-Haushalt entspricht diese Information dem Raum, in dem man sich gerade aufhält. Diese Information kann zielführend genutzt werden, wie bereits im Post Room Based Presence mit Motion Sensoren erläutert wurde.

An meinem aktuellen Setup hat mir nie gefallen, dass ich auf eine zusätzliche Custom Component namens home-assistant-variables angewiesen war. Im Kern war dies immer eine Lösung, die zuverlässig funktioniert hat und mich vor der Auseinandersetzung mit Template Sensoren freigesprochen hat.

Template Sensoren nutzen eine sperrige Syntax aus der Hölle, die durch die Python Template Engine Jinja2 bereitgestellt wird. Im Home Assistant Forum gibt es herausstechende Planetenbürger wie Petro, die diese Syntax mit einer Leichtigkeit beherrschen, als würde man Pfannkuchen backen. Zu diesen Menschen zähle ich jedoch nicht. Nichtsdestotrotz habe ich noch einmal das Forum durchforstet und eine funktionierende Lösung in diesem Thread Quick sensor/template question - Last active motion sensor gefunden.

Aus einer vordefinierten Liste an Bewegungssensoren soll jener ermittelt werden, der als letztes den State on gemeldet hat. Die Bewegungssensoren sind naturgemäß als Binary Sensors in Home Assistant eingebunden, das sie lediglich die States on und off besitzen können. Bewegung wird detektiert oder eben nicht.

Als Beispiel eingesetzter Bewegungsmelder werden folgende Entities und Namen verwendet:

Last Motion Sensor

Der Code des Template Sensors macht folgendes:

• Er definiert die Entity Names der Bewegungssensoren in einer Liste sensors.
• Er ermittelt alle Entities in der Liste sensors, die den State on besitzen und speichert diese als eine Liste.
• Wenn mehr als ein Bewegungssensor in dieser Liste den State on besitzt, wird der Name des zuletzt getriggerten Sensors zurückgegeben.
• Für meinen persönlichen Fall habe ich noch einen regex_replace() gesetzt, der mir den Präfix Hue Motion aus dem Rückgabewert entfernt. Somit bleibt lediglich der Raumname über, bspw. Hue Motion Flur wird reduziert auf Flur.
• Für jeden Raum wird ein Custom Icon definiert, das sich dynamisch anpasst, je nachdem wo zuletzt eine Bewegung registriert wurde.

template:
  - sensor:
      - name: last_motion
        state: >
          {%- set sensors = 'binary_sensor.hue_motion_flur', 'binary_sensor.hue_motion_kueche', 'binary_sensor.hue_motion_schlafzimmer', 'binary_sensor.hue_motion_wohnzimmer' %}
          {% set sensors_on = expand(sensors) | selectattr('state', 'eq', 'on') | map(attribute='name') | list %}
          {% if sensors_on | count > 0 %}
            {{ expand(sensors) | selectattr('state', 'eq', 'on') | sort(reverse=true, attribute="last_changed") | map(attribute='name') | list | first | default(none) | regex_replace(find='Hue Motion ', replace='') }}
          {% else %}
            {{ expand(sensors) | sort(reverse=true, attribute="last_changed") | map(attribute='name') | list | first | default(none) | regex_replace(find='Hue Motion ', replace='') }}
          {% endif %}
        icon: >
          {% if is_state('sensor.last_motion', 'Küche') %}
            mdi:food-variant
          {% elif is_state('sensor.last_motion', 'Wohnzimmer') %}
            mdi:sofa
          {% elif is_state('sensor.last_motion', 'Flur') %}
            mdi:cube-unfolded
          {% elif is_state('sensor.last_motion', 'Schlafzimmer') %}
            mdi:bed
          {% else %}
            mdi:account-question
          {% endif %}

Der Sensor ersetzt nahtlos das alte Setup, reduziert unnötige Komplexität und liefert identische Rückgabewerte, wie die alte Lösung mittels home-assistant-variables:

Er kann für viele Automationen genutzt werden, bspw. wenn ein Media-Player bei aktiver Wiedergabe pausiert werden soll, wenn man den Raum verlässt oder aber, wenn das Licht in einem Raum nicht ausgeschaltet werden soll, wenn man sich darin aufhält.

Ich habe diesen Monat unerwartet meinen Job als Konstrukteur und CAD Power User verloren und werde mich beruflich neu umschauen müssen.

Derzeit habe ich nur noch eingeschränkten Zugriff auf Autodesk Vault und Inventor, was ich selber schwer bedauere, da ich eine komplette Serie zum Umgang der Vault API mittels PowerShell und der neuen spannenden Vault Data API in der Mache hatte. Dies kann und wird nun nicht mehr stattfinden können.

Ob ich einen neuen Arbeitgeber finde, der Autodesk Produkte produktiv einsetzt, ist für mich derzeit nicht absehbar. Primär gilt es für mich beruflich nach Vorne zu schauen. Zeitgleich lohnt aber auch ein Rückblick auf die existierenden 25 Beiträge der iLogic Artikelserie, die über die letzten 3 Jahre entstanden sind, denn sie vermitteln gutes Basiswissen für Anfänger und auch Anwendungsfälle, die weit über iLogic Funktionalitäten hinausgehen.

Wie kam es zu der Serie?

Ich habe damals in meiner Firma nicht aktiv darum gebeten die iLogics zu schreiben und zu betreuen, sondern bin notgedrungen in diese Rolle geraten. Ursprünglich wurde der Code durch den Administrator der Vault Datenbank geschrieben und auch per Vault Startroutine an die User ausgerollt.

Es stellte sich bedauerlicherweise zunehmend heraus, dass der Administrator weder die Fähigkeiten, noch den erforderlichen Willen besaß, sich in das Thema iLogic hineinzudenken, geschweige denn die persönliche Größe, diesen Zustand offen zuzugeben und Verantwortung für seinen Code zu übernehmen.

Das Resultat waren:

• unzählige tagesaktuelle Fehlermeldungen, die bei mir als CAD Power User aufliefen, und kontinuierlichen User Support hervorriefen
• iLogics, die sich selber widersprachen und gegeneinander arbeiteten, da konzeptfrei, strukturlos und tagesaktuell ohne Versionshistorie gearbeitet wurde
• iLogics, die unzählige unnötige Revisionen erforderten, da sie automatisiert fehlerhafte Produktdaten erzeugten, die anschließend in die Freigabe gingen
• iLogics, die kontinuierlich on the fly modifiziert wurden, ohne die Nutzer oder mich in Kenntnis zu setzen

Über zwei Jahre hinweg blieb jede Verbesserung der Situation aus. Ich nahm mich der Thematik an, weil es sonst keiner getan hätte und weil es mir zunehmend zutiefst zuwider war, tagesaktuellen Support für Fehlmeldungen zu leisten, die ich selber nicht produziert hatte.

Im Ingenieursstudium hatte ich zwei Semester VBA-Programmierung mit Excel. Einen realen Anwendungsfall habe ich dafür im Berufsleben nie gefunden. Daher war die Auseinandersetzung mit dem Thema iLogic eine willkommene Abwechslung zum Alltag als Konstrukteur, da die Thematik Realbezug aufwies und iLogic Schnittmengen mit VBA besitzt.

Farewell

Rückwirkend betrachtet bedeutet mir die Serie viel, da sie für mich selber eine kleine chronologische Dokumentation meines beruflichen Schaffens darstellt und zeitgleich Zeuge meiner persönlichen Lernkurve ist. Nahezu alle Beiträge waren inspiriert durch tagesaktuelle Probleme oder Hürden, die es zu meistern galt. Ich habe diverse Mails anderer Konstrukteure erhalten, die sich ebenfalls an iLogic versucht haben und fand den Gedanken immer schön, dass meine Serie auch anklang in der Welt gefunden hat.

An dieser Stelle möchte ich auch jeden Konstrukteur ermutigen, sich offen dem Thema iLogic zu stellen, denn es ist ein mächtiges Werkzeug, das Zeitersparnis produzieren kann und zeitgleich lernt man die Funktionsweise von Inventor aus Sicht der Programmierschnittstelle kennen. Die Schnittstelle zwischen Engineering und Programmierung ist ein spannendes Themenfeld, das in vielen Unternehmen bis heute noch nicht ausreichend wertgeschätzt, und in Zukunft zunehmend an Bedeutung gewinnen wird.

Sollte ich in Zukunft erneut beruflich mit Inventor arbeiten, werde ich die Serie ggf. fortsetzen. Bis dahin bleibt jedoch nur eins zu sagen: “Adieu iLogic!”

Die Ausgabeformate sind in Teilen jedoch abhängig von global gesetzten Region Settings im Betriebssystem und unterliegen auch kulturellen Gepflogenheiten. So kennt jeder die amerikanischen Unsitten ein Datum im Format MM-DD-YYYY anzugeben und auch sonst alles zu geben, um nicht mit dem metrischen System in Kontakt zu kommen:

iLogic Snippets

Die eingebauten Snippets können einfach über den iLogic Logger getestet werden und liefern ohne zusätzliche Parameter folgende Ausgaben:

Dim sNow As String = Now()
Dim sDate As String = DateString
Dim sTime As String = TimeString

Logger.Info("'Now()' liefert: {0}", sNow)
Logger.Info("'DateString' liefert: {0}", sDate)
Logger.Info("'TimeString' liefert: {0}", sTime)

Resultat:

Ausgabe Formatieren

Zur Formatierung der Zeitangaben stehen sämtliche Methoden des DateTime Namespace zur Verfügung. Am geläufigsten unter iLogic Code-Beispielen im Inventor Forum ist die Methode DateTime.ToString. Mit ihr können die Ausgaben leicht mittels Date & Time Format Specifiers den eigenen Ansprüchen angepasst werden:

Now.ToString("dd.MM.yyyy")        ' 23.05.2025
Now.ToString("MMMM d, yyyy")      ' May 23, 2025
Now.ToString("dddd, MMMM dd")     ' Friday, May 23
Now.ToString("yyyy-MM-dd HH:mm")  ' 2025-05-23 14:30

Auch stehen die Methoden ToLongDateString, ToShortDateString, ToShortTimeString und ToLongTimeString zur Verfügung:

Logger.Info(Now.ToShortTimeString)  ' 16:02
Logger.Info(Now.ToLongTimeString)   ' 16:02:39
Logger.Info(Now.ToShortDateString)  ' 23.05.2025
Logger.Info(Now.ToLongDateString)   ' 14. Mai 2025

Das Problem beider Beispiele wird schnell ersichtlich, denn sie wurden auf zwei unterschiedlich konfigurierten Computern ausgeführt und berücksichtigen die Region Settings des Betriebssystems:

Monatsangaben erscheinen bspw. einmal auf Englisch (May) und im zweiten Beispiel auf Deutsch (Mai). Dies kann zu Problemen in internationalen Unternehmen führen, da die gewohnten Ausgabeformate für Zeit- und Datumsangaben kulturell variieren und der gemeine Nutzer sein Betriebssystem in der eigenen Landessprache betreibt.

Möchte man ungeachtet der Region Settings immer ein einheitliches Ausgabeformat erzwingen, muss zusätzlich die CultureInfo Class aus dem System.Globalization Namespace hinzugezogen werden.

Das folgende Beispiel formatiert die Ausgaben gemäß amerikanischer Notation (en-US):

Imports System.Globalization

' Beispieldatum: 28.05.2024
Dim dDate As Date = New Date(2024, 05, 28)

Dim culture As CultureInfo = CultureInfo.GetCultureInfo("en-US")

Dim sDateWithoutCulture As String = dDate.ToString("MMMM d, yyyy")
Dim sDateCulture As String = dDate.ToString("MMMM d, yyyy", culture)

Logger.Info("Ohne Culture Info: {0}", sDateWithoutCulture)
Logger.Info("Mit Culture Info: {0}", sDateCulture)

Resultat:

Zeitdifferenzen berechnen

Zeitdifferenzen können ebenfalls einfach berechnet werden. Das folgende Beispiel ermittelt die vergangenen Tage zwischen den Daten 05.10.2025 und 14.11.2025:

Dim dStartDate As Date = New Date(2025, 10, 05)
Dim dEndDate As Date = New Date(2025, 11, 14)

Dim iDaysDifference As Integer = (dEndDate - dStartDate).Days

Logger.Info("Differenz: {0} Tage", iDaysDifference)

Resultat:

Zeiten Stoppen

Man kann zusätzlich mit der StopWatch Class die Zeit messen, die für die Ausführung einer iLogic benötigt wird. Das kann sinnvoll sein, wenn man unterschiedliche Lösungsansätze für ein Problem gegeneinander auf Performance testen möchte.

Das folgende Beispiel ermittelt, wie lang eine Schleife mit dem Startwert 1, dem Endwert 5, einem Inkrement von 1 und einem künstlichem Delay von 500 ms mittels Thread.Sleep Method zur Ausführung benötigt.

Dim sw As New Stopwatch()
sw.Start()

For i As Integer = 1 To 5 Step 1
    Logger.Info("Schleife {0}", i)
    Threading.Thread.Sleep(500)
Next

sw.Stop()
Logger.Info("Elapsed Time: " & sw.ElapsedMilliseconds & " ms")

Resultat:

Als Beispiel dient eine in Inventor geöffnete Datei mit dem Namen LST_Bender.ipt. Anhand dieser Datei werden die beiden unterschiedlichen Herangehensweisen erläutert.

iLogic Snippets

iLogic stellt vordefinierte Snippets bereit, die den Umgang mit Dateien und Pfaden spielerisch leicht gestalten. Die Snippets sind in der Dokumentation in der Sektion Document Functions Reference gelistet. Zur Verfügung stehen:

Die zurückgelieferten Werte können einfach im iLogic Logger betrachtet werden:

Logger.Info(ThisDoc.FileName(False))
Logger.Info(ThisDoc.FileName(True))
Logger.Info(ThisDoc.Path)
Logger.Info(ThisDoc.PathAndFileName(False))
Logger.Info(ThisDoc.PathAndFileName(True))

Das Resultat:

System.IO.Path

Die eingebauten iLogic Snippets können in VB.NET auch identisch über die Klasse System.IO.Path ermittelt werden. Die Klasse bietet zusätzlich noch deutlich mehr Funktionen, bspw. das erfragen der Dateiendung.

Genutzt wird das Property FullFileName, das letzten Endes dem iLogic Snippet ThisDoc.PathAndFileName(True) entspricht und eine absolute Pfadangabe als String liefert:

Der folgende Code liefert den identischen Logger Output, wie im Beispiel der iLogic Snippets:

Dim sFullFileName As String = ThisDoc.Document.FullFileName

Logger.Info(System.IO.Path.GetFileNameWithoutExtension(sFullFileName))
Logger.Info(System.IO.Path.GetFileName(sFullFileName))
Logger.Info(System.IO.Path.GetDirectoryName(sFullFileName))
Logger.Info(System.IO.Path.Combine(System.IO.Path.GetDirectoryName(sFullFileName), System.IO.Path.GetFileNameWithoutExtension(sFullFileName)))
Logger.Info(System.IO.Path.GetFullPath(sFullFileName))

Für das iLogic Snippet ThisDoc.PathAndFileName(False) steht keine native VB.NET-Methode zur Verfügung. Das gewünschte Ergebnis kann aber mittel der Methode Path.Combine erzielt werden.

Anwendungsfall

Ein naheliegender Anwendungsfall in größeren Baugruppen ist die Prüfung, ob alle verbauten Komponenten in den korrekten Ablagepfaden - bspw. der Ordnerstruktur in Vault - abgelegt sind. Da die Pfadangaben Strings sind, kann einfach mit der Methode String.Contains geprüft werden, ob der gewünschte Ablagepfad identisch mit dem realen Ablagepfad der aktiven Datei ist.

Das folgende Beispiel prüft, ob der FullFileName die Pfadangabe C:\Users\horst\Documents\Inventor\ enthält:

Dim sFullFileName As String = ThisDoc.Document.FullFileName

If sFullFileName.Contains("C:\Users\horst\Documents\Inventor\") Then
    Logger.Info("Der Pfad der Datei '{0}' ist korrekt.", System.IO.Path.GetFileName(sFullFileName))
Else
    Logger.Warn("Der Pfad der Datei '{0}' ist nicht korrekt.", System.IO.Path.GetFileName(sFullFileName))
End If

Eine solche Prüfung kann auch über alle verbauten Komponenten einer Baugruppe erfolgen. Dazu muss die If-Else-Schleife nur auf die AllReferencedDocuments angewendet werden. Mehr zu diesem Thema ist im vorangegangen Post iLogic: Referenzierte Dokumente in Baugruppen zu finden.

Autodesk hat eine ausführliche Hilfeseite, die sich dem Thema widmet und das programmspezifische Wording erläutert: File and Document References

Grundsätzlich wird unterschieden zwischen File Obejects und Document Objects. Ersteres behandelt die referenzierten Komponenten auf Datei- und Arbeitsspeicherebene, zweiteres auf Dokumentenebene. In diesem Post werden die Document Objects genutzt, genauer gesagt die Properties:

• AllReferencedDocuments, die rekursiv Komponenten aller Baugruppenebenen auflistet.
• ReferencedDocuments, die nur die erste Ebene verbauter Komponenten auflistet.

Zusätzlich gibt es noch das Konzept der Occurrences, das Inventor unter der Component Definition eines Baugruppendokuments bereit stellt. Die Properties AllReferencedDocuments und ReferencedDocuments liefern immer eine eindeutige Liste mit referenzierten Dokumenten, können aber keine Auskunft darüber geben, wie oft eine Komponente verbaut ist. Dies kann für die erste Baugruppenebene über die Occurrences erfolgen.

Beispielbaugruppe

Für die folgenden drei Code-Beispiele wird die Beispielhafte Baugruppe Nested Assembly.iam mit insgesamt 3 verschachtelten Baugruppenebenen und 7 einzigarten Komponenten verwendet.

Der strukturelle Baugruppenaufbau als Tree Diagram:

Nested Assembly.iam
├── Welded Assembly.iam
│   ├── SheetMetalPart.ipt
│   ├── RevolvedPart.ipt
│   └── Alphabet.iam
│       ├── A.ipt
│       └── B.ipt
├── LST_Bender.ipt
├── LST_Bender.ipt
├── SheetMetalPart.ipt
└── RevolvedPart.ipt

Code-Beispiele

Die folgenden drei Beispiele zeigen sowohl die Methodik mittels AllReferencedDocuments, ReferencedDocuments und Occurrences. Es gilt zu beachten, wie alle drei Methoden eine unterschiedliche Anzahl an referenzierten Dokumenten im Property Count zurückliefern.

Zum besseren Verständnis werden für alle drei Methoden identischer Code demonstriert, der für jedes referenzierte Dokument den Dateinamen im iLogic Logger ausgibt.

AllReferencedDocuments

Diese Methode nutzt das DocumentsEnumerator Object, um über alle referenzierten Dokumente zu iterieren:

Dim oDoc As Document = ThisDoc.Document
Dim oAllRefDocs As DocumentsEnumerator = oDoc.AllReferencedDocuments

For Each oRefDoc As Object In oAllRefDocs
    Dim sFileName As String = System.IO.Path.GetFileName(oRefDoc.FullFileName)
    Logger.Info("Filename: {0}", sFileName)
Next

Es werden alle 7 Dokumente, über alle Baugruppenebenen, in einer Liste mit eindeutigen Werten zurückgeliefert:

Die Methode eignet sich hervorragend, wenn man alle verbauten Komponenten, über alle Baugruppenebenen, auf bestimmte Bedingungen prüfen möchte.

ReferencedDocuments

Diese Methode nutzt ebenfalls das DocumentsEnumerator Object, um über alle referenzierten Dokumente der ersten Baugruppenebene zu iterieren:

Dim oDoc As Document = ThisDoc.Document
Dim oRefDocs As DocumentsEnumerator = oDoc.ReferencedDocuments

For Each oRefDoc As Object In oRefDocs
    Dim sFileName As String = System.IO.Path.GetFileName(oRefDoc.FullFileName)
    Logger.Info("Filename: {0}", sFileName)
Next

Es werden lediglich 4 Dokumente in einer Liste mit eindeutigen Werten zurückgeliefert, die identisch mit den verbauten Komponenten auf der ersten Baugruppenebene ist. Untergeordnete Bauteile und weitere verschachtelte Baugruppen, abseits der ersten Baugruppenebene, werden nicht berücksichtigt:

Occurrences

Occurrences sind, wie bereits erwähnt, ein Sonderfall, da sie keine eindeutige Liste zurückliefern, sondern auch Auskunft über die Anzahl der verbauten Komponenten auf der ersten Baugruppenebene geben können.

Dim oDoc As Document = ThisDoc.Document
Dim oOccurences As ComponentOccurrences = oDoc.ComponentDefinition.Occurrences

For Each oOccurrence As ComponentOccurrence In oOccurences
    Dim sFileName As String = System.IO.Path.GetFileName(oOccurrence.Definition.Document.FullFileName)
    Logger.Info("Filename: {0}", sFileName)
Next

Es werden 5 Dokumente zurückgeliefert, das das Bauteil LST_Bender.ipt auf der ersten Baugruppenebene zweimal platziert wurde:

Anwendungsfall

Möchte man bspw. herausfinden, ob eine der verbauten Komponenten ein bestimmtes Property nicht gepflegt hat, kann man dafür das AllReferencedDocuments Property nutzen. Zum besseren Verständnis von Inventors Property Sets sei an dieser Stelle der Post iLogic: Propertysets empfohlen.

Als Beispiel werden alle Bauteile gelistet, die keinen Eintrag im Project Property Part Number besitzen. Exemplarisch haben alle Dokumente einen gepflegten Wert im Property Part Number bis auf das Bauteil LST_Bender.ipt:

Für die Abfrage werden zwei kombinierte Methoden aus dem Namespace System.String verwendet. IsNullOrWhiteSpace() prüft ob ein Wert vorhanden ist und ob dieser ein Leerzeichen ist und IsNullOrEmpty() prüft ob ein Wert vorhanden ist und dieser gar kein hinterlegtes Zeichen besitzt:

Dim oDoc As Document = ThisDoc.Document
Dim oAllRefDocs As DocumentsEnumerator = oDoc.AllReferencedDocuments

For Each oRefDoc As Object In oAllRefDocs
    Dim sFileName As String = System.IO.Path.GetFileName(oRefDoc.FullFileName)
    Dim sPartNumber As String = oRefDoc.PropertySets.Item("Design Tracking Properties").Item("Part Number").Value

    If (System.String.IsNullOrWhiteSpace(sPartNumber) Or System.String.IsNullOrEmpty(sPartNumber)) Then
        Logger.Info("Filename: {0} hat keinen Eintrag im Property 'Part Number'.", sFileName)
    End If
Next

Resultat:

Dieser Wert kann auch auf Zeichnungen als Textbaustein mittels Physical Properties - Model > MASS genutzt werden:

Der Massenwert, den die API liefert ist trügerisch, denn er stellt nur den letzten Wert dar, der erfolgreich berechnet werden konnte. Wurde bspw. eine Unterkomponente nicht sauber aktualisiert, bescheinigt Inventor dies mit einem Blitz-Icon und liefert in der Application keinen sauberen Massenwert, sondern N/A zurück:

Das Thema wird seit Jahren lang und breit im Inventor-Forum diskutiert und sorgt oftmals für fehlende Masseangaben in Schriftköpfen:

• Doesnt always update Mass on drawing
• Weight/Mass N/A
• Mass property N/A for iAssembly
• Losing Mass property constantly

Autodesk hat dazu ebenfalls ein Support-Dokument veröffentlicht Properties are shown as N/A in Inventor drawing and Vault batch plot und nennt wortkarg folgenden Grund:

Physical properties are not updated in the model and also shown as N/A.

Der Grund liegt, wie bereits erwähnt, in nicht sauber aktualisierten Unterkomponenten. Weist man einer Unterkomponente ein neues Material zu, ändern sich folgerichtig auch die Massenwerte der Komponente. Inventor erfordert nun ein auschecken und eine neue Speicherung der übergeordneten Komponente. Das kann bei kleinen Konstruktionen ein schneller Akt sein, stößt aber bei größeren Designs mit Freigabeprozessen schnell auf langwierige Hürden.

Code Beispiele

Im folgenden sind zwei Methoden aufgelistet, um den Massenwert zu ermitteln, auf drei Nachkommastellen zu runden und in ein Custom Property mit dem Namen Masse zu schreiben. Dieses Property kann dann als dreckiger Workaround bspw. in den Schriftköpfen von Zeichnungen verwendet werden.

iLogic Snippet iProperties.Mass

iLogic hat ein natives Snippet iProperties.Mass, das den Massenwert ermitteln kann. Es hat jedoch einen kritischen Nachteil, denn es liefert den Rückgabewert immer in der Masseneinheit, die in den Document Settings hinterlegt ist:

Möchte man dieses Snippet benutzen, sollte vorher immer sichergestellt sein, dass ein einheitliches Einheitensystem in jedem Bauteil vorhanden ist, um zu verhindern dass Werte mal in Gramm und mal in Kilogramm rausgeschrieben werden. Wie das geht wurde bereits im Post iLogic: Units of Measurement beschrieben. Anschließend kann das Snippet folgendermaßen benutzt werden:

Dim dMass As Double = iProperties.Mass

iProperties.Value("Custom", "Masse") = Round(dMass, 3)

Alternative: Inventor API

Eine alternative Methode besteht darin, dass man den letzten ermittelbaren Wert der Masse über die API ausliest:

Dim oDoc As Document = ThisDoc.Document
Dim UOM As UnitsOfMeasure = oDoc.UnitsOfMeasure
Dim dMass As Double = oDoc.ComponentDefinition.MassProperties.Mass

' Konvertiere Masse in Kilogramm
dMass = UOM.ConvertUnits(dMass, UnitsTypeEnum.kDatabaseMassUnits, UnitsTypeEnum.kKilogramMassUnits)
' Runde Massenwert auf 3 Nachkommastellen
dMass = Round(dMass, 3)

iProperties.Value("Custom", "Masse") = dMass
Logger.Info("Masse: {0} [kg]", dMass)

Der Code liefert verlässlich unabhängig von der Masseneinheit in den Document Settings eine Massenwert in der Einheit kg, der auf drei Nachkommastellen gerundet ist.

Achtung: Sollte die iLogic automatisch mit einem Trigger ausgelöst werden, darf sie nicht einer Zeichnung zugeordnet sein, denn diese haben keinen Massenwert. Alternativ kann man den Code umschreiben und explizit den Dokumententyp abfragen, wie im Post iLogic: Dokumententypen beschrieben.

Die Inventor API nutzt zur Bestimmung ein sogenanntes Box Objekt. Dieses definiert die Bounding Box über zwei Werte (Max/Min) pro Achse und kann über das ComponentDefinition Objekt auf zweierlei Weisen benutzt werden:

RangeBox vs. PreciseRangeBox

Neben der RangeBox: stellt Inventor seit Version 2023 eine PreciseRangeBox zur Ermittlung der Bounding Box bereit.

Autodesk definiert sie in ihrer Funktionsweise folgendermaßen:

RangeBox:

Property that returns a Box object which contains the opposing points of a rectangular box that is guaranteed to enclose this object.

PreciseRangeBox:

Gets a bounding box that tightly encloses all the solid and surface bodies under the ComponentDefinition.

Der elementare Unterschied besteht darin, dass die PreciseRangeBox auch dann ein korrektes minimal umgebendes Rechteck liefert, wenn Teile schief im Raum und nicht entlang der Achsen modelliert wurden. Nachteil ist, dass die PreciseRangeBox in großen Baugruppen spürbar rechenintensiver ist. Auch exkludiert sie Work Features, wie Ebenen, Achsen und Punkte.

Code

Der folgende Code ermittelt die Werte der Bounding Box in Abhängigkeit des Dokumententyps. Siehe dazu: iLogic: Dokumententypen.

Für Bauteile wird die PreciseRangeBox verwendet, für Baugruppen die RangeBox. Die ermittelten Werte werden anschließend, wie bereit im Post iLogic: Units of Measurement erläutert, von Inventors interner Längeneinheit Zentimeter in Millimeter konvertiert und mit der Ceil()-Methode auf den nächst höheren Ganzzahlwert gerundet. Der ermittelte Wert wird anschließend in ein Custom Property namens Dimensionen geschrieben.

Sub Main()
    Dim oDoc As Document = ThisDoc.Document
    Dim UOM As UnitsOfMeasure = oDoc.UnitsOfMeasure
    Dim oRangeBox As Box

    Select Case oDoc.DocumentType
        Case DocumentTypeEnum.kPartDocumentObject
            oRangeBox = oDoc.ComponentDefinition.PreciseRangeBox
        Case DocumentTypeEnum.kAssemblyDocumentObject
            oRangeBox = oDoc.ComponentDefinition.RangeBox
        Case Else
            Exit Sub
    End Select

    ' Max Werte
    Dim Xmax As Double = oRangeBox.MaxPoint.X
    Dim Ymax As Double = oRangeBox.MaxPoint.Y
    Dim Zmax As Double = oRangeBox.MaxPoint.Z

    ' Min Werte
    Dim Xmin As Double = oRangeBox.MinPoint.X
    Dim Ymin As Double = oRangeBox.MinPoint.Y
    Dim Zmin As Double = oRangeBox.MinPoint.Z

    ' Konvertiere in 'mm' und runde auf nächsten Ganzzahlwert
    Dim X As Double = Ceil(UOM.ConvertUnits(Xmax - Xmin, UnitsTypeEnum.kDatabaseLengthUnits, UnitsTypeEnum.kMillimeterLengthUnits))
    Dim Y As Double = Ceil(UOM.ConvertUnits(Ymax - Ymin, UnitsTypeEnum.kDatabaseLengthUnits, UnitsTypeEnum.kMillimeterLengthUnits))
    Dim Z As Double = Ceil(UOM.ConvertUnits(Zmax - Zmin, UnitsTypeEnum.kDatabaseLengthUnits, UnitsTypeEnum.kMillimeterLengthUnits))

    ' Erzeuge String im Format 'X x Y x Z [mm]'
    Dim Dimensions As String = String.Format("{0} x {1} x {2} [mm]", X, Y, Z)

    ' Schreibe Abmaße in Property und Logger
    iProperties.Value("Custom", "Dimensionen") = Dimensions
    Logger.Info("Dimensionen: {0}", Dimensions)
End Sub

Ergebnis

Durch Zufall bin ich heute erneut über ein Video von ihm gestoßen, das ein augenscheinlich einfaches alltägliches Problem mit iLogic zu lösen versucht:

Die Problemstellung: Wie kann man mit einem InputListBox-Dialogfenster die verfügbaren Materialien der Standard Inventor Materialbibliothek auflisten und diese durch eine Listenauswahl zuweisen? Das InputListBox-Dialogfenster ist dem aufmerksamen Leser dieser Serie bereit bekannt aus dem Post iLogic: User Interaktion.

Felix versucht in seinem initialen Code alle verfügbaren Materialien über das MaterialAssets Object als Liste anzusprechen und diese an eine InputListBox zu übergeben. Das Problem über das er stolpert stellt sich in der Form dar, dass Materialien in Inventor auf programmatischer Ebene Objekte sind. Folgerichtig bekommt er auch eine Liste an Objekten in der InputListBox angezeigt, die jedoch dem Endanwender nichtssagende Informationen enthalten:

Wie bereits angeschnitten, ist ein MaterialAsset in Inventor nicht nur lediglich ein Materialname, sondern besitzt zusätzlich viele Eigenschaften, bspw. einen Namen, einen Anzeigenamen, Texturangaben oder aber auch physische Eigenschaften, wie die Dichte:

Felix umgeht das Problem mit einem gesunden Maß an Overengineering und nutzt letzten Endes eine flexible Wrapper Class, die er auf seiner Webseite dokumentiert hat.

Meine Lösung

Im Kern kann das Problem auch relativ einfach in iLogic gelöst werden. Man muss lediglich:

1. eine leere Liste listMaterials deklarieren
2. über alle MaterialAssets iterieren und jeden Anzeigenamen des jeweiligen Materials in die Liste einfügen
3. diese Liste an die InputListBox übergeben und die Auswahl als Return Value in eine Variable speichern
4. im finalen Schritt den iLogic Shortcut iProperties.Material benutzen. Dieser akzeptiert für eine Materialzuweisung den Anzeigenamen eines Materials.

Der Code:

Sub Main()
    Dim oMaterialAssets As AssetsEnumerator = ThisApplication.AssetLibraries.Item(3).MaterialAssets
    Dim listMaterials As New List(Of String)

    For Each oMaterialAsset As MaterialAsset In oMaterialAssets
        listMaterials.Add(oMaterialAsset.DisplayName)
    Next

    Dim selection As String = InputListBox(
        "Welches Material soll zugewiesen werden?",
        listMaterials,
        listMaterials(0),
        "Materialauswahl",
        "Material",
        480,
        0
    )

    If Not String.IsNullOrEmpty(selection) Then
        iProperties.Material = selection
    End If
End Sub

Das Ergebnis:

Optimierte Lösung

Idealerweise prüft man vorangestellt, ob es sich beim aktiven Dokument um ein Bauteil (PartDocument) handelt, denn Baugruppen kann kein Material (abseits Material für Schweißwerkstoffe) zugewiesen werden. Wie dies funktioniert wurde bereits im Post iLogic: Dokumententypen erläutert:

Sub Main()
    Dim oDoc As Document = ThisDoc.Document

    If oDoc.DocumentType <> DocumentTypeEnum.kPartDocumentObject Then
        MessageBox.Show(
            "Dieser Code funktioniert nur in Bauteilen.",
            "Falscher Dokumententyp",
            MessageBoxButtons.OK,
            MessageBoxIcon.Error,
            MessageBoxDefaultButton.Button1
        )
        Exit Sub
    End If

    Dim oMaterialAssets As AssetsEnumerator = ThisApplication.AssetLibraries.Item(3).MaterialAssets
    Dim listMaterials As New List(Of String)

    For Each oMaterialAsset As MaterialAsset In oMaterialAssets
        listMaterials.Add(oMaterialAsset.DisplayName)
    Next

    Dim selection As String = InputListBox(
        "Welches Material soll zugewiesen werden?",
        listMaterials,
        listMaterials(0),
        "Materialauswahl",
        "Material",
        480,
        0
    )

    If Not String.IsNullOrEmpty(selection) Then
        iProperties.Material = selection
    End If
End Sub

Wird der Code nun in einer Baugruppe oder Zeichnung ausgeführt, erscheint eine Warnmeldung:

Inventor erlaubt eine vordefinierte Config im XML-Format über den Button Import… zu importieren:

Eine solche Config für darzustellende Properties muss zuvor in einem Dokument definiert und anschließen über den Button Export… exportiert und kann anschließend maßgebend in anderen Baugruppen genutzt werden.

Da das händische Importieren einer solchen Datei einen Akt zeitraubener Klickarbeit darstellt, kann der Import auch mit iLogic automatisiert werden.

Code zum Import der BOM Settings

Die BOM Settings können über das BOM Object manipuliert werden. Für den Import einer Settings-Datei stellt die Inventor API explizit die Methode BOM.ImportBOMCustomization bereit. Diese erwartet als einzigen Parameter einen absoluten Dateipfad zur Settings-Datei als String:

Im realen Anwendungsfall kann ales Beispiel eine BOM-Setting-Datei mit dem Namen BOM-Settings.xml herhalten. Der absolute Pfad dieser beispielhaften Datei soll lauten: C:\foo\BOM-Settings.xml

Dim oDoc As Document = ThisDoc.Document

' Sicherstellen, dass Import nur in Baugruppen erfolgt
If oDoc.DocumentType = kAssemblyDocumentObject Then
    Dim oBOM As BOM = oDoc.ComponentDefinition.BOM
    ' Absoluter Pfad zur BOM-Settings-Datei
    Dim sBOMSettingsFile As String = "C:\foo\BOM-Settings.xml"

    ' Import der Datei im aktiven Baugruppendokument
    oBOM.ImportBOMCustomization(sBOMSettingsFile)
End If

BOM nach Import öffnen

Möchte man die BOM nach dem Import einer Setting-Datei öffnen, kann auch dies mit iLogic erfolgen. Dabei muss die BOM über das ControlDefinition Object angesprochen und geöffnet werden. Um dies zu bewerkstelligen muss der zuvor gezeigte Code um lediglich 2 Zeilen erweitert werden:

Dim oBOMControlDef As ControlDefinition = ThisApplication.CommandManager.ControlDefinitions.Item("AssemblyBillOfMaterialsCmd")
oBOMControlDef.Execute2(True)

Wichtig an der Stelle ist, dass die Methode ControlDefinition.Execute2 und nicht ControlDefinition.Execute verwendet wird, da eine synchrone Ausführung des Befehls zur Laufzeit des iLogic Codes erfolgen muss.

Der Finale Code könnte dergestalt sein:

Dim oDoc As Document = ThisDoc.Document

' Sicherstellen, dass Import nur in Baugruppen erfolgt
If oDoc.DocumentType = kAssemblyDocumentObject Then
    Dim oBOMControlDef As ControlDefinition = ThisApplication.CommandManager.ControlDefinitions.Item("AssemblyBillOfMaterialsCmd")
    Dim oBOM As BOM = oDoc.ComponentDefinition.BOM
    Dim sBOMSettingsFile As String = "C:\foo\BOM-Settings.xml"

    ' Import der Datei im aktiven Baugruppendokument
    oBOM.ImportBOMCustomization(sBOMSettingsFile)
    ' BOM Aufrufen
    oBOMControlDef.Execute2(True)
End If

Man kann auf zweierlei Weise mittels iLogic prüfen, ob eine Datei ausgechecked ist:

Methode 1 | Abfrage über die Vault API

Seit Inventor 2024 stellt Autodesk die Möglichkeit bereit über iLogic Abfragen an die Vault API zu senden. Dafür steht die iLogicVaultClass Class bereit und besitzt auch eine Methode iLogicVaultClass.GetVaultFileStatus, um Informationen zum Dateistatus zu erhalten. Autodesk stellt Beispiel-Code in Form einer Funktion bereit, die als Return Value ein Dictionary liefert, in denen alle Informationen zum Dateistatus enthalten sind:

Public Function GetVaultFileStatus(
    LocalFullFileName As String
) As Dictionary(Of String, String)

Problem: Ich habe nicht länger Zugriff auf eine laufende Vault Instanz und kann über die Funktionsweise keinerlei Auskunft geben. ¯\(ツ)/¯

Methode 2 | Abfrage des Schreibschutzes der Datei

Über iLogic kann dem aktiven Dokument der volle Pfad über das Property Document.FullFileName entnommen werden. Dieser Pfad kann mittels der FileInfo Class genutzt werden, um über das Property FileInfo.IsReadOnly einen bool’schen Wert über den Status des Schreibschutzes zu erhalten.

Die zweite Methode wird in diesem Post näher erklärt.

Funktion mit Boolean Return Value

Der einfachste Weg zum Erfragen des Schreibschutzstatus ist die Auslagerung der gesamten Logik in eine eigene Funktion, die am Ende einen bool’schen Wert als Return Value liefert. Als Funktionsparameter wird der FullFileName übergeben. Ist die Datei schreibgeschützt, wird der Wert True zurückgegeben.

Private Function IsWriteProtected(FullFileName As String) As Boolean
    Dim oFileInfo As New IO.FileInfo(sFullFileName)

    If oFileInfo.IsReadOnly Then
        Return True
    Else
        Return False
    End If
End Function

Zum Thema Funktionen ist in dieser Serie bereits ein Post erschienen: iLogic: Struktureller Aufbau

Vollständiges Beispiel

Diese Funktion kann nun in einer Hauptroutine genutzt werden:

Sub Main()
    Dim oDoc As Document = ThisDoc.Document

    If IsWriteProtected(oDoc.FullFileName) Then
        Logger.Warn("Datei ist schreibgeschützt.")
        Exit Sub
    Else
        Logger.Info("Datei ist nicht schreibgeschützt.")

        ' Hier kann Code platziert werden, der nur
        ' in ausgecheckten Dateien ausgeführt wird.

    End If
End Sub

Private Function IsWriteProtected(sFullFileName As String) As Boolean
    Dim oFileInfo As New IO.FileInfo(sFullFileName)

    If oFileInfo.IsReadOnly Then
        Return True
    Else
        Return False
    End If
End Function

Zu Beachten

Der Schreibschutz auf Dateiebene ist kein 100% sicherer Marker, ob eine Datei wirklich ausgechecked ist. Am Ende gibt es immer noch den wild-klickenden unbedarften User, der es am Ende schafft eine eingecheckte Datei lokal zu modifizieren:

Im Falle einer lokalen Modifikation würde eine iLogic beim Ausführen der Funktion IsWriteProtected() melden, dass die Datei schreibbar ist, obwohl sie nicht auf den aktuellen User ausgechecked ist. Der iLogic Code würde laufen. Gleichzeitig würden aber die Änderungen, die eine iLogic am Dokument vorgenommen hat, nicht in Vault vorhanden sein.

Dateinamen und insbesondere lange kryptische Dateinamen, bspw. aus importierten Dateien, können den Model Browser schnell überfrachten und zur generellen Unübersichtlichkeit beitragen. Es kann daher Sinn ergeben ein einheitliches Format zu erzwingen und mittels iLogic beim Speichervorgang zu setzen.

Der Displayname ist dem Document Object zugehörig und steht als eigenes Property Document.DisplayName zur Verfügung. An dieses Property muss lediglich ein String übergeben werden, um den Displaynamen anzupassen:

Beispielszenario

Im Post iLogic: Propertysets wurden bereits alle Inventor Property Sets beschrieben. Für das folgende Beispiel wird die Datei LST_Bender.ipt verwendet. Dieses Bauteil hat fiktiv gepflegte Werte in den Project Properties:

Die Werte für die Properties Part Number, Description und Revision Number sollen nun in einem kombinierten String in den Displaynamen geschrieben werden. Als Beispiel wird das folgende Format gewählt:

{Description} - {Part Number} - Rev.{Revision Number}

Am konkreten Beispiel sähe das Resultat folgerichtig folgendermaßen aus:

LST Bender - 25785 - Rev.A

Displayname anpassen

Wie bereits erwähnt, wurde im Post iLogic: Propertysets die Inventor Property Sets beschrieben. Zusätzlich wurde dort auch der iLogic Shortcut vorgestellt, mit dem einfach Property Werte ausgelesen und geschrieben werden können. Der Befehlt lautet:

iProperties.Value("$PropertySet", "$PropertyName")

Im konkreten Fall muss also das Project Property Set ausgelesen und die darin enthaltenen Werte in Variablen gespeichert und als String kombiniert werden:

Dim oDoc As Document = ThisDoc.Document

Dim sDescription As String = iProperties.Value("Project", "Description")
Dim sPartnumber As String = iProperties.Value("Project", "Part Number")
Dim sRevision As String = iProperties.Value("Project", "Revision Number")

' Erzeuge String für kombinierten Displayname
Dim sDisplayname As String = String.Format("{0} - {1} - Rev.{2}", sDescription, sPartnumber, sRevision)

' Setze Displayname
oDoc.DisplayName = sDisplayname

Das Resultat:

Displayname zurücksetzen

Ein bereits gesetzter Displayname kann einfach gelöscht werden, indem man das Bauteil im Model Browser selektiert und mittels Umbenennen F2 den gesetzten Namenstext löscht:

Ein Reset des Displayname kann auch auf einfachste Weise mit iLogic geschehen, indem schlichtweg ein leerer String übergeben wird:

ThisDoc.Document.DisplayName = ""

Die ursprüngliche Bitte an Autodesk einen solchen Trigger einzuführen, stammt bereits aus dem Jahr 2015. Die Gründe sind nachvollziehbar, da vor diesem Trigger lediglich ein wirklich brauchbarer Event vorhanden war, um effektiv iLogics laufen zu lassen und zwar Before Save Document. iLogics bei jedem Speichervorgang laufen zu lassen ist und war nie wirklich zielführend. Insbesondere, wenn man eine große Menge an iLogics aktiv an die User ausgerollt hat, können diese die Dauer des Speichervorgangs spürbar beeinträchtigen. Viele iLogics kontrollieren, korrigieren oder setzen Property-Werte und oftmals ist es ausreichend dies nicht bei jedem Speichern erfolgen zu lassen, denn ein einmaliger Lauf vor dem Check-In in die Vault Datenbank führt zu selbigem Ergebnis.

Tücken des Triggers

Kurz nach den ersten Testvorgängen, stellte sich schnell Ernüchterung auf meiner Seite ein. Es ist relativ schnell und einfach möglich mit diesem neuen Trigger ein Dokument zu erzeugen, dass sich nicht mehr in Vault einchecken lässt. Ich hatte bspw. einen Fall in der alten iLogic Codebase, der nicht länger benötigte Custom Properties bereinigt hat, wie in diesem Post iLogic: Alte Properties automatisiert löschen beschrieben. Zeitgleich hat eine andere iLogic aber ein eben bereinigtes Property erneut in das Dokument geschrieben. Ersteres geschah beim Speichervorgang. Zweiteres beim Einchecken.

Das Resultat: Zirkellogik und ein Dokument, das nie aktuell ist und sich daher auch nicht sauber in Vault einchecken lässt:

Da scheinbar mehrere User über dieses Problem gestolpert sind, hat Autodesk bereits ein eigenes Support-Dokument veröffentlicht: The file was modified by a rule that ran on check-in

Dort wird die Ursache des Problems wie folgt beschrieben:

When using trigger “Before Vault Check-In” or “After Save Document”, it is not allowed to change (the already saved) Inventor file. Writing properties or any other information in the current file is not allowed for these triggers as it causes that the file needs a save operation again.

Das Kernproblem, welches an dieser Stelle entsteht, ist mangelnde Verbosity, denn die Aussage, dass die Datei während des Check-Ins modifiziert wurde, ist schlichtweg unpräzise und liefert keinerlei Hilfestellungen zur Lösung des Problems. Welche Regel das Dokument modifiziert hat oder was überhaupt modifiziert wurde ist nicht klar ersichtlich. Wer einen guten Überblick über seinen iLogic Code hat und diesen bis ins Detail kennt, mag darin kein Problem sehen. Wer aber eine komplett undokumentierte und unstrukturierte Codebase von 2800 Zeilen Code übernimmt, muss man dann erst mal Haare raufen und sich auf die Suche der Ursache begeben.

Anwendungsfälle für den Trigger

Wie bereits erwähnt, kann der Trigger bei Dokumentenmodifikation zu Problemen führen. Daraus folgt aber auch, dass alle iLogic Tasks, die das Dokument nicht modifizieren, als idealer Anwendungsfall dienen. An dieser Stelle möchte ich zwei reale Anwendungsfälle aufzeigen, die nicht mit dem aktiven Dokument arbeiten, sondern lediglich die Inventor Anwendung per iLogic ansprechen:

FALL 1 - 3D Bauteile in Iso-Ansicht schwenken

Für Bauteile und Baugruppen kann über den Trigger sichergestellt werden, dass das Modell vor dem Einchecken immer in die isometrische Ansicht gedreht wird. Somit findet jeder, der das Dokument aus Vault öffnet dieses einheitlich in identischer Ansicht vor.

FALL 2 - Erste Seite einer Zeichnung aktivieren

Für Zeichnungen kann der Trigger genutzt werden, um vor dem Einchecken die erste Seite der Zeichnung zu aktivieren. Dies sorgt ebenfalls für ein einheitliches Öffnungsverhalten beim Laden aus Vault und sorgt zusätzlich dafür, dass die erste Seite als Thumbnail in Vault hinterlegt wird.

Beide Fälle werden im Folgetext mit Code-Beispielen erläutert.

Isometrische Ansicht für 3D-Bauteile

Um die Inventor Anwendung mittels iLogic zu überreden die aktive Ansicht in die Iso-Ansicht zu schwenken, muss als erstes auf das Camera Object zurückgegriffen werden. Dieses definiert die Ansicht des Modells in der Inventor Application. Das Camera Object hat ein Property namens Camera.ViewOrientationType, mit dem eine spezifische Ansicht gewählt werden kann. Für letzteres ist dann der ViewOrientationTypeEnum wichtig. Der ViewOrientationTypeEnum stellt Standard-Asichten, wie die Vorderansicht, Seitenansicht etc., zur Verfügung, die dem Inventor-Anwender auch vom ViewCube bekannt sein sollten. Er stellt aber auch spezifischere Ansichten bereit, bspw. Blechansichten oder aber die gewünschten Iso-Ansichten:

Im folgenden Beispiel wird der ViewOrientationTypeEnum mit dem Wert kIsoTopRightViewOrientation genutzt:

Private Sub SetIsoView3d()
    Dim oApp As Application = ThisApplication

    Select Case oApp.ActiveDocument.DocumentType

        ' Nur in Bauteilen und Baugruppen ausführen
        Case DocumentTypeEnum.kPartDocumentObject, DocumentTypeEnum.kAssemblyDocumentObject
            Dim oCamera As Camera = oApp.ActiveView.Camera

            ' Schwenke in Iso Ansicht (Top Right)
            oCamera.ViewOrientationType = ViewOrientationTypeEnum.kIsoTopRightViewOrientation
            oCamera.Apply()
            ' View auf aktuelle Fenstergröße anpassen
            oApp.ActiveView.Fit()
    End Select
End Sub

Das Resultat:

Seite 1 aktivieren für Zeichnungen

Für Zeichnungen ist das aktivieren des ersten Zeichnungsblattes leicht möglich. Man muss lediglich über das Sheets Object das erste Sheet Object (Blatt 1) adressieren und über die Methode Sheet.Activate() aktivieren:

Private Sub ActivateDrawingSheet1()
    Dim oApp As Application = ThisApplication

    Try
        ' Sheet 1 aktivieren
        oApp.ActiveDocument.Sheets.Item(1).Activate()
        ' View auf aktuelle Fenstergröße anpassen
        oApp.ActiveView.Fit()
    Catch
        Logger.Warn("Could not activate Sheet 1")
    End Try
End Sub

Das Resultat:

Es gehört zum guten Stil diese Altlasten vor Freigaben zu entfernen. Inventor stellt dafür unter dem Tab Manage eine Funktion namens Purge bereit:

Sind an einem Dokument alte Stile vorhanden, werden diese in einem neuen Fenster gelistet und können mit einem Klick auf OK gelöscht werden:

Was in Inventors grafischer Oberfläche augenscheinlich einfach erscheint, stellte sich programmatisch mittels iLogic als nicht so einfach heraus. Es gab zu diesem Anwendungsfall bereits ein Post iLogic to purge styles im Inventor Forum, der bereits mehrere Jahre alt war, aber zu keiner gescheiten Lösung geführt hat. Vier Jahre nach Erstellung des Posts stand ich vor selbigem Problem und konnte es lösen.

Alte Zeichnungsstile und Stile an 3D Bauteilen müssen grundsätzlich anders programmatisch mit iLogic bereinigt werden:

Zeichnungsstile bereinigen

Für Zeichnungsstile stellt die Inventor API den Styles Manager bereit. Dieser Verwaltet jeden Zeichnungsstil als Style Object und bietet auch die Methode Delete an, um Stile zu löschen.

Die Styles einer Zeichnung sind erreichbar unter oDoc.StylesManager.Styles:

Um alte Stile eindeutig erkennen und auslesen zu können, müssen zwei Bedingungen erfüllt sein:

1. Das Property InUse muss den Wert False besitzen. Damit ist sichergestellt, dass der Stil nicht aktiv im Zeichnungsdokument verwendet wird.

2. Die StyleLocation, darf nicht der aktiven Stilbibliothek entsprechen. Auskunft darüber gibt der sogenannte StyleLocationEnum, der generell drei mögliche Werte kennt:

   • kLocalStyleLocation: Der Stil ist nur lokal vorhanden und nicht in der aktiven Bibliotheken enthalten.
   • kLibraryStyleLocation: Der Stil stammt aus einer aktiven Bibliothek.
   • kBothStyleLocation: Der Stil ist lokal am Dokument vorhanden, entspricht aber den Vorgaben einer aktiven Bibliothek.

In Code geschrieben sehen diese Bedingungen so aus:

Private Sub PurgeDrawingStylesHistory()
    Dim oStyles As Styles = ThisDoc.Document.StylesManager.Styles

    For Each oStyle As Style In oStyles
        If (oStyle.InUse = False And oStyle.StyleLocation <> StyleLocationEnum.kLibraryStyleLocation) Then
            Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused style: " & oStyle.Name)
            oStyle.Delete()
        End If
    Next
End Sub

Bauteilstile bereinigen

Für Bauteile und Baugruppen ist der Vorgang ein Anderer. Um in diesem Fall die Historie an Stilen zu löschen, muss auf das Assets Object zurückgegriffen werden. Dieses steht unter oDoc.Assets zur Verfügung. Jedes Asset (Material, Appearance, etc.) wird dort als AssetType gelistet. Die Art des Assets wird über den AssetTypeEnum ermittelt. Grundsätzlich stehen vier Auswahlmöglichkeiten an AssetTypes zur Auswahl:

1. kAssetTypeAppearance: Darstellungseinstellungen, wie bspw. ein Material gerendert werden soll.
2. kAssetTypeMaterial: Ein Material, das zuweisbar ist.
3. kAssetTypePhysicalProperties: Die physischen Eigenschaften des Materials, bspw. Dichte.
4. kAssetTypeUnknown: Ein nicht näher definierbares Asset.

Relevant sind lediglich kAssetTypeAppearance, kAssetTypeMaterial und die beiden Properties IsReadOnly und IsUsed. Nur ein schreibbares Asset (IsReadOnly = False) kann auch gelöscht werden und, wie auch bei den Zeichnungsstilen, kann nur ein Asset gelöscht werden, das nicht aktive in Verwendung (IsUsed = False) ist.

Zusätzlich gibt es ein Verhalten in Inventor, das eine strikte Einhaltung bei der Löschung der Stile erforderlich macht: Material Assets müssen vor den Appearance Assets gelöscht werden.

Mit diesen Erkenntnissen kann eine Sub-Routine bspw. folgendermaßen aussehen:

Private Sub PurgePartStylesHistory()
    Dim oAssets As Assets = ThisDoc.Document.Assets

    ' Clean Material Assets first
    For Each oAsset As Asset In oAssets
        Try
            If (oAsset.AssetType = AssetTypeEnum.kAssetTypeMaterial And oAsset.IsReadOnly = False And oAsset.IsUsed = False) Then
                Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused Material Asset: " & oAsset.Name)
                oAsset.Delete()
            End If
        Catch
            Logger.Warn(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Error when removing unused Material Asset.")
        End Try
    Next

    ' Clean Appearance Assets second
    For Each oAsset As Asset In oAssets
        Try
            If (oAsset.AssetType = AssetTypeEnum.kAssetTypeAppearance And oAsset.IsReadOnly = False And oAsset.IsUsed = False) Then
                Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused Appearance Asset: " & oAsset.Name)
                oAsset.Delete()
            End If
        Catch
            Logger.Warn(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Error when removing unused Appearance Asset.")
        End Try
    Next
End Sub

Das wäre aber zu einfach! Bei Bauteilen und Baugruppen kommt noch eine Besonderheit zum Tragen und zwar die Model States, die seit Version 2022 in Inventor zur Verfügung stehen. Diese können zur Variantenkonstruktion genutzt werden, sprich in einem Bauteil können unterschiedliche Materialien einem Model State zugewiesen werden. Es gilt daher zu beachten, dass lediglich der aktive Model State des Dokuments bereinigt wird.

iLogic für Zeichnungen und Bauteile

Im Post iLogic: Dokumententypen wurde bereits erläutert, wie Dokumententypen eindeutig identifiziert wurde. Möchte man nun den gezeigten Code in einer iLogic laufen lassen und zweitgleich Bauteile und Zeichnungen adressieren, kann dies folgendermaßen aussehen:

Sub Main()
    Dim oDoc As Document = ThisDoc.Document

    If oDoc.DocumentType = kPartDocumentObject Then
        PurgePartStylesHistory()
    Else If oDoc.DocumentType = kDrawingsDocumentObject Then
        PurgeDrawingStylesHistory()
    End If
End Sub

Private Sub PurgePartStylesHistory()
    Dim oAssets As Assets = ThisDoc.Document.Assets

    ' Clean Material Assets first
    For Each oAsset As Asset In oAssets
        Try
            If (oAsset.AssetType = AssetTypeEnum.kAssetTypeMaterial And oAsset.IsReadOnly = False And oAsset.IsUsed = False) Then
                Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused Material Asset: " & oAsset.Name)
                oAsset.Delete()
            End If
        Catch
            Logger.Warn(iLogicVb.RuleName & " | " & ThisDoc.Fil(True) & " | Error when removing unused Material Asset.")
        End Try
    Next

    ' Clean Appearance Assets second
    For Each oAsset As Asset In oAssets
        Try
            If (oAsset.AssetType = AssetTypeEnum.kAssetTypeAppearance And oAsset.IsReadOnly = False And oAsset.IsUsed = False) Then
                Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused Appearance Asset: " & oAsset.Name)
                oAsset.Delete()
            End If
        Catch
            Logger.Warn(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Error when removing unused Appearance Asset.")
        End Try
    Next
End Sub

Private Sub PurgeDrawingStylesHistory()
    Dim oStyles As Styles = ThisDoc.Document.StylesManager.Styles

    For Each oStyle As Style In oStyles
        If (oStyle.InUse = False And oStyle.StyleLocation <> StyleLocationEnum.kLibraryStyleLocation) Then
            Logger.Info(iLogicVb.RuleName & " | " & ThisDoc.FileName(True) & " | Removed unused style: " & oStyle.Name)
            oStyle.Delete()
        End If
    Next
End Sub

Dieser Code könnte somit auf einen Event Trigger, bspw. Before Save Document, für alle Dokumente gelegt werden und würde bei jedem Speichern die Stilhistorie bereinigen.

Anwendungsfall

Oftmals zeigt sich der Fall auf, dass Properties im Laufe eine Projekts angelegt, später aber nicht länger benötigt werden. Ursachen für diesen Zustand gibt es viele, bspw. das Überarbeiten bestehender Prozesse, konzeptfrei arbeitende Vault Admins oder aber der Wechsel eines Vault Admins in der Firma. Das händische Löschen von Properties ist in einem solchen Fall ein zeitraubender Task, den iLogic geflissentlich übernehmen kann.

Code zum Löschen der Properties

Das folgende Beispiel definiert eine Liste listOutdatedPropertyNames mit alten Propertynamen, die nicht länger benötigt werden. Diese Liste ist beispielhaft und kann mit Propertynamen aus realen Anwendungsfällen gefüllt werden. Wichtig und zu beachten dabei ist lediglich, dass der letzte Propertyname nicht mit dem Zeichen , beendet wird.

Der Code iteriert über alle Custom Properties, die im aktiven Dokument vorhanden sind und prüft jedes einzeln, ob es in der definierten Liste enthalten ist und löscht es, sofern dies der Fall ist:

Dim oDoc As Document = ThisDoc.Document

' Liste mit alten Propertynamen definieren, die
' durch die iLogic entfernt werden sollen
Dim listOutdatedPropertyNames = New String(){
    "Adhesive Assembly",
    "Adhesived Assembly",
    "Approved By",
    "Area",
    "Author",
    "Batch Number Relevant",
    "Blechabmessung",
    "Fläche",
    "Hurz"
}

' Adressiere das Custom Property Set
Dim oPropSet As PropertySet = oDoc.PropertySets.Item("Inventor User Defined Properties")

For Each oProperty In oPropSet
    If listOutdatedPropertyNames.Contains(oProperty.Name) Then
        oProperty.Delete
    End If
Next

Im folgenden möchte ich meine Lieblings-Addons präsentieren, die ich in Kombination mit meinem Browser der Wahl Firefox nutze:

uBlock

uBlock Origin ist ein Ad-Blocker und absolute Pflicht in jedem Browser. Nicht nur blockiert er ressourcenschonend und effizient Werbung und unterbindet Tracking, auch ist er quelloffen und wird durch eine lebhafte Community täglich mit aktuellen Blocklists versorgt.

uBlock Origin bringt eine sinnvolles Set an vordefinierten Blocklists mit und erlaubt auch das Aktivieren zusätzlicher, sowie das Anfertigen eigener Listen. Für Nutzer im deutschsprachigen Raum empfiehlt es sich die Blockliste DEU: EasyList Germany zu aktivieren.

uBlock ist auch für iOS verfügbar und löst somit kostenpflichtige AdBlocking Solutions wie AdGuard ab.

SponsorBlock

SponsorBlock für Youtube ermöglicht es gesponserte Segmente in Youtube Videos zu überspringen. Es beschränkt sich aber nicht nur auf solche Segmente, sondern kann auch sinnfreie Intros skippen oder direkt zu den Highlights der Videos springen und den selbstdarstellerischen Teil heutiger Creators vom User fernhalten. Das Addon ist ebenfalls quelloffen. Die Timestamps zum Überspringen der Segmente sind gespeist durch eine große nutzergenerierte Datenbank. Neu erscheinende Videos gängiger Kanäle sind oftmals bereits nach kurzer Zeit in der SponsorBlock-Datenbank.

Dieses Addon macht Youtube im Kern erst wieder benutzbar. Vorbei sind die Zeiten von press like, subscribe and hit the bell und wenn man sich einmal an diese Erweiterung gewöhnt hat, möchte man Youtube nie wieder ohne nutzen.

Der Entwickler hat eine dedizierte Website für diese Erweiterung am Netz und stellt es dort ausführlich vor.

DeArrow

DeArrow ist ebenfalls von dem selben Entwickler wie SponsorBlock und verbessert gleichso die Youtube-Experience. Dieses Mal wird jedoch nicht Werbung und lästig Intros adressiert, sondern bereits die Darbietung der Video-Thumbnails und Beschreibungen auf Youtube. Wer kennt sie nicht, diese schrecklichen Clickbait-Titel, diese grässlich verzogenen Fratzen und den übermäßigen Einsatz von Ausrufezeichen und Emojis?

DeArrow ist angetreten, diesem Treiben ein Ende zu bereiten und tut das erstaunlich gut.

DeArrow is an open source browser extension for crowdsourcing better titles and thumbnails on YouTube. The goal is to make titles accurate and reduce sensationalism. No more arrows, ridiculous faces, and no more clickbait.

Consent-O-Matic

Consent-O-Matic ist ein Addon, das sich einem wichtigen Thema annimmt, nämlich GDPR Consent Pop-Ups. Wer eine Webseite besucht wird allzu oft von einem lästigen Cookie-Banner begrüßt, der zur Zustimmung aller Tracking-Optionen auffordert. Ist man damit nicht einverstanden landet man oft in einem Wust von Untermenüs an Dark Patterns, die oftmals die eigene Geduld so weit ausreizen, bis man genervt auf Accept All klickt. Consent-O-Matic füllt diese Dark Patterns automatisiert aus, so dass der User nur noch die Auswahl bestätigen muss.

Consent-O-Matic ist ein Projekt der Aarhuus University in Dänemark, ist ebenfalls quelloffen und wird auf einer eigenen Website vorgestellt.

Das Addon gibt es auch als Safari-Extension für iOS.

ClearURLs

ClearURLs bereinigt Links von URL-Tracking-Parametern. Webseiten nutzen oftmals bei Benutzung der Sharing-Funktion von Inhalten spezifische URL-Parameter, die Rückschlüsse auf den User, seine Endgeräte oder das eigene Soziotop ermöglichen. ClearURLs ist quelloffen und entfernt diese Tracking-Parameter.

redditUntranslate

Das quelloffene Add-On redditUntranslate löst ein Problem, das eigentlich gar nicht existieren sollte. Google ist in ihrem dauerhaften Bestreben das Internet weiterhin kaputt zu machen mit einer neuen Marotte aufgewartet: Sucht man bei Google eine Information, die zu Reddit führt, und klickt auf diesen Link, wird automatisch ein URL-Parameter ?tl=de eingefügt, der eine automatische Übersetzung des Inhalts erzwingt. Dieses zweifelhafte “Feature” lässt sich nicht abschalten und sorgt für Unmut.

redditUntranslate entfernt diesen URL-Parameter beim Aufruf der Seite und verhindert somit eine automatische Übersetzung.

Nach einer zweijährigen Odyssee schloss sich vor Kurzem, per richterlicher Anordnung, ein unschönes Kapitel in dem Mehrparteienhaus, in dem ich lebe. Eine Person mit offenkundig psychischen Problemen hielt über viele Monate hinweg die gesamte Hausgemeinschaft auf Trab. Was unscheinbar begann, endete in Wahnvorstellungen, Sachbeschädigung und Fremdgefährdung.

Anregung für diesen Artikel war ein Beitrag aus der Zeit mit dem Titel Gefahr in der Hausgemeinschaft: Als die Angst einzog, der erschreckend viele Parallelen zu dem Fall in meinem Haus aufwies. Der Artikel der Zeit beschreibt eindrücklich den Fall einer wahnhaften Frau, ihrem Treiben und den Folgen für eine intakte Hausgemeinschaft. Gleichzeitig schildert er eindrücklich das Ohnmachtsgefühl nichts gegen den Störenfried tun zu können und das Verhalten einer Polizei, deren Hände in solchen Fällen gebunden sind. Die Kommentarspalte unter dem Artikel gibt Einblick in anderer Menschen Leben, die ebenfalls von einem solchen Fall betroffen sind.

Ich möchte in diesem Beitrag konkret aufzeigen, wie sich die Situation im Falle unserer Hausgemeinschaft abgespielt hat.

Phase 1: Stiller Einzug

Nachdem im Jahr 2023 eine Wohneinheit in unserem Mehrparteienhaus frei wurde, zogen zeitnah im ersten Stock eine Mutter und ihr Sohn, letzterer im folgenden Text nur noch “S” genannt, in die Wohnung ein. Die Mutter war geschätzt Mitte 50 und ihr Sohn höchstens in den frühen 20ern. Persönlich habe ich von dem Einzug nichts mitbekommen und laut Erzählungen eines Hausbewohners zogen beide ohne nennenswerten Hausstand ein. Es gab keinen gebuchten Möbeltransporter, kaum Kartons oder großes Schleppen.

Die Mutter sah man nur früh, wenn sie zu Fuß den Weg zur Arbeit antrat oder nachmittags davon zurück kehrte. S bekam niemand zu Gesicht. Auch nahm man ihn nicht auffallend wahr. Hätte man es mir nicht erzählt, hätte ich nie vermutet, dass neben der Mutter noch eine weitere Person in dem Haushalt leben würde.

In diesem Modus verlief das Zusammenleben nahezu ein Dreivierteljahr bis sich der Sommer 2024 anbahnte und wir als Hausgemeinschaft vermehrt den Garten vor dem Haus für gemeinsames Grillen, Feierabendbierchen und Plausch in der Sonne nutzten. Das Zimmer von S hatte Blick auf den Garten und das Treiben schien ihm zutiefst zuwider.

Phase 2: Zettelbotschaften

Es war besagter Sommeranfang als eines Tages ein vereinzelter Zettel mit einem Bibelvers urplötzlich im Garten auftauchte. Er wurde offenkundig aus dem Fenster im ersten Stock unmittelbar in den darunter gelegenen Garten geworfen. Die Sammlung der Zettel wuchs beständig von Tag zu Tag. Mal waren sie zu Papierfliegern gefaltet und andere male waren sie an Geldmünzen geklebt, um gezielter abgeworfen werden zu können. Einmal hing aus dem Nichts ein Pamphlet an der Pinnwand im Hausflur.

Es waren keine lebensbejahenden Bibelstellen, die auf den Zetteln vermerkt waren. Auf einigen Zetteln waren lediglich Songs mit zugehörigem Youtube-Link mit Titeln wie Kapelle des Todes oder Is He Worthy geschrieben. Andere enthielten persönliche Drohgebärden, wie “Euer Los. […] Entscheidet weise, Mädels”. Heraus stach auch eine kontinuierlich propagierte Referenz auf die Webseite trompete-gottes.com, die wiederum einen URL-Redirect auf eine Webseite namens Trumpet Call of God besitzt.

Über die Trompetenfreunde ist relativ wenig im Weltnetz zu finden. Es scheint sich um einen sektenhaften Kult zu handeln, der einem Anführer namens Timothy folgt und der im echten Leben Speed T. Rathbun heißt. Timothy hatte, laut eigenen Aussagen, 2010 mal einen direkten Plausch mit Gott, hat alles schriftlich festgehalten und bietet diesen zweifelhaften Content in diversen PDFs, verstreut über mehrere Webseiten, kostenfrei im Internet zum Download feil.

Bis zu diesem Punkt und bis auf die Zettel, war sonst nichts von S zu vernehmen. Eine persönliche Ansprache oder Kontaktaufnahme seinerseits blieb aus. Der Sommer ging in den Herbst über und die sonst gewohnte Ruhe von S gehörte der Vergangenheit an.

Phase 3: Fluchen & Ruhestörung

Im Herbst konnte man mit steigender Tendenz lautes Fluchen und Beleidigungen außerhalb von S Wohnungstür im Treppenhaus vernehmen. Es waren Kraftausdrücke aller Couleur, die er augenscheinlich gegen seine eigene Mutter richtete. “Du Schlampe. Du Hure. Ich bring dich um!”

Mit der Zeit wurde ersichtlich, dass er auch fluchte, wenn seine Mutter gar nicht zu Hause anwesend war. Zu den Flüchen gesellte sich rasch auch laut vernehmbarer Krach, der scheinbar davon ausging, dass S mit physischer Gewalt auf Gegenstände und die Wände der Wohnung einwirkte. Die nun fast täglich auftretenden Ausraster zur Tageszeit wurden zur Normalität und verlagerten sich alsbald in unchristliche nächtliche Zeitfenster zwischen 0 und 3 Uhr.

Insgeheim herrschte initial die Hoffnung, dass seine Mutter intervenieren und dem Treiben ein Ende bereiten würde. Sprach man sie auf das Verhalten ihres Sohnes an, stellte sich schnell heraus, dass sie die Schuld nicht bei ihm sah, sondern dass die Hausgemeinschaft sein Verhalten triggern würde. Ihren Sohn träfe da gewiss keine Schuld. Verständnis ihrerseits für vorgetragene Beschwerden war nie vernehmbar. Auch schien sie das Verhalten ihres Sohnes gänzlich für sich normalisiert zu haben.

Zeitnah lernte ich S das erste mal persönlich kennen. Ich saß im Garten in der herbstlichen Abendsonne, als er unerwartet aus dem Haus trat, um den Müll in den Mülltonnen zu entsorgen. Ein kleiner, zierlicher junger Mann in Adiletten und kurzer Hose stand mir gegenüber. Er wirkte auf den ersten Blick völlig normal und blickte mich doch mit stechendem Blick an, ohne ein Wort zu verlieren. Ich begrüßte ihn und stellte mich vor. Er tat es ebenfalls und wirkte dabei sichtlich nervös und kurz angebunden, als wolle er schnell wieder ins Haus. Ob alles in Ordnung wäre, fragte ich, was mit einem knappen “Ja” begegnet wurde. Er guckte mich weiterhin nur an. Was er denn so machen würde, fragte ich, worauf er antwortete “Er mache sein eigenes Ding”. Noch immer stand er einfach da und guckte mich an. Wo er denn herkäme und aufgewachsen sei, fragte ich, woraufhin er erwiderte er wäre in der Vergangenheit sehr oft mit seiner Mutter umgezogen. Dann wünschte er mir einen schönen Abend und ging zurück ins Haus.

Bis zu diesem Punkt spielte sich das Verhalten von S in Gänze innerhalb seiner eigenen vier Wände ab. Doch auch das sollte ab nun der Vergangenheit angehören.

Phase 4: Psychoterror

Eines Tages klingelte es zum späten Abend bei einem Bewohner des Hauses an der Tür. S hatte sich aus der Wohnung gewagt, um ein persönliches Anliegen vorzutragen. Als die Tür geöffnet wurde sagte er den Satz: “Wir haben ein Problem”.

Das Gespräch verlief wirr. Im Kern warf S der Person vor mittels Gedankenkraft seine Wassertherme zu steuern und somit Lärm zu verursachen, um willentlich “Psychoterror” an ihm zu verüben. Beschwichtigungen, dass dies nicht der Fall sei, erreichten S nicht und langsam wurde allen im Haus ersichtlich, dass eine Stufe erreicht war, die Vorsicht und Umsicht von allen Hausbewohnern erforderte.

Die Lärmbelästigung nahm in den folgenden Wochen mehr und mehr zu. Die Polizei wurde in regelmäßigen Abständen eingeschaltet, blieb in der Regel aber nur kurz, da keine Fremdgefährdung vorlag. Sie empfahl ein Lärmprotokoll zu führen und mit der Vermietung in Kontakt zu treten. Mehr könne sie an der Stelle nicht tun.

Ein Nachbar aus dem Nebengebäude beschwerte sich in den Folgetagen, weil S am Fenster gestanden und ihn auf der Straße mit Kraftausdrücken beleidigt hätte. Als ich S eines Tages am Fenster stehen sah, streckte er mir energisch den Mittelfinger entgegen, obwohl ich ihm stets freundlich gesonnen war.

Eines weiteren Tages traf ich S im Hausflur an. Er stand dort einfach ziellos auf halbem Stock herum. Auf die Frage, ob es ihm gut ginge folgte erneut nur ein knappes “Ja”. Auf meine Nachfrage, ob es ihm wirklich gut ginge, geriet er unerwartet in einen Redeschwall. Er hätte ein gewaltiges Problem mit dem Bewohner, bei dem er auch bereits geklingelt hätte. Der besagte Mitbewohner würde “Psychoterror” und “psychische Folter” an ihm ausüben und er müsse sich da konsequenterweise etwas finales überlegen, um diesem Treiben ein Ende zu bereiten. Auf meinen Einwand, dass gerade sein Verhalten das gesamte Haus gegen ihn aufbrächte, entgegnete er nur mit einem abschätzigen Lachen. Zugänglich war er ab dem Punkt nicht mehr und unsere Wege trennten sich.

Einmal öffnete S die Haustür als ich gerade Heim kam und sprach mich direkt mit meinem Vornamen an, den er sich scheinbar aus der Vorstellung im Garten gemerkt hatte. Er hätte ein Problem. Sein Handy hätte urplötzlich keinen Empfang mehr und er hätte den Verdacht abgehört zu werden oder gehackt worden zu sein. Er bat um eine technische Einschätzung des Sachverhalts und wirkte freundlich gesonnen und kommunikativ.

Ein weiteres mal kam ich spät abends nach Hause, schloss die Haustür auf und S stand direkt dahinter im Dunkeln - wer weiß wie lange schon. Ich erschrak mich zu Tode und sagte ihm in freundlichem Ton, dass er mir einen guten Schrecken eingejagt hätte. Er sagte nichts. Stattdessen ging er langsam seitwärts die Treppe hinauf bis zu seiner Haustür und schaute mich dabei durchweg an.

Im folgenden ein exemplarisches kombiniertes Lärmprotokoll aller Hausbewohner aus dieser Zeit:

Zu aller Überraschung war bereits seit einiger Zeit urplötzlich seine Mutter verschwunden. Sie war einfach seit Wochen nicht mehr da und S war auf sich allein gestellt und ohne familiäre Bezugsperson. Eines Abends klingelte er bei einem Nachbarn und bat um Geld, da er schlichtweg nichts mehr zu essen hätte. Er konnte einem Leid tun…

Seine Mutter sollte nur noch einmal auftauchen und eine neue Phase der Eskalation einleiten.

Phase 5: Sachbeschädigung

Die nächtlichen Exzesse und Ruhestörungen gingen unvermittelt weiter. Die Polizei war in der Regel einmal die Woche im Haus, sprach mit S und ging. Der fortlaufend geäußerten Bitte, einen Amtsarzt hinzuzuziehen und eine Einweisung in die Psychiatrie aus höherer Instanz zu erwirken, wurde beharrlich nicht stattgegeben, da weder Fremd-, noch Eigengefährdung vorläge.

Eines Tages war seine Mutter urplötzlich auf einmal wieder da. Es waren lautstarke Beschimpfungen seinerseits im Treppenhaus zu vernehmen. Sie schien ihm irgendwas gesagt zu haben, was ihm offenkundig nicht gefiel. Durch das Fenster sah ich die Mutter fluchtartig die Wohnung verlassen und Minuten später hörte man das laute Klirren berstender Scheiben durch den Hausflur. S hatte in einem Wutanfall die Glasscheibe in seiner Haustür eingeschlagen. Seine Mutter ward ab diesem Zeitpunkt nie wieder gesehen.

Ein paar Tage später wurde ich morgens um 6 Uhr unsanft aus dem Schlaf gerissen, weil ein Gegenstand mit Wucht und aus Höhe im Hinterhof auf den Boden prallte. S hatte die gesamte Beistellware, die auf der Fensterbank platziert war, inkl. zweier großer Pflanzen und deren massiven Tontöpfen, in den Hinterhof des Nachbarhauses geworfen. In dem angrenzenden Nachbarhaus leben Kinder, die genau in diesem Hinterhof ihre Fahrräder abstellen mit denen sie morgens zur Schule und zum Kindergarten fahren. Der Punkt der Fremdgefährdung war an dieser Stelle erreicht. Eine rote Linie wurde von S überschritten.

Minuten später war die Polizei und ein Rettungswagen vor Ort. S antwortete nicht auf ihr energisches Klingeln, Klopfen und Rufen. Er schwieg und tat, als wäre er nicht zu Hause. Die Feuerwehr wurde hinzugezogen, um die Haustür gewaltsam zu öffnen. Als S dann doch nach 1,5 Stunden kleinbei gab und die Tür öffnete, hörte man sein ewiges Klagelied darüber, dass er von den Hausbewohnern terrorisiert werden würde, dass er nicht derjenige sei, zu dem die Polizei gehen solle, dass sich alle gegen ihn verschworen hätten.

Dieses mal nahm die Polizei S nach langen Verhandlungen mit. Wohin erfuhr niemand. Wie lange S wegbleiben würde, wusste ebenfalls keiner - aber er blieb weg.

Nach ca. 10 Tagen des Friedens tauchte er aus der Versenkung wieder auf. Danach war er nicht mehr wiederzuerkennen. Er ging joggen und man traf ihn oftmals außer Haus an. Einmal kreuzten sich unsere Wege in der Stadt und er erzählte stolz, dass er jetzt eine Freundin hätte. Man konnte sich gut mit ihm unterhalten und er wirkte froh, dem Leben zugewandt und lachte viel beim Reden. Oft war er tagelang nicht zu Hause. Alles schien gut und in geordneten Bahnen, als hätte irgendjemand in der Zeit seiner Abwesenheit einen Schalter umgelegt. Auch die nächtlichen Ruhestörungen blieben aus. Es war wieder Frieden und Normalität im Haus.

Zwei Monate später waren erneut Scherben im Flur. Er hatte einen Bilderrahmen mit Glasscheibe zerschlagen…

Phase 6: Stiller Auszug

Über die vergangenen Monate wurde in einem langen zähen Prozess vor dem Amtsgericht eine außerordentliche Kündigung des Mietvertrags inkl. Zwangsräumung erwirkt, der nun - zur Erleichterung aller Hausbewohner - stattgegeben und auch von S akzeptiert wurde.

So still wie S einzog, zog er auch wieder aus. Er nahm, laut Erzählung eines Hausbewohners, lediglich drei Gegenstände mit: Eine Matratze, einen Bluetooth-Lautsprecher und einen Spiegel.

Unweigerlich musste ich an seine Worte unserer Begegnung in der herbstlichen Abendsonne denken: "[…] ich bin oft mit meiner Mutter umgezogen". An der Stelle schließt sich vermutlich der Kreis. Er wird erneut mit spärlichen Hausstand umziehen, ohne Vorwarnung an seine neuen Nachbarn und das Treiben beginnt schleichend von Neuem.

diff-pdf herunterladen

Das Tool liegt als kompilierte exe bei Github vor und kann über diesen Link direkt heruntergeladen werden. Anschließend muss der Ordner entpackt und in diff-pdf umbenannt werden.

Da das Tool keinen Installer besitzt, macht es Sinn es an einen Ort im Benutzerverzeichnis abzulegen und die Pfadvariablen von Windows so zu setzen, dass es für den User im Terminal verfügbar ist. Dazu den Windows Explorer öffnen und in die Pfadzeile %USERPROFILE% eintragen. Dort einen Ordner namens Apps anlegen und den Ordner diff-pdf hinein kopieren.

Pfadvariablen setzen

Damit im Terminal nicht immer der volle Pfad zur exe eingegeben werden muss, wird eine neue Pfadvariable gesetzt:

1. In die Windows Suche environment variables for eingeben und den Eintrag Edit environment variables for your account wählen:

   

2. Einen Doppelklick auf die Zeile Path machen:

   

3. Ein Klick auf New und mittels Browse... den Ordner diff-pdf im Benutzerverzeichnis auswählen:

   

Von nun an steht das Kommando diff-pdf.exe im Terminal zur Verfügung.

PDFs vergleichen

1. Einen Ordner erstellen, bspw. auf dem Desktop und dort zwei PDFs hinein kopieren, die verglichen werden sollen. In meinem Beispiel heißen die Dateien LST_Bender_RevA.pdf und LST_Bender_RevB.pdf:

   

2. Einen Rechtsklick auf eine leere Fläche des Ordners machen und Open in Terminal auswählen:

   

Das Terminal öffnet sich und erwartet einen Befehl. Im Umgang mit diff-pdf stehen nun folgende Auswahlmöglichkeiten über Parameter und Argumente zur Verfügung:

Grafischer Viewer

Ein einfacher grafischen Viewer kann mit dem Argument --view geöffnet werden. Dieser zeigt grafisch die detektierten Änderungen und erlaubt das Zoomen innerhalb der Anzeige:

diff-pdf.exe --view .\LST_Bender_RevB.pdf .\LST_Bender_RevA.pdf

Das farbliche Overlay kann mit gedrückter CTRL und den Pfeiltasten verschoben werden.

PDF der Änderungen erzeugen

Möchte man den grafischen Output als PDF abspeichern, kann das Argument --output-diff=diff.pdf verwendet werden:

diff-pdf.exe --output-diff=diff.pdf .\LST_Bender_RevB.pdf .\LST_Bender_RevA.pdf

Das Kommando erzeugt dann eine Datei mit dem Namen diff.pdf:

Anmerkungen

Arbeitet man im Ökosystem von Autodesk und nutzt Vault als PDM-Datenbank, kann diff-pdf auch auf dem Jobserver eingesetzt werden. Wechselt eine Zeichnung bspw. in einen Status zur Aufforderung der Zeichnungsprüfung werden in der Regel bereits PDF-Exporte vom Job Server erstellt und liegen somit in der Vault Datenbank vor. Ein vorhandener Job kann somit erweitert werden, zusätzlich das PDF der vorherigen Revision abrufen und direkt gegen den neuen Stand der aktuellen Freigabe ein Diff erzeugen.

Die Methoden unterscheiden sich grundsätzlich in ihrer Funktion und Anwendungsfall:

StreamWriter

Öffnet einen Stream, der es erlaubt kontinuierlich Daten Zeile-für-Zeile wegzuschreiben. Dies ist nützlich in iterativen Vorgängen.

WriteAllText

Schreibt direkt einen Text in eine Datei.

Minimalbeispiel StreamWriter

Im folgenden ein Minimalbeispiel, dass eine Textdatei hallo.txt im Pfad C:/iLogicOutput/ erzeugt, die Zeichenfolge Hallo schreibt und nach dem Schreibvorgang das Dokument automatisch öffnet. Vorangestellt ist eine Prüfung die sicherstellt, dass der Ausgabepfad bereits existiert und legt diesen ggf. an, bevor der Schreibvorgang startet.

Dim oFile As System.IO.File
Dim oWrite As System.IO.StreamWriter
Dim sFilePath As String = "C:/iLogicOutput/hallo.txt"
Dim sDirectory As String = System.IO.Path.GetDirectoryName(sFilePath)

If Not System.IO.Directory.Exists(sDirectory) Then
    System.IO.Directory.CreateDirectory(sDirectory)
End If

oWrite = oFile.CreateText(sFilePath)
oWrite.WriteLine("Hallo")
oWrite.Close()

ThisDoc.Launch(sFilePath)

Die letzte Zeile ThisDoc.Launch() öffnet final die erzeugte Textdatei.

Minimalbeispiel WriteAllText

Das folgende Minimalbeispiel schreibt das heutige Datum in eine Textdatei:

Dim sFilePath As String = "C:/iLogicOutput/hallo.txt"
Dim sDirectory As String = System.IO.Path.GetDirectoryName(sFilePath)
Dim currentDate As String = Now.ToString("dd.MM.yyyy")

If Not System.IO.Directory.Exists(sDirectory) Then
    System.IO.Directory.CreateDirectory(sDirectory)
End If

IO.File.WriteAllText(sFilePath, currentDate)
ThisDoc.Launch(sFilePath)

Anwendungsbeispiele

Blechregeln als CSV-Export

Dieses Beispiel exportiert sämtliche Blechregeln als CSV-Datei. Als Trennzeichen (Delimiter) wird in diesem Fall ein Semikolon ; verwendet und kann ggf. in den Zeilen oWrite.WriteLine() angepasst werden, sofern ein Komma als Trennzeichen erwünscht ist. Das Beispiel ist ein Quick-and-Dirty-Lösung, die den CSV-Header und die Wertezeilen rausschreibt. Die CSV-Datei kann dann theoretisch auch in Excel importiert werden - wenn man das denn will.

Das Blechteil wird, wie bereits im Post iLogic: Dokumententypen erläutert, über die DocumentSubTypeID ermittelt.

Dim oDoc As Document = ThisDoc.Document

' Check if Sheet Metal Part is currently open in Inventor
If oDoc.DocumentSubType.DocumentSubTypeID <> "{9C464203-9BAE-11D3-8BAD-0060B0CE6BB4}" Then
    MessageBox.Show(
        "Please open a Sheet Metal Part and try again", _
        "Not a Sheet Metal Part", _
        MessageBoxButtons.OK, _
        MessageBoxIcon.Error
    )
    Exit Sub
End If

' Get SheetMetalStyles object
Dim oSheetMetalStyles As SheetMetalStyles = oDoc.ComponentDefinition.SheetMetalStyles

' Streamwriter
Dim oFile As System.IO.File
Dim oWrite As System.IO.StreamWriter
Dim sFilePath As String = "C:/iLogicOutput/SheetMetalRules.csv"
Dim sDirectory As String = System.IO.Path.GetDirectoryName(sFilePath)

If Not System.IO.Directory.Exists(sDirectory) Then
    System.IO.Directory.CreateDirectory(sDirectory)
End If

oWrite = oFile.CreateText(sFilePath)

' CSV Header
oWrite.WriteLine("""Sheet Metal Rule"";""Material"";""Thickness"";""Bend Radius"";""Unfold Rule"";""kFactor""")

' CSV Row Data
For Each oSheetMetalStyle As SheetMetalStyle In oSheetMetalStyles
    Dim sRuleName As String = oSheetMetalStyle.Name
    Dim sMaterial As String = oSheetMetalStyle.Material.Name
    Dim sThickness As String = oSheetMetalStyle.Thickness
    Dim sBendRadius As String = oSheetMetalStyle.BendRadius
    Dim sUnfoldRule As String = oSheetMetalStyle.UnfoldMethod.Name
    Dim sKFactor As String = oSheetMetalStyle.UnfoldMethod.kFactor

    oWrite.WriteLine("""{0}"";""{1}"";""{2}"";""{3}"";""{4}"";""{5}""", _
                     sRuleName, sMaterial, sThickness, sBendRadius, sUnfoldRule, sKFactor)
Next

oWrite.Close()
ThisDoc.Launch(sFilePath)

Materialbibliothek als Markdown-Tabelle

Dieses Beispiel exportiert die Materialbibliothek in eine Markdown Tabelle. Dazu wird nicht das aktive Dokument genutzt, sondern die Inventor Application, die sämtliche Bibliotheken (AssetLibraries) verwaltet:

Zusätzlich wird der Zeitpunkt des Exports im Dateinamen im Format Materials_2025-06-01.txt festgehalten.

Dim oApp As Application = ThisApplication
Dim oMaterialLibrary As AssetsEnumerator = oApp.AssetLibraries.Item("Autodesk Material Library").MaterialAssets

Dim formattedDate As String = Now.ToString("yyyy-MM-dd")
Dim sFilePath As String = "C:/iLogicOutput/Materials_" & formattedDate & ".txt"
Dim sDirectory As String = System.IO.Path.GetDirectoryName(sFilePath)
Dim oFile As System.IO.File
Dim oWrite As System.IO.StreamWriter

If Not System.IO.Directory.Exists(sDirectory) Then
    System.IO.Directory.CreateDirectory(sDirectory)
End If

oWrite = oFile.CreateText(sFilePath)

oWrite.WriteLine("Export date: **" & formattedDate & "**" )
oWrite.WriteLine("")
oWrite.WriteLine("This table is a Markdown Table. Paste it into your Markdown renderer of choice like https://dillinger.io or vscode.")
oWrite.WriteLine("")
oWrite.WriteLine("| Material Name | Material Category | Density [kg/m^3^]|")
oWrite.WriteLine("| ------------- | ----------------- | ---------------: |")

For Each oMaterialAsset As MaterialAsset in oMaterialLibrary
    Dim sLineData As String = "| " & oMaterialAsset.DisplayName & " | " & oMaterialAsset.CategoryName & " | " & oMaterialAsset.PhysicalPropertiesAsset.Item("structural_Density").Value &  " |"
    oWrite.WriteLine(sLineData)
Next

oWrite.Close()
ThisDoc.Launch(sFilePath)

Der Output ist als Markdown Tabelle formatiert und kann mit einem Markdown Renderer wie Visual Studio Code oder Onlinediensten wie dillinger.io gerendert werden:

Da ich alle alten Beiträge überarbeitet habe und an die neue Theme anpassen musste, wird dies naturgemäß zu Chaos im RSS-Feed führen und sämtliche Posts werden als neue Beiträge angezeigt. Dies lässt sich technisch leider nicht unterbinden.

Die URL des RSS-Feed bleibt bestehen und erfordert keinerlei Anpassungen im Feedreader des Vertrauens.

Was ist Team Web?

Team Web ist ein nützliches Feature um Inventor-spezifische Themen, Anleitungen oder Hilfestellungen direkt in der Inventor Applikation darzustellen. Inventor wird somit zu einem kleinen Webbrowser, der HTML rendern und als zentrale Anlaufstelle für Konstruktionsthemen oder als News-Feed dienen kann. Oftmals anderweitig vorhandene fragmentiere Anleitungen und Handbücher finden im Team Web eine potentielle neue Heimat und sind dort indexiert, einfach suchbar und schnell zur Hand, ohne die Inventor Anwendung verlassen zu müssen.

Grundlage des dargestellten Inhalts ist eine HTML-Webseite, die entweder lokal vom Dateisystem oder über eine FQDN serviert wird. Da in Firmennetzwerken das Beantragen eines Domain-Namens, sowie die Bereitstellung eines Webservers gut und gerne auch mal etwas länger dauern kann, fokussiert dieser Post das ausliefern des HTML über einen Dateiordner in einem Netzwerkpfad, der in den Inventor Applikationseinstellungen gesetzt werden muss.

Wie baut man als Laie Webseiten?

Die einfachste Wahl um schnell und dynamisch statisches HTML zu generieren sind sogenannte Static Site Generators, wie bspw. Hugo, der diesen Blog generiert, oder MkDocs.

In diesem Beispiel wird MkDocs verwendet. Da Webseiten, die mit MkDocs generiert sind ein wenig altbacken daher kommen, wird zusätzlich das feature-reiche MkDocs Material als Theme benutzt. Dieses Theme erzeugt zeitgemäßes responsives HTML im Material Design Look und bietet zusätzlich nützliche Funktionen, wie eine globale Suche, vielseitige Formatierungsoptionen, Diagramme oder Emoji-Support.

Was alle Static Site Generators eint ist die Tatsache, dass es nicht erforderlich ist HTML beherrschen zu müssen. Stattdessen wird auf eine vereinfachte Auszeichnungssprache (Markup Language) - in der Regel Markdown - zurückgegriffen, die von MkDocs in HTML übersetzt wird. Markdown benötigt nur eine handvoll leicht zu erlernender Anweisung zur Formatierung und Strukturierung von Textinhalten und wird einfach in Plain-Text-Dateien geschrieben und gespeichert.

Software Requirements

Um eine Webseite mit MkDocs zu erstellen, muss auf der Nutzermaschine folgende Software installiert sein. Für Python und Visual Studio Code sollten die Umgebungsvariablen (PATH) gesetzt werden. Dafür benötigt man in der Regel die Firmen IT mit Administratorrechten.

• Python, samt dem eigenen Paketmanager pip, muss installiert sein. pip ist in dem Python-Installer für Windows enthalten.

• Visual Studio Code als Text-Editor.

• Die offizielle Python Extension für Visual Studio Code.

  

• Optional, aber mit klarer Empfehlung: Die VSCode Extension Markdown All in One, die das Arbeiten mit Markdown durch Shortcuts erheblich erleichtert.

  

  Weitere empfohlene Extensions sind dem Projekt in der Datei .vscode/extensions.json beigelegt und können in VSCode über den Filter Recommended angezeigt und installiert werden:

  

MkDocs Starter Template

Um das Vorhaben zur Erstellung einer Team Web Webseite zu vereinfachen, habe ich eine minimale Starter-Template erstellt, die als Grundlage für alle folgenden Schritte gilt und unbedarften Usern als niederschwellige Einstiegshürde in die magische Welt der Static Site Generators dient.

Die Starter Template ist bei Github verfügbar und kann dort geforked oder als zip Archiv heruntergeladen werden:

schneekluth/teamweb-inventor-mkdocs

Das begleitende Repository zum Blogpost über die Erstellung eines Inventor Team Web mit MKDocs Material.

null

0

0

Die Ordnerstruktur der Starter Template sieht wie folgt aus:

teamweb-inventor-mkdocs/
├── docs/
│   ├── blog/
│   │   ├── posts/
│   │   │   └── 2023-05-23-beispiel.md
│   │   ├── .authors.yml
│   │   └── index.md
│   ├── assets/
│   │   ├── css/
│   │   │   └── extra.css
│   │   ├── banner.jpg
│   │   ├── favicon.ico
│   │   └── firmenlogo.svg
│   ├── img/
│   │   ├── hund.jpg
│   │   ├── katze.jpg
│   │   └── maus.jpg
│   └── index.md
├── includes/
│   ├── abbreviations.md
│   └── beispiel.xlsx
├── mkdocs.yml
├── requirements.txt
└── teamweb.code-workspace

Alle Dateien und Ordner und ihre Funktion:

Python Virtual Environment erzeugen

Python bietet eine Funktion namens Virtual Environments (venv), die es erlaubt Python-Pakete isoliert und projektspezifisch in bestimmten Versionen zu installieren. Somit wird vermieden, dass systemweit installierte Pakete mit denen von dem lokalen Team Web Projekt in Konflikt geraten.

Der einfachste Weg ein solches Virtual Environment anzulegen und die benötigten Pakete zu installieren ist über Visual Studio Code. Dazu einen Rechtsklick auf den Ordner teamweb-inventor-mkdocs/ machen und im Kontextmenü den Eintrag Mit Code öffnen auswählen:

Beim erstmaligen Öffnen wird Visual Studio Code einmalig Fragen, ob dem Autoren des Ordnerinhaltes vertraut werden soll. Diese Meldung muss mit einem Klick auf den Button Yes, I trust the authors bestätigt werden:

In VSCode muss nun die Tastenkombination STRG+SHIFT+P gedrückt werden. Es öffnet sich ein Eingabefeld, dass mit dem Zeichen > beginnt. In dieses Feld wird folgendes eingetippt: Python: Create Environment. Anschließend mit Enter bestätigen:

Anschließend fragt VSCode, welcher Typ von Environment erstellt werden soll. Es muss .venv ausgewählt und mit Enter bestätigt werden:

Im folgenden Schritt muss definiert werden, welcher Python Interpreter benutzt werden soll. An dieser Stelle muss der global installierte Python Interpreter ausgewählt werden:

Im letzten Schritt bietet Visual Studio Code die Möglichkeit an alle erforderlichen Python-Pakete und Abhängigkeiten zu installieren. Diese sind in der mitgelieferten Datei requirements.txt definiert. Es werden die folgenden Pakete installiert:

Die Datei requirements.txt muss explizit in der Checkbox aktiviert und anschließen mit OK bestätigt werden:

VSCode erstellt nun ein Virtual Environment samt aller benötigten Pakete und legt dieses im Ordner teamweb-inventor-mkdocs im Unterordner .venv/ an:

Nach der Installation sollte Visual Studio Code einmal geschlossen und anschließend über einen Doppelklick auf die Datei teamweb.code-workspace neu geöffnet werden. Der Grund ist, dass diese Datei Anweisungen für VSCode für die Arbeit mit Virtual Environments enthält, die aber gerade erst erzeugt wurden.

Das Terminal

Niemand sollte sich von der Arbeit mit dem Terminal abschrecken lassen. Ja, es wirkt in erster Linie immer einschüchternd und ja, es birgt gefahren und man kann sehr schnell Dummheiten anrichten. Unachtsamkeiten werden nicht verziehen und einen Rückgängig-Knopf wird man vergebens suchen. Das sollte aber kein Grund sein sich mit diesem mächtigen Werkzeug vertraut zu machen, mit dem die ersten Jahrzehnte Computer bedient wurden.

In heutiger Zeit sind Nutzer, insbesondere Windows-Nutzer, an grafische Klicki-Bunti-Oberflächen mit Knöpfen gewöhnt. Oberflächen, die keine Neugierde mehr wecken, was da eigentlich auf dem Computer gerade passiert. Für Linux-Nutzer ist das Terminal ein Werkzeug, das in den Alltag gehört wie Sand zwischen den Zehen an einem ausgiebigen Tag am Strand. Seid neugierig und wagt euch Dinge anders zu tun. Ein modernes Team Web baut man nun einmal nicht in Excel, Word oder PowerPoint.

Für die Arbeit mit MkDocs sollte ein PowerShell Terminal gewählt werden und nicht ein klassisches Command Prompt, da PowerShell mehr Annehmlichkeiten mit sich bringt, bspw. farblichen Terminal output. Visual Studio Code hat praktischerweise ein integriertes Terminal. Somit kann die Pflege des Team Web Contents und die Erzeugung des HTMLs direkt in einer Anwendung stattfinden.

Über die Menüleiste in VSCode kann mittels Terminal > New Terminal oder die Tastenkombination STRG+SHIFT+Ö eine neue Terminal Session geöffnet werden. Im unteren Bereich der Applikation öffnet sich nun ein integriertes Terminal-Fenster. An dieser Stelle kann geprüft werden, ob es sich um ein PowerShell-Terminal handelt:

Handelt es sich bei dem neuen Terminal Fenster nicht um ein Powershell Terminal, kann dies im Handumdrehen geändert werden:

Virtual Environment aktivieren

Wichtig: Python Virtual Environments müssen explizit pro Terminal-Session aktiviert werden, ansonsten wird nicht mit einer isolierten Umgebung für Pakete und Abhängigkeiten gearbeitet, sondern mit den global installierten Paketen.

Die gute Nachricht: Die Team Web Starter Template enthält in der Datei teamweb.code-workspace eine Anweisung, die eine automatische Aktivierung des Environments in jedem aktiven Terminal Fenster in Visual Studio Code vornimmt:

"python.terminal.activateEnvInCurrentTerminal": true

Wer sichergehen möchte ob das Virtual Environment aktiv ist, muss nur einen Blick ins Terminal werfen. Dies wird angedeutet durch einen grünen Text, der den Ausdruck .venv voranstellt:

Ist dies nicht der Fall kann einfach in Visual Studio Code die Datei teamweb.code-workspace angeklickt werden und auf den Button Open Workspace geklickt werden

oder man gibt folgendes Kommando in das Terminal ein:

.\.venv\Scripts\Activate.ps1

Webseitenstruktur

Die Webseitenstruktur wird über die zentrale Datei mkdocs.yml in der Sektion nav: mittel einer Sprache namens YAML definiert:

Dieses Kapitel in der MkDocs Material Dokumentation ist eine genauere Einsicht wert. Wer Beispielsweise oben keine horizontal angeordneten Tabs haben möchte, sollte sich die Sektion Setting Up Navigation genauer anschauen.

Workflow für die Arbeit am Teamweb

Ein normaler Workflow gestaltet sich so, dass man im ersten Schritt eine Änderung des Content einbringen möchte. Man startet dazu den lokalen Entwicklungsserver von MkDocs und kann prüfen, ob die eingebrachten Änderungen den eigenen Ansprüchen genügen. Ist letzteres der Fall wird der Entwicklungsserver beendet und MkDocs angewiesen das statische HTML zu generieren.

Entwicklungsserver Starten

MkDocs beinhaltet ein nützliches Feature um Änderungen an der Webseite direkt im Browser live zu begutachten. MkDocs nutzt dazu einen lokalen Server, der die Webseite über 127.0.0.1:8000 ausliefert. Um den Dev Server zu starten muss im Terminal folgendes Kommando ausgeführt werden:

mkdocs serve

Öffnet man nun den Webbrowser seines vertrauen und tippt als URL 127.0.0.1:8000 ein, erscheint ein Preview der Team Web Webseite. Ändert man eine Datei und speichert diese, lädt der Dev Server die Änderungen sofort neu durch und man kann das Ergebnis direkt im Browser begutachten:

Stoppen kann man den Dev Server mit der Tastenkombination STRG+C im aktiven Terminal-Fenster.

Log Messages beachten

Der Entwicklungsserver gibt kontinuierlich Rückmeldung in Form von Log Messages. Entsteht bspw. ein Fehler, der es nicht ermöglicht die Webseite zu bauen, erscheinen diese mit dem Präfix ERROR und müssen behoben werden:

Eine erfolgreiche Konfiguration hingegen wird über die Ausgabe INFO Documentation built in X seconds angezeigt:

Webseiten HTML erzeugen

Sind alle Änderungen eingebracht, ist es an der Zeit das statische HTML zu erzeugen. MkDocs stellt dafür das Kommando mkdocs build bereit. Diese erzeugt standardmäßig das HTML in einem neuen Unterordner namens site/ direkt im teamweb-inventor-mkdocs/ Ordner. Damit läge die Webseite aber nur lokal auf der eigenen Nutzermaschine und kann nicht global verfügbar an die User ausgerollt werden.

Es macht daher Sinn die IT auf einen Kaffee einzuladen und Schreibrechte auf einem öffentlich zugängigen Netzwerkpfad zu besorgen. Dieser Pfad muss dann für das Team Web in den Inventor-Einstellungen gesetzt werden.

Ist ein allgemein zugänglicher Netzwerkpfad vorhanden, kann MkDocs direkt angewiesen werden das HTML an dieser Stelle zu generieren und abzulegen. Dazu wird dem Kommando build die Option -d (Kurznotation für --site-dir) angestellt und der Netzwerkpfad angegeben:

Ein Beispiel für einen fiktiven Netzwerkpfad auf einer Maschine namens SERVER-X:

mkdocs build -d "\\SERVER-X\Teamweb"

Inventor Settings für Team Web

In den Inventor Application Settings findet sich im Reiter File eine Option den Pfad für das Team Web anzugeben. Dort wird nun einfach zu dem Netzwerkpfad navigiert und die Datei index.html angegeben.

Es ist durchaus sinnvoll den Haken bei der Checkbox Show Team Web on Startup zu setzen. Damit ist sichergestellt, dass jeder User einmal beim Neustart der Applikation das Team Web Fenster in Inventor sieht.

Tip: Wer direkt auf die Blog Sektion im Team Web verlinken möchte, um die User mit Neuigkeiten zu versorgen, kann dies auch einfach tun. Dazu den Eintrag in den Inventor-Einstellungen folgendermaßen abändern:

\\SERVER-X\Teamweb\blog\index.html

Et voilà! Schon befindet sich das erzeugte HTML direkt im Inventor:

Updates installieren

Sowohl MkDocs, also auch die verwendete Theme MkDocs Material erhalten fortlaufend updates. Updates können einfach über das Kommando pip install eingespielt werden. Dazu wieder in VSCode ein PowerShell Terminal aufrufen, sicherstellen dass das Virtual Environment aktiv ist und folgendes Kommando ausführen:

pip install -U --force-reinstall -r .\requirements.txt

Die Optionen für das Kommando pip install im Detail:

Anregungen

Ich habe dieses Jahr bei meinem derzeitigen Arbeitgeber ein solches Team Web in Inventor realisiert und etabliert. Die Vorteile lagen für mich mit der zentralen Bündelung und Durchsuchbarkeit von Informationen auf der Hand.

Sicherlich ersetzt ein Team Web kein Konstruktionshandbuch - erstrecht nicht in einem strukturell rückständigen Land wie Deutschland, in dem lineare Papierstrukturen auf Totholzerzeugnissen immer noch die Norm sind. Aber es ist ein einfach zu realisierender Gegenvorschlag, der einfach zu Pflegen ist und schnell und effizient fragmentierte Informationen bündeln kann.

Anwendungsfälle für Team Web

Da sich Anwendungsfälle immer schwer generalisieren lassen, sind im folgenden einige Anwendungsfälle aus meinem Berufsalltag gelistet:

• Troubleshooting: Ich sammle darin häufige Fehlermeldung aus Vault und Inventor, deren Ursachen und Lösungswege. Durch die eingebaute Suche können die User den Fehlermeldungstext direkt in das Suchfeld tippen und erhalten sofort den Link, der sie zur Lösung führt.

• FAQ / Anwenderfragen: Ich verwende eine eigene Sektion für Fragen von PDM-Benutzern. Oftmals traut sich der Anwender im Direktgespräche nicht zu Fragen und macht dann lieber irgendwelchen Quatsch. Ich habe in der Sektion einen Button, der direkt eine Mail-Template startet in denen die User Fragen stellen können. Sind diese von Relevanz oder tragen zum allgemeinen Verständnis bei, nehme ich sie in dieser Sektion auf.

• Vault Listeneinträge: Wer mit großen Listen in Autodesk Vault Properties arbeitet, kann ein Lied davon singen, dass diese nur schwer zu durchsuchen sind. Wir nutzen ein selbstgehacktes Export-Tool, dass mittels der Vault API alle Listeneinträge ausliest und in das CSV-Format konvertiert. Die CSV-Datei lassen wir automatisch von MkDocs einlesen und darstellen.

• News: Das Blog-Feature von MkDocs Material eignet sich hervorragend dafür User über anstehende Änderungen, Neuigkeiten oder einfach nur sinnvolle Tipps oder konstruktionsrelevante Youtube Tutorial zu informieren. Youtube Videos können direkt ohne Aufwand in der Webseite eingebunden werden. Ein Beispiel zur Einbindung ist in der Starter Template enthalten.

Weiterführende Gedanken

• Das von mir erstellte Template ist nur ein minimales Showcase, was die Theme MkDocs Material alles zu bieten hat. Die Dokumentation hat eine wunderbar anschauliche Sektion namens Reference, in der alle Funktionalität direkt an Beispielen erläutert werden. Ich kann diese Sektion jedem empfehlen, der meine Template erweitern möchte.

• Für die Arbeit in einem internationalen Unternehmen kann MkDocs Material auch eine mehrsprachige Dokumentation erstellen. Die Sprache kann dann - pro angezeigter Seite - über einen Language Selector ausgewählt werden. Bitte immer im Hinterkopf behalten, dass sich der Schreibaufwand und die Pflege der Inhalte pro zusätzlicher Sprache proportional erhöht.

• Das schöne an der Arbeit mit Markdown-Dateien ist, dass es schlichtweg schnörkellose ehrliche Plain-Text-Dateien sind und nicht verkopfte und überladene proprietäre Textdarstellungsformate wie Word-Dokumente. Die Natur einer Plain-Text-Datei erlaubt bspw. eine einfache Kollaboration mehrerer Bearbeiter mittel Git. So kann man effizient zusammen an einem Team Web arbeiten, mit dem zusätzlichen Obolus eine ISO-9001 konforme Änderungshistorie zur Hand zu haben, die durch den Git Server automatisch und ohne Mehraufwand erzeugt wird.

  MkDocs Material biete darüber hinaus sogar die Möglichkeit zur Anzeige älterer Versionsstände des Team Webs. Das sogenannte Versioning wird in diesem Fall mittels einer Software namens mike vollzogen.

• Kosten: Alle verwendeten Tools sind Open-Source und kostenfrei verfügbar. Ein Webserver sollte in jedem Unternehmen im 21. Jahrhundert bereits zur Verfügung stehen. Selbst wenn dies nicht der Fall ist kann man sich mit dem eingebauten IIS-Server von Windows behelfen und darüber das HTML bereitstellen. Während Microsoft gerade ihren Dienst Sharepoint für die nutzung als Intranet pusht, ist man mit einem lokal laufenden und selbstverwalteten Team Web mit MkDocs losgelöst von kontinuierlicher Kostensteigerung bei Microsoft und zusätzlich Herr über die bereitgestellten Daten.

• Das Erstellen eines Team Webs mit MkDocs bietet viele thematische Facetten und eine einfache Lernkurve, die sich auf zukünftige Projekte übertragen lassen, z.B.:

  • Das Arbeiten mit dem Terminal.
  • Der Umgang mit Python, Virtual Environments, sowie dem Paketmanager pip.
  • Das Arbeiten mit Visual Studio Code.
  • Das Arbeiten mit einem lokalen Entwicklungs-Server.
  • Das Erlernen von Markdown, das weit verbreitet Anwendung im Weltnetz findet.
  • Grundsätzliche Funktionsweisen von Static Site Generators.
  • Das Erstellen von Dokumentationen jenseits von gruseligen Bloatware-Anwendungen wie Microsoft Word.

Bei Custom Apps ist es, je nach Anwendungsfall, sinnvoll das MQTT-Flag retain: true zu setzen. Nur so ist gewährleistet, dass eine Custom App den Neustart der Pixelclock übersteht und persistent angezeigt wird. Custom Apps leben ansonsten nur im RAM des ESP32 und werden bei einem Neustart gelöscht. Das Retain-Flag bewirkt, dass der MQTT-Broker bei einer Neuverbindung der Pixelclock erneut, die zuletzt gesendete Message an diese übermittelt.

Wann macht es Sinn das Retain-Flag zu nutzen:
Wenn Sensor Daten sich nicht häufig aktualisieren und somit der Trigger in Homeassistant nicht häufig auslöst. Startet man in diesem Fall die Pixelclock neu, kann es unter Umständen sehr lange dauern, bis ein neuer Wert gesendet wird. Die Custom App wäre bis zu diesem Zeitpunkt nicht aktiv.

Wann macht es keinen Sinn das Retain-Flag zu setzen:
Wenn Custom Apps automatisch bei einem Trigger X entfernt werden, siehe Beispiel der Spotify App. Es macht keinen Sinn die letzten Wiedergabeinformationen eines Songs am Broker vorzuhalten, da diese Info flüchtig ist und sich häufig ändert und der Song ggf. gar nicht mehr abgespielt wird, wenn die Pixelclock neugestartet wird.

Custom Apps

Folgend eine List an Custom App, die im Zusammenspiel mit Homeassistant an die Pixelclock gesendet werden können. Alle Daten werden direkt aus Homeassistant generiert und benötigen keinerlei externe Add-Ons, wie bspw. Node Red.

Zu jeder Custom App ist ein Icon von der LaMetric Developer Website verlinkt. Der nachfolgende Dateiname entspricht der Benennung im Filesystem der Pixelclock.

Spotify

Dargestellt wird der aktuell abgespielte Künstler und Songname, sowie ein Fortschrittsanzeige (Progressbar) für den aktuell abgespielten Song. Die Progressbar wird aus zwei Attributen des Media-Players errechnet. Der Name des Media-Players muss entsprechend an den Namen der eigenen Entity in Homeassistant angepasst werden.

Die App wird automatisch entfernt, wenn der State des Media-Player auf idle oder paused wechselt und keine Wiedergabe mehr erfolgt.

Automation:

- alias: notify_pixelclock_spotify
  trigger:
    - platform: state
      entity_id: media_player.spotify
  action:
    - choose:
        - conditions:
            - condition: state
              entity_id: media_player.spotify
              state: 'playing'
          sequence:
            - service: mqtt.publish
              data:
                qos: 2
                retain: false
                payload: >-
                  {
                    "text": "{{ state_attr('media_player.spotify', 'media_artist') }} - {{ state_attr('media_player.spotify', 'media_title') }}",
                    "icon": "spotify",
                    "rainbow": false,
                    "duration": 10,
                    "pushIcon": 0,
                    "textCase": 2,
                    "progress": {{ ( states.media_player.spotify.attributes.media_position / states.media_player.spotify.attributes.media_duration * 100 ) | round() }},
                    "progressC": "18B04C"
                  }
                topic: pixelclock/custom/spotify
        - conditions:
            - condition: template
              value_template: "{{ not states.media_player.spotify.state == 'playing' }}"
          sequence:
            - service: mqtt.publish
              data:
                qos: 2
                retain: false
                topic: pixelclock/custom/spotify

pr0gramm

Zeigt den Benis eines beliebigen Accounts auf einem großen deutschen Imageboard, über das niemand spricht. Der Username, beispielhaft horst, muss entsprechend im API-Call angepasst werden.

Sensor:

- platform: rest
  scan_interval: 3600
  name: "Pr0 Benis"
  unit_of_measurement: ''
  value_template: '{{ value_json["user"]["score"] | int }}'
  resource: 'https://pr0gramm.com/api/profile/info?name=horst'

Automation:

- alias: notify_pixelclock_pr0
  trigger:
    - platform: state
      entity_id: sensor.pr0
  action:
    - service: mqtt.publish
      data:
        qos: 2
        retain: true
        payload: >-
          {
            "text": "{{ states.sensor.pr0.state }}",
            "icon": "pr0"
          }
        topic: pixelclock/custom/pr0

Wetter

Für diese Custom App sind diverse Icons erforderlich. Das exakte Vorgehen wurde bereits im vorhergehenden Post Ulanzi Smart Pixel Clock TC001 im Detail erläutert.

Die Temperatur wird ganzzahlig gerundet dargestellt.

Automation:

- alias: notify_pixelclock_weather
  trigger:
    - platform: state
      entity_id: weather.openweathermap
    - platform: template
      value_template: "{{ states.weather.openweathermap.attributes.temperature }}"
  action:
    - service: mqtt.publish
      data:
        qos: 2
        retain: true
        payload: >-
          {
            "text": "{{ states.weather.openweathermap.attributes.temperature | round(0) }} {{ states.weather.openweathermap.attributes.temperature_unit }}",
            "icon": "{{ states('weather.openweathermap') }}",
            "rainbow": false
          }
        topic: pixelclock/custom/weather

Bitcoin

Der aktuelle Kursstand des Bitcoins. Der Name des Sensors muss entsprechend angepasst werden.