QR-Code erstellen
QR-Code erstellen

Mach einen QR-Code für ein GitHub-Profil oder -Repo

Füge die Adresse ein, gestalte den Code passend zu Aufkleber oder Folie und lade ihn druckfertig herunter - gerichtet auf eine URL, die auch nach der nächsten Umbenennung noch auflöst.

1 Inhalt
https://
Keine Registrierung nötig Unbegrenzte QR-Codes Kein Wasserzeichen Free high-resolution downloads
2 Design
Form
Muster
Augen
3 Vorschau
Kopiert!

Was ist ein GitHub-QR-Code?

Ein GitHub-QR-Code ist ein QR-Code, der eine github.com-Adresse enthält - ein Profil, ein Repository, ein Release, einen Gist oder eine Datei zu einem bestimmten Commit. Beim Scannen öffnet sich diese Seite im Browser des Handys. GitHub verlangt zum Lesen eines Repositorys keine App, der Scan funktioniert also auf jedem Handy.

Der KoloQR-Designer mit einem QR-Code in Bearbeitung - Form, Farben und zentriertes Logo

Welche GitHub-URL gehört in den Code?

GitHub hat mehrere Adressen für dieselbe Sache, und sie altern sehr unterschiedlich:

  • github.com/owner/repo/releases/latest - leitet immer auf das neueste veröffentlichte Release weiter. Druck das auf Hardware und in Handbücher statt einer Versionsnummer, die binnen eines Monats falsch ist.
  • github.com/owner/repo/blob/<commit>/pfad - ein Permalink auf eine Datei im Zustand eines Commits. Ein y auf der Dateiseite schreibt die Branch-URL in diese Form um, und es ist der einzige Dateilink, der nicht verrotten kann.
  • github.com/owner/repo/blob/main/README.md - ein Branch-Link. Bequem, zeigt aber, was main beim Scannen enthält - bei einer gedruckten Referenz womöglich Jahre an Änderungen später.

GitHub behält Weiterleitungen, wenn ein Repository oder ein Konto umbenannt wird, ein gedruckter Code stirbt an einer Umbenennung also nicht zwangsläufig - aber die Weiterleitung hängt davon ab, dass der alte Name unbeansprucht bleibt, und ein freigegebener Nutzername kann von jemand anderem registriert werden. Für alles, was in Auflage gedruckt wird, ist das ein Grund, eine kurze URL auf einer Domain zu codieren, die dir gehört, und sie auf GitHub zeigen zu lassen - dann kostet ein Umzug eine Änderung an der Weiterleitung statt eines Nachdrucks.

Was der Scan auf einem Handy tatsächlich öffnet

Eine Repository-Seite auf dem Handy ist eine schmale Spalte: die Dateiliste, darunter die gerenderte README. Das liest sich gut, und deshalb funktioniert ein Code auf einem Konferenzaufkleber oder im Siebdruck einer Entwicklerplatine überhaupt. Zwei Dinge sollte man vor dem Druck wissen. Ein privates Repository zeigt Nicht-Angemeldeten eine 404 statt einer Anmeldeaufforderung - ein Code auf private Arbeit wirkt also kaputt statt geschützt; teste ihn von einem abgemeldeten Handy. Und eine Raw-URL auf raw.githubusercontent.com lädt herunter oder zeigt reinen Text, statt das Repository zu öffnen: richtig für eine Konfigurationsdatei, falsch für alles, was ein Mensch lesen soll.

QR-Code erstellen
Ein Handy scannt einen gedruckten QR-Code zum Test vor der Auflage

Wo GitHub-QR-Codes eingesetzt werden

Ein Code auf einem physischen Objekt ist der kürzeste Weg von Hardware, Papier oder einer Bühne zum Quellcode dahinter:

Konferenzaufkleber und Badges

Ein Aufkleber mit Code schlägt einen Repository-Namen, der von der Bühne vorgelesen und auf dem Heimweg halb vergessen wird.

Hardware und Entwicklerplatinen

Ein Code im Siebdruck auf der Platine oder auf der Verpackung zeigt auf das Firmware-Repository und sein neuestes Release - für die gesamte Lebensdauer des Geräts.

Gedruckte Dokumentation und Handbücher

Ein Handbuch ist an dem Tag veraltet, an dem es gedruckt wird. Ein Code auf den docs-Ordner des Repositorys ist die Fassung, die es nicht ist.

Folien und Workshop-Handouts

Ein Code auf der letzten Folie, gerichtet auf einen Permalink, damit das Beispiel, das die Leute kopieren, dasselbe ist, das sie gesehen haben.

Visitenkarten für Entwickler

Ein Profilcode trägt die Arbeit selbst statt einer Beschreibung davon - und darum geht es bei der Karte.

Poster bei Hackathons und Demo Days

Jury oder Besucherin scannt das Poster und hat das Projekt offen, bevor sie den nächsten Tisch erreicht.

So erstellst du einen GitHub-QR-Code

Vom Repository zum gedruckten Aufkleber in vier Schritten:

QR-Code erstellen
  1. 1

    Wähl die URL, die am besten altert

    Ein Profil für eine Karte, /releases/latest für Hardware und Handbücher, ein Commit-Permalink für einen Codeausschnitt. Vermeide Branch-Links und Versionsnummern in allem Gedruckten.

  2. 2

    Prüf, dass sie abgemeldet auflöst

    Öffne die URL in einem privaten Fenster. Ein privates Repository liefert eine 404 statt einer Anmeldeaufforderung - und genau das sieht auch deine Leserschaft.

  3. 3

    Link einfügen und Code gestalten

    Wähle den Typ URL, füge die Adresse ein, dann Form und Farben. Dunkle Module auf hellem Grund überstehen einen matten Aufkleber besser als ein invertiertes Paar.

  4. 4

    Testen und exportieren

    Scanne mit einem Handy und exportiere SVG oder PDF für Aufkleber und Siebdruck, PNG für Folien.

Der KoloQR-Generator mit einem QR-Code im Entwurf, bereit zum Herunterladen

Welches Dateiformat solltest du herunterladen?

KoloQR exportiert deinen GitHub-QR-Code in drei Formaten. Entscheide danach, wo er zu sehen sein wird:

  • PNG für Folien, READMEs und Doku-Websites, wo der Code in einer festen Größe erscheint.
  • SVG für Aufkleber, Siebdruckvorlagen und gedruckte Handbücher - alles, was skaliert wird, ohne die Kanten weich zu machen.
  • PDF für die Übergabe an eine Aufkleberdruckerei oder einen Platinenhersteller in druckfertiger Qualität.

Auf dieser Seite ist die Länge der Nutzlast das, worauf man achten muss. github.com/owner hat rund 25 Zeichen und druckt sich bequem klein; ein Commit-Permalink auf eine Datei tief im Baum kann 100 überschreiten und braucht dann ein größeres Symbol oder einen größeren Aufkleber. Muss ein langer Permalink auf etwas in Daumennagelgröße, setz eine kurze Weiterleitung auf deiner eigenen Domain davor.

QR-Code erstellen

Best Practices für GitHub-QR-Codes

Ein gedruckter Link auf eine Codebasis hat eine Aufgabe, die der Code selbst nicht erledigen kann: später noch zu stimmen.

  • Druck /releases/latest, keine Versionsnummer

    Diese Adresse leitet immer auf das neueste veröffentlichte Release weiter, sodass Handbuch oder Geräteaufkleber nie eine überholte Version nennen.

  • Nimm Commit-Permalinks für Codeausschnitte

    Ein Link auf eine Datei in einem Branch zeigt, was dieser Branch beim Scannen enthält. Ein Permalink auf einen Commit zeigt das, was du daneben gedruckt hast.

  • Prüf, dass private Repos eine 404 liefern

    GitHub fordert abgemeldete Besuchende nicht zum Anmelden auf für ein Repository, das sie nicht sehen dürfen. Ein Code auf private Arbeit wirkt außerhalb der Organisation kaputt.

  • Verlass dich bei langlebigem Druck nicht auf Umbenennungs-Weiterleitungen

    Ein umbenanntes Repository oder Konto hinterlässt eine Weiterleitung, aber nur solange der alte Name unbeansprucht bleibt. Siebdruck und Verpackung überdauern diese Garantie.

  • Halt die URL kurz genug für die Fläche

    Eine Profil-URL druckt sich bei 15 mm problemlos. Ein tiefer Permalink in derselben Größe ist ein dichteres Symbol auf denselben Quadratmillimetern - genau dort beginnen Scans zu scheitern.

  • Bevorzug die Repository-Seite gegenüber einer Raw-Datei

    Ein raw.githubusercontent.com-Link übergibt dem Handy reinen Text oder einen Download. Die Repository-Seite rendert die README - und danach hat der Mensch gescannt.

  • Beschrifte, wohin der Code führt

    „Firmware und Doku“ oder „Quellcode zu diesem Vortrag“ neben dem Code ist der Unterschied zwischen einem Scan und einem Schulterzucken.

  • Achte auf Kontrast bei dunklen Aufklebern

    Dunkle Module auf hellem Grund erwarten Handykameras. Muss der Aufkleber dunkel sein, teste die invertierte Fassung auf mehreren Handys, bevor du eine Auflage bestellst.

  • Schütz die Ruhezone

    Vier Module freier Rand auf jeder Seite - auf einem kleinen Aufkleber leicht verloren, wenn das Motiv bis zur Stanzlinie läuft.

  • Größe nach Leseabstand

    Ungefähr ein Zehntel des Leseabstands: rund 2 cm auf einem Laptop-Aufkleber, rund 20 cm auf einem Poster aus 2 Metern.

Warum dein GitHub-QR-Code nicht funktioniert

Das Muster ist auf dieser Seite selten das Problem. Die URL dahinter meist schon - entweder wegen dem, worauf sie zeigt, oder wegen ihrer Länge.

  • Der Scan zeigt eine 404-Seite

    Ursache
    Das Repository ist privat, oder es wurde umbenannt bzw. gelöscht und der alte Name inzwischen von jemand anderem übernommen, was die Weiterleitung entfernt.
    Lösung
    Mach das Repository öffentlich oder richte den Code stattdessen auf ein öffentliches Profil oder eine Doku-Seite. Für Gedrucktes in Auflage codiere eine Weiterleitung auf deiner eigenen Domain, damit das Ziel änderbar bleibt.

  • Der Code scannt auf einem kleinen Aufkleber nicht

    Ursache
    Es wurde ein tiefer Permalink oder ein langer Dateipfad codiert, das Symbol trägt also weit mehr Module, als ein 15-mm-Aufkleber auflösen kann.
    Lösung
    Kürz das Ziel - Profil, Repository-Wurzel oder /releases/latest - oder setz eine kurze URL auf deiner eigenen Domain davor, und generiere neu.

  • Der Scan lädt eine Datei herunter, statt eine Seite zu öffnen

    Ursache
    Die URL ist eine raw.githubusercontent.com-Adresse, die die Datei selbst ausliefert statt GitHubs gerenderter Seite dafür.
    Lösung
    Codiere stattdessen die Adresse github.com/owner/repo/blob/... Behalt Raw-Links für Maschinen - eine Konfiguration, die ein Skript abruft - statt für einen Menschen mit Kamera.

  • Der Code zeigt auf eine alte Version des Projekts

    Ursache
    Es wurde die URL eines getaggten Releases oder ein Branch-Link codiert, und das Projekt ist weitergezogen. Der Code tut genau das, was ihm gesagt wurde.
    Lösung
    Druck neu gegen /releases/latest für Downloads oder die Repository-Wurzel für den Quellcode. Beide folgen dem Projekt, statt es auf den Tag der Gestaltung festzunageln.

Immer noch unklar, ob die Datei oder der Druck schuld ist? Zieh das exportierte Bild in den QR-Code-Scanner - dekodiert es am Rechner, aber nicht auf Papier, ist der Fehler nach der Datei entstanden.

Questions? Answered

Ein GitHub-QR-Code enthält eine github.com-Adresse - Profil, Repository, Release oder Datei zu einem bestimmten Commit. Beim Scannen öffnet sich diese Seite im Browser. Für ein öffentliches Repository braucht es weder App noch Konto.

Ein Profil für eine Visitenkarte, github.com/owner/repo/releases/latest für Hardware und Handbücher, ein Commit-Permalink für einen Codeausschnitt. Vermeide Branch-Links und fixierte Versionsnummern im Druck.

GitHub leitet die alte Adresse auf die neue weiter, der gedruckte Code funktioniert also meist weiter - aber nur, solange der alte Name unbeansprucht bleibt. Registriert ihn jemand anders, endet die Weiterleitung.

Kannst du, aber abgemeldete Besuchende bekommen eine 404 statt einer Anmeldeaufforderung - der Code wirkt für alle außerhalb der Organisation kaputt. Richte öffentlichen Druck auf öffentliche Seiten.

Codiere github.com/owner/repo/releases/latest. GitHub leitet auf das neueste veröffentlichte Release weiter, sodass ein Code auf Gerät oder Handbuch nie eine überholte Version nennt.

Eine Profil- oder Repository-URL - rund 25 bis 40 Zeichen - druckt sich ab etwa 15 mm zuverlässig. Ein langer Commit-Permalink braucht ein größeres Symbol: gib ihm mehr Platz oder kürz vorher das Ziel.

Weil er eine raw.githubusercontent.com-URL enthält, die die Datei selbst ausliefert. Nimm die Adresse github.com/owner/repo/blob/..., wenn ein Mensch die Seite lesen soll statt eine Maschine die Datei zu holen.

Ja - exportier PNG und commite es wie jedes andere Bild. Es lohnt sich, wenn die README Hardware dokumentiert, damit gedrucktes Objekt und Repository denselben Code tragen.

Ja. Öffentliche Repositories rendern in jedem mobilen Browser, README inklusive. Die App ändert nichts daran, ob der Scan auflöst.

Nicht über den Code, und GitHubs Traffic-Insights decken nur Repositories ab, die dir gehören. Eine Weiterleitung auf deiner eigenen Domain ist der einzige verlässliche Weg, Scans einer bestimmten Auflage zu zählen.

Weiter stöbern

Seiten, die dort weitermachen, wo diese aufhört - dasselbe Umfeld, dieselbe Art von Code oder die nächste Entscheidung.

Google-Docs-QR-Code

Öffnet ein Dokument, ein Handout oder eine Vorlage direkt von einer gedruckten Seite.

Hochzeiten

Ein Code auf der Einladung, der Gäste zu deinem Zusage-Formular, dem Ablauf und der Anfahrt und danach zu einem geteilten Fotoalbum führt.

Schulen & Klassenzimmer

Einverständniserklärungen, Elternbriefe, Bibliothekslinks und Schülerarbeiten - mit den Druckgrößen und Datenschutzregeln, die eine Schule wirklich braucht.

YouTube-QR-Code

Führt Leute direkt zu einem Kanal, einem einzelnen Video, einer Playlist oder zum Abo-Dialog.

LinkedIn-QR-Code

Teile dein LinkedIn-Profil oder deine Unternehmensseite mit einem Code, den jede Handykamera lesen kann.

Formular-QR-Code

Öffnet eine Umfrage, eine Bewerbung oder eine Anmeldung von jedem Druckstück aus.

Warum KoloQR?

  • Erstelle QR-Codes für Websites, Speisekarten, Wi-Fi, PDFs und Visitenkarten
  • Passe Farben, Logos und einzigartige Formen an
  • Lade hochwertige PNG- und SVG-Dateien herunter
  • Für Print und Digital gemacht
QR-Code erstellen
Ein einfacher schwarzer QR-Code neben demselben Code, umgestaltet als Kreis mit Markenfarben