CLI-Tool
zws-im/zws avatar
zws-im/zws

ZWS: Unsichtbare Zeichen als Kurzlink mit klaren Prüfgrenzen

Projektüberblick: Kürzen Sie URLs mit unsichtbaren Leerzeichen. Einzelpersonen Organisationen [Unterstützen Sie dieses Projekt mit Ihrer Organisation][offenes Kollektiv].

1.847 Sterne148 ForksTypeScriptApache-2.0

Auf einen Blick

Was ist das?
ZWS verkürzt URLs über unsichtbare Leerzeichen und stellt dafür Webdienst, CLI-Verweis und OpenAPI-Dokumentation bereit.
Für wen ist es gedacht?
ZWS passt zu kleinen, bewusst ungewöhnlichen Kurzlink-Szenarien, wenn Empfänger und Transportweg unsichtbare Unicode-Zeichen unverändert bewahren. Vor einer Veröffentlichung sollte eine echte URL über die gewünschte zws.im-Instanz und den vorgesehenen Kanal laufen; danach sind Weiterleitung, Kopierverhalten und API-Antwort zu prüfen.
Darf ich es kommerziell nutzen?
Ja. Apache-2.0 ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
Wird es noch gepflegt?
Ja. Das Repository hat innerhalb des letzten Tages neue Commits erhalten.
In welcher Sprache ist es geschrieben?
Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 18. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

Die eigentliche Idee hinter ZWS

Das README beschreibt Zero Width Shortener als Dienst zum Kürzen von URLs mit unsichtbaren Leerzeichen. Der Link sieht damit nicht wie ein gewöhnlicher Kurzlink aus. Die technische Besonderheit liegt gerade in Zeichen, die Nutzer beim Lesen nicht erkennen. Das Repository nennt zws.im als Online-Einstieg und verweist zusätzlich auf eine CLI. Eine lokale Installationsanleitung mit konkretem Befehl enthält der bereitgestellte README-Text nicht. Deshalb lässt sich aus dem Repository der Funktionsumfang des Dienstes ablesen, nicht aber ein vollständiger selbst gehosteter Betriebsweg.

Transport ist hier Teil der Funktion

Bei einem Kurzlink mit unsichtbaren Zeichen entscheidet der Transportweg über die Nutzbarkeit. Kopieren, Einfügen, Normalisierung durch Anwendungen und Darstellung in verschiedenen Editoren können den relevanten Inhalt verändern. Das README beschreibt diese Randbedingungen nicht. Ein Test sollte deshalb eine kurze und eine längere Zieladresse über genau den Kanal schicken, in dem der Link später verteilt wird. Zu beobachten sind die unveränderte Zeichenfolge, die Weiterleitung im Browser und das Verhalten nach erneutem Kopieren. Diese Prüfung betrifft ZWS selbst, weil sein Kernmerkmal nicht sichtbar ist.

API statt vermuteter Interna

Unter API Documentation verweist das Projekt auf ein OpenAPI-Schema und eine API-Dokumentation unter zws.im/api-docs. Das ist der belastbarste technische Einstieg für Clients. Das README nennt keine konkreten Pfade, Authentifizierung, Rate Limits oder Fehlercodes. Solche Details sollten daher aus dem Schema gelesen und nicht aus dem Projektnamen abgeleitet werden. Für einen Integrationsversuch ist es sinnvoll, die dort beschriebene Anfrage mit einer kontrollierten Zieladresse auszuführen und die Antwort samt Statuscode zu speichern. Erst daraus ergibt sich, ob die gewünschte Automatisierung mit dem dokumentierten Vertrag übereinstimmt.

Statistik-Endpunkte mit begrenzter Aussage

ZWS-Instanzen stellen laut README Routen nach dem Shields-Endpoint-Schema bereit. /stats/shields/urls zählt verkürzte URLs, /stats/shields/visits besuchte URLs. Diese Angaben sind für ein Badge geeignet und erlauben eine grobe Beobachtung des Dienstes. Sie sind kein Nachweis für Verfügbarkeit, Klickqualität oder Datenschutz. Wer diese Endpunkte einbindet, sollte die JSON-Antwort, Aktualisierung und mögliche Sichtbarkeit der Zahlen an der gewünschten Instanz prüfen. Das Repository beschreibt weder Aufbewahrung noch Auswertung der Zieladressen oder Besuchsdaten.

Betrieb, Pflege und Vertrauensfragen

Die Metadaten nennen TypeScript, den Branch main, Apache-2.0, 1847 Sterne, 148 Forks und drei offene Issues. Der letzte dokumentierte Push liegt am 8. November 2021. Diese Werte beschreiben den Stand der Erfassung und sind kein Qualitätszertifikat. Für einen Dienst mit versteckten Links sind zusätzlich Moderation, Missbrauchserkennung, Erreichbarkeit und Umgang mit Logs relevant; das README macht dazu keine Zusagen. Die finanzielle Unterstützung über Open Collective sagt ebenfalls nichts über eine Betriebsvereinbarung aus. Ein produktiver Einsatz braucht deshalb eine eigene Prüfung der konkreten Instanz.

Apache-2.0 und die praktische Auswahl

Die Metadaten weisen Apache-2.0 aus. Für eine Weitergabe oder Änderung des Codes bedeutet das typischerweise, dass Lizenz- und NOTICE-Hinweise beachtet und bestehende Haftungs- oder Markenhinweise nicht entfernt werden dürfen. Das klärt nicht, ob unsichtbare Links zu einer Organisation, einem Mailprogramm oder einem Archivformat passen. ZWS ist interessant, wenn die unsichtbare Darstellung selbst der Zweck ist. Für Barrierefreiheit, manuelle Kontrolle oder dauerhafte Nachvollziehbarkeit ist ein sichtbarer, normaler Kurzlink meist leichter zu betreiben. Diese Auswahl folgt aus der dokumentierten Technik, nicht aus Sternzahlen. Praktisch sollte auch bedacht werden, dass ein Empfänger den Link nicht visuell auf sein Ziel untersuchen kann. Ein Team braucht daher eine sichtbare Begleitbeschriftung und einen Prozess, der Zieladressen vor dem Versand festhält. Der Dienstname zws.im und die OpenAPI-Seite sind konkrete Anlaufstellen, doch das README beschreibt weder Konten noch eine Zusage zur Verfügbarkeit. Wer den Dienst als zentrale Weiterleitung einsetzen will, muss diese Lücke in der eigenen Risikoentscheidung berücksichtigen. Für einen kleinen privaten Versuch ist die Hürde geringer, weil sich jede erzeugte Adresse direkt mit dem vorgesehenen Browser und Kopierweg kontrollieren lässt.

Fehlende Rückfallebene bei Zeichenverlust

Das README beschreibt keine Wiederherstellung, falls ein Programm die unsichtbaren Zeichen entfernt. Dieser offene Punkt betrifft ZWS unmittelbar: Ein sichtbarer Prüfwert oder ein zweiter, normaler Link ist im Material nicht genannt. Für den kontrollierten Einsatz sollte das Team deshalb vorab festlegen, wie eine beschädigte Adresse erkannt und ersetzt wird. Diese Regel gehört zum konkreten Versandprozess und darf nicht nur auf die Darstellung im Browser vertrauen.

Redaktionelles Fazit

ZWS passt zu kleinen, bewusst ungewöhnlichen Kurzlink-Szenarien, wenn Empfänger und Transportweg unsichtbare Unicode-Zeichen unverändert bewahren. Vor einer Veröffentlichung sollte eine echte URL über die gewünschte zws.im-Instanz und den vorgesehenen Kanal laufen; danach sind Weiterleitung, Kopierverhalten und API-Antwort zu prüfen. Für nachvollziehbare Marketing- oder sicherheitskritische Links ist die Methode erst nach eigener Kompatibilitätsprüfung vertretbar.

Offizielle Quellen

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Community-Notizen

Community-Notizen