Sternsucher v1.8

1. Wozu das Programm da ist

Auf GitHub liegen Millionen offener Programme. Wer dort etwas Bestimmtes sucht – ein Sicherungswerkzeug, einen PDF-Editor, eine Bildbearbeitung –, bekommt über die Website zwar Treffer, muss die Sortierung aber jedes Mal von Hand umstellen und kann Ergebnisse nicht ohne Weiteres mitnehmen.

Sternsucher nimmt diese Arbeit ab: Suchbegriff eingeben, gegebenenfalls Sprache und Mindestanzahl an Sternen festlegen – und die Trefferliste erscheint bereits nach Sternen sortiert. Ein Doppelklick öffnet das Projekt im Browser, und die ganze Liste lässt sich als Tabelle oder als HTML-Seite speichern.

2. Starten – welche Datei wofür

Wichtig: Weiterzugeben oder zu verschieben ist immer der gesamte Ordner Sternsucher, nicht nur die EXE-Datei allein. Neben der EXE liegt ein Unterordner _internal mit den Programmbibliotheken; ohne ihn startet die EXE nicht. (Das ist die Bauform „onedir". Eine Einzeldatei wäre zwar bequemer zu verschicken, müsste aber bei jedem Start die komplette Qt-Bibliothek in einen temporären Ordner auspacken – der Start dauert dann spürbar länger.)

Die anderen Startwege

3. Bedienung

1. Suchbegriff eingeben in das große Feld oben, etwa pdf editor, backup oder markdown editor. Englische Begriffe führen meist zu deutlich mehr Treffern, weil die allermeisten Projektbeschreibungen auf Englisch verfasst sind.
2. Eingabetaste drücken oder auf Suchen klicken.
3. Trefferliste lesen. Sie ist voreingestellt nach Sternen sortiert, das meistbeachtete Projekt steht oben.
4. Sortierung ändern durch Klick auf einen Spaltenkopf – etwa auf Zuletzt aktiv, um die am besten gepflegten Projekte nach oben zu holen.
5. Projekt öffnen per Doppelklick auf die Zeile. Der Standardbrowser öffnet die GitHub-Seite.
6. Download holen per Doppelklick auf die Spalte Download – siehe Abschnitt 8.
7. Rechtsklick auf eine Zeile öffnet ein Menü mit Projektseite, Releases, Quellcode-ZIP und den zugehörigen Adressen zum Kopieren.

Die Maus kurz über einem Projektnamen stehen zu lassen, blendet einen Hinweis mit voller Beschreibung, den GitHub-Themen und – bei eingeschalteten ähnlichen Begriffen – dem Suchbegriff ein, über den das Projekt gefunden wurde.

Die Statuszeile unten

Ganz unten gibt es genau eine Zeile: links stehen die Meldungen des Programms (Trefferzahl, verwendete Suchbegriffe, verbleibendes Kontingent, Fehler), rechts der Fortschrittsbalken und die Knöpfe CSV speichern, HTML speichern und Handbuch. Ist eine Meldung zu lang für die Zeile, zeigt sie vollständig, wer die Maus kurz darüber stehen lässt.

Tastenkürzel

4. Die Filter im Einzelnen

Die zuletzt benutzten Filter werden beim Beenden gemerkt und stehen beim nächsten Start wieder da.

5. Ähnliche Begriffe mitsuchen

Projektbeschreibungen auf GitHub sind fast ausnahmslos englisch. Wer Bildbearbeitung eingibt, findet deshalb so gut wie nichts – image editor dagegen hunderte Projekte. Genau diese Lücke schließt das Häkchen auch ähnliche Begriffe.

Wie viel jeder Begriff kostet

• Der eigene Begriff holt so viele Treffer, wie unter max. Treffer eingestellt ist – wie bisher je 100 Treffer eine Anfrage.
• Jeder ähnliche Begriff holt genau eine Seite, also höchstens 100 Treffer, und kostet damit genau eine Anfrage.
• Passt das Ganze nicht ins Minutenkontingent, lässt das Programm ähnliche Begriffe von hinten weg und nennt sie in der Statuszeile („aus Kontingentgründen nicht mitgesucht: …"). Beispiel ohne Token: bei max. Treffer 1.000 braucht der eigene Begriff schon alle zehn Anfragen – dann wird kein ähnlicher Begriff mitgesucht. Mit Token (30 Anfragen) passt es.

Was das Programm mitsucht, bleibt sichtbar

Nach jeder Suche nennt die Statuszeile die Trefferzahl je Begriff („87 Treffer aus 4 Suchen (bildbearbeitung 0 · image editor 1.234 · …)"). So ist sofort erkennbar, welcher Begriff überhaupt etwas gebracht hat. Findet die Suche gar nichts, stehen die tatsächlich gesendeten Abfragen in der Statuszeile. Die vollständigen Abfragen stehen außerdem im Kopf jeder gespeicherten HTML-Seite, und die CSV-Datei hat eine Spalte Gefunden über.

Wenn einer der Abrufe scheitert

Scheitert eine einzelne Suche (etwa weil GitHub einen Begriff ablehnt), macht das Programm mit den übrigen weiter und meldet den Fehler. Ist das Kontingent erschöpft, stellt es keine weiteren Anfragen mehr; was bis dahin geladen war, bleibt in der Tabelle stehen.

Wann das Häkchen nichts tut

• Wenn zum eingegebenen Wort nichts hinterlegt ist – dann wird schlicht wie bisher mit einer einzigen Anfrage gesucht.
• Zusammen mit nur im Projektnamen suchen. Dort wäre eine Erweiterung sinnwidrig: der Filter soll ja gerade eng machen.

Eingabehilfe

Das Suchfeld schlägt beim Tippen die bekannten Begriffe vor. Seit Version 1.8 erscheinen dabei auch die englischen Entsprechungen, jeweils mit dem deutschen Begriff dahinter:

bildbearbeitung
image editor  ·  bildbearbeitung
photo editor  ·  bildbearbeitung

Wer bild eintippt, sieht also sofort, dass sich image editor anbietet. Beim Auswählen wird nur der Teil vor dem Punkt eingesetzt – im Suchfeld steht dann image editor, ohne den deutschen Zusatz.

Eigene Begriffe ergänzen

Die Liste liegt als sternsucher_synonyme.json neben dem Programm und lässt sich mit jedem Texteditor erweitern. Aufbau:

{
  "bildbearbeitung": ["image editor", "photo editor"],
  "mein begriff":    ["englisches stichwort", "noch eines"]
}

Nach dem Bearbeiten das Programm neu starten – die Datei wird beim Start eingelesen. Höchstens fünf Stichwörter je Begriff werden mitgesucht. Das hat zwei Gründe: Jedes weitere Stichwort holt erfahrungsgemäß Projekte herein, die mit dem ursprünglichen Anliegen wenig zu tun haben – und jedes kostet eine eigene Anfrage. Stichwörter aus mehreren Wörtern (image editor) werden als Wortfolge gesucht, also in Anführungszeichen.

6. Grenzen der GitHub-Suche

Diese Grenzen setzt GitHub, nicht das Programm. Sie sind unveränderlich:

Ist das Kontingent erschöpft, meldet das Programm das im Klartext und nennt die Wartezeit. Es hilft dann nur warten – oder ein Token hinterlegen.

7. Zugriffstoken (optional)

Wer trotzdem eins hinterlegen will:

1. Auf github.com/settings/tokens ein Token erzeugen („Generate new token", klassische Variante genügt).
2. Keinen einzigen Haken bei den Berechtigungen setzen. Für die reine Suche in öffentlichen Projekten braucht es keine. Ein Token ohne Berechtigungen kann nichts lesen und nichts ändern, was nicht ohnehin öffentlich ist.
3. Im Programm Bearbeiten → Zugriffstoken öffnen, das Token einfügen, bei Bedarf speichern ankreuzen.

8. Download-Spalte: Programme holen

Die Spalte Download führt direkt dorthin, wo ein Projekt seine fertigen Programme ablegt. Ein Doppelklick auf den blauen Eintrag Releases öffnet die Releases-Seite des Projekts im Browser.

Zwei Wege, und wofür sie taugen

In der CSV- und der HTML-Ausgabe sind beide Adressen als eigene Spalten enthalten, in der HTML-Ausgabe direkt anklickbar.

9. Speichern als CSV und HTML

CSV – für Excel und Tabellenkalkulationen

Strg+E oder der Knopf CSV speichern. Die Datei verwendet Semikolon als Trennzeichen und UTF-8 mit Kennung, damit Excel die Umlaute auf Anhieb richtig anzeigt und die Spalten korrekt trennt – ein Doppelklick auf die Datei genügt, der Importassistent ist nicht nötig.

HTML – zum Lesen und Weitergeben

Strg+H oder HTML speichern. Erzeugt eine eigenständige Seite mit klickbaren Links, die sich in jedem Browser öffnen und per E-Mail weitergeben lässt. Die verwendete Suchabfrage – bei ähnlichen Begriffen alle getrennten Abfragen – steht im Kopf der Seite, sodass später nachvollziehbar bleibt, wonach gesucht wurde.

10. Was Sterne aussagen – und was nicht

Ein Stern auf GitHub ist ein Lesezeichen. Jemand hat das Projekt einmal interessant gefunden. Daraus folgt:

Sterne werden fast nie wieder entfernt. Ein Projekt, das 2019 aufgegeben wurde, behält seine 20.000 Sterne für immer – und steht damit dauerhaft über einem aktiv gepflegten Projekt mit 300 Sternen, das die bessere Wahl wäre.

11. Dateien im Programmordner

12. Wenn etwas nicht funktioniert

„Keine Verbindung zu GitHub möglich"

Internetverbindung prüfen. In Firmennetzen blockiert häufig eine Firewall oder ein Proxy den Zugriff auf api.github.com – die Website github.com im Browser zu erreichen bedeutet nicht zwingend, dass auch die Schnittstelle erreichbar ist.

„Das Anfragekontingent ist erschöpft"

Die angegebene Zeit abwarten. Tritt es häufig auf: weniger Treffer je Suche anfordern, ein Token hinterlegen (Abschnitt 7) oder für schnelle Folgesuchen auch ähnliche Begriffe abschalten – jeder ähnliche Begriff kostet eine eigene Anfrage.

„GitHub konnte die Suchabfrage nicht verarbeiten"

Meist ein zu allgemeiner Suchbegriff. Begriff genauer fassen oder einen Filter ergänzen.

Keine Treffer, obwohl es das Gesuchte geben müsste

Zuerst in der Statuszeile nachsehen, welche Abfrage tatsächlich gesendet wurde – sie steht dort bei null Treffern ausdrücklich. Dann der Reihe nach: auch ähnliche Begriffe einschalten – englischen Begriff probieren – mind. Sterne auf 0 setzen – aktiv auf „egal" stellen – nur im Projektnamen suchen abwählen.

Die EXE startet nicht

Wurde der gesamte Ordner kopiert, einschließlich _internal? Manche Virenscanner sperren frisch gebaute PyInstaller-Programme vorsorglich – im Zweifel den Ordner in der Ausnahmeliste eintragen.

Etwas verhält sich seltsam

test_sternsucher_v1_8.bat starten. Der Selbsttest prüft die Programmlogik durch und meldet, wo es klemmt. Alternativ das Programm über start_sternsucher_v1_8.bat starten – dort bleibt ein Konsolenfenster offen, in dem Fehlermeldungen sichtbar werden.

13. Versionshistorie