Starter
FreeDer Starter startet, was dein Projekt starten kann: Dev-Server, Skripte, Konsolenbefehle, Tests. Er erkennt sie aus package.json, composer.json, Makefile und weiteren Dateien, und du kannst eigene anlegen. Von selbst startet nichts. Vor dem ersten Start in einem Projekt zeigt der Editor dir den genauen Befehl.
Was du hier machst
- Sehen, was der Editor in deinem Projekt gefunden hat, und es starten: Erkannte Starter.
- Eigene Befehle anlegen und Dateien direkt ausführen: Eigene Starter.
- Verstehen, wann der Editor vorher fragt, und das Vertrauen zurücknehmen: Vertrauen.
- Mit ⌃R und der Startleiste arbeiten, die Einstellungen anpassen: Kürzel und Leiste.
Aufbau
- Startleiste in der Titelleiste: der gewählte Starter mit Statuspunkt, ▶ zum Starten (während er läuft ↻ zum Neustarten), ■ zum Stoppen und Im Browser öffnen, sobald eine Adresse auftaucht.
- Werkzeugfenster Starter: die Abschnitte Erkannt, Eigene und Ausgeblendet als Liste.
- ▶ im Projektbaum: beim Überfahren einer ausführbaren Datei oder eines Ordners mit Startern.
Wo die Ausgabe landet
Jeder Lauf schreibt in einen eigenen Kanal unter Probleme & Ausgabe, Reiter Ausgabe. Der Kanal trägt den Namen des Starters und bleibt stehen, wenn der Lauf endet. Braucht ein Programm Eingaben, holst du es mit Im Terminal samt bisheriger Ausgabe ins Terminal. Mehr: Ausgabe.
Free und Premium
Der Starter ist frei.
Erkannte Starter Free
Beim Öffnen eines Projekts liest der Editor seine Dateien und listet, was sich starten lässt: npm-Skripte, Composer-Skripte, Makefile-Targets, Konsolenbefehle von Symfony, Shopware und Laravel und vieles mehr. Gestartet wird erst auf deinen Klick.
So findest du es
- Werkzeugfenster Starter, Abschnitt Erkannt. Öffnen kannst du es über sein Symbol in der Leiste oder in der Befehlspalette mit Starter anzeigen.
- In der Startleiste der Titelleiste: Klick auf den Namen des Starters öffnet das Menü aller Starter.
So gehst du vor
- Öffne ein Projekt und das Fenster Starter.
- Unter Erkannt stehen die Starter, gruppiert nach der Datei, die sie definiert, etwa
package.jsonodercomposer.json. Die WebDonkey-Site des Projekts steht unter WebDonkey. - Fahre mit der Maus über eine Zeile und klicke Starten (▶). Ein Doppelklick startet ebenfalls.
- Die Ausgabe erscheint unter Probleme & Ausgabe im Reiter Ausgabe.
- Läuft der Starter, stoppst du ihn mit Stoppen (■) oder startest ihn mit Neu starten (↻) neu.
Die Liste
Jede Zeile zeigt einen Statuspunkt, den Namen und den Befehl. Der Punkt ist grün bei Läuft, grau bei Beendet und rot bei Beendet mit Code …. Der wichtigste Starter eines Frameworks trägt das Zeichen Haupt (Haupt-Starter).
Oben im Fenster:
- Starter filtern: sucht in Namen und Befehlen.
- Schild-Symbol (Vertraut, Klick nimmt es zurück): nur bei vertrauten Projekten, siehe Vertrauen.
- + (Neuer Starter…): legt einen eigenen Starter an.
- Neu erkennen: liest das Projekt noch einmal.
bin/console und artisan klappst du auf. Ihre Befehle lädt der Editor erst dann („Befehle werden geladen…“). Dauert das länger als 30 Sekunden, bricht er ab.
Das Kontextmenü einer Zeile bietet Starten bzw. Neu starten, Stoppen, Im Browser öffnen, Befehl kopieren, Als eigenen Starter kopieren… und Löschen (ausblenden). Ausgeblendete Starter landen unter Ausgeblendet und kommen mit Wiederherstellen zurück.
Quellen
Was der Editor erkennt, schaltest du unter Einstellungen › Starter › Quellen je Quelle ein und aus. Ab Werk sind alle an.
| Quelle | Was dazugehört |
|---|---|
| package.json-Skripte | npm, pnpm, yarn oder bun, je nachdem, was die Lock-Datei sagt, auch für Workspaces |
| Frameworks (Haupt-Starter und Dev-URL) | Vite, Next, Nuxt, Astro, SvelteKit, Angular und Tauri: welches Skript das Haupt-Skript ist und unter welcher Adresse es läuft |
| composer.json-Skripte | alle Skripte außer Composers eigenen pre- und post-Hooks |
| Symfony-, Shopware- und Laravel-Konsole | Befehle von bin/console und artisan, geladen erst beim Aufklappen, dazu Shopwares Build- und Watch-Skripte |
| Makefile, justfile, Taskfile, deno.json | Targets und Tasks aus diesen Dateien |
| Python | pyproject-Skripte, Djangos manage.py, FastAPI- und Flask-Apps, gestartet mit uv, Poetry oder dem venv des Projekts |
| Docker Compose, DDEV, Procfile | docker compose up, auch je Dienst, ddev start und launch, jeder Prozess aus dem Procfile |
| Cargo, Go, Gradle, Maven, .NET, Swift, Flutter, Mix | cargo run, go run, gradlew, mvn, dotnet run und Verwandte |
| VS-Code-Tasks und IntelliJ-Run-Konfigurationen | übernommen, soweit sie sich als Befehl ausdrücken lassen |
| WebDonkey-Site | startet die Dienste der Site in WebDonkey |
Im Browser öffnen
Taucht in der Ausgabe eines Starters eine Adresse auf, etwa die Dev-URL von Vite, erscheint Im Browser öffnen an der Zeile und in der Startleiste. Ein Klick öffnet die Adresse in deinem Browser. Startest du die WebDonkey-Site, startet WebDonkey ihre Dienste, der Editor meldet „… läuft in WebDonkey.“ und bietet danach Im Browser öffnen für die Site an.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| „Port … ist belegt von … (PID …).“ | Ein anderer Prozess hört schon auf dem Port | Den anderen Prozess beenden oder einen anderen Port wählen |
| „… fehlt“ | Der Starter braucht ein Programm, das auf diesem Mac nicht zu finden ist | In WebDonkey installieren, Mit Homebrew installieren oder Download-Seite öffnen. Installiert wird nur, wenn du es sagst. |
| „Die Erkennung ist in den Einstellungen ausgeschaltet.“ | Starter erkennen ist aus | Unter Einstellungen › Starter wieder einschalten |
| „In diesem Projekt gibt es nichts zu starten.“ | Keine Quelle hat etwas gefunden | Einen eigenen Starter anlegen |
| „WebDonkey läuft nicht.“ | Die WebDonkey-Site braucht das laufende WebDonkey. Der Editor versucht, es zu starten, das hat nicht geklappt. | WebDonkey von Hand starten und noch einmal versuchen |
Siehe auch
Eigene Starter Free
Was der Editor nicht von selbst erkennt, legst du als eigenen Starter an: einen Befehl mit Argumenten, Arbeitsordner und Umgebungsvariablen, auf Wunsch mit einem anderen Starter, der vorher laufen soll. Einzelne Dateien führst du auch ohne Starter direkt aus.
So findest du es
- Rechtsklick auf eine Datei oder einen Ordner im Projektbaum: Als Starter anlegen…
- Rechtsklick auf das ▶ im Projektbaum: Weiteren Starter anlegen… (gibt es dort noch keinen: Als Starter anlegen…)
- Werkzeugfenster Starter: + (Neuer Starter…)
- Menü der Startleiste und Befehlspalette: Neuer Starter…
So gehst du vor
- Klicke mit der rechten Maustaste auf eine Datei oder einen Ordner und wähle Als Starter anlegen….
- Der Dialog Als Starter anlegen ist vorausgefüllt: Bei einer Datei mit Namen und dem passenden Programm, bei einem Ordner mit dem Ordner als Arbeitsordner.
- Prüfe die Felder und klicke Speichern.
- Der Starter steht unter Eigene im Starter-Fenster und im Menü der Startleiste.
Felder
| Feld | Was hinein gehört |
|---|---|
| Name | wie der Starter in Listen und Menüs heißt |
| Befehl | das Programm, etwa npm oder php |
| Argumente | alles nach dem Programm, wie in der Shell: Leerzeichen trennen, Anführungszeichen fassen zusammen. Der Editor zerlegt die Zeile in einzelne Argumente und führt sie nie als Shell-Text aus. |
| Arbeitsordner (relativ zum Projekt) | leer heißt Projektordner |
| Umgebungsvariablen (NAME=Wert, eine pro Zeile) | zusätzliche Variablen für diesen Lauf |
| .env-Datei | eine Datei mit Variablen, etwa .env |
| Vorher starten | ein anderer Starter, der zuerst laufen soll, oder Nichts. Läuft er schon, startet der Editor ihn nicht noch einmal. |
Ordner und Dateien müssen im Projekt liegen. Ein Projekt kann bis zu 200 eigene Starter haben.
Bearbeiten und löschen
- Im Starter-Fenster: Rechtsklick auf die Zeile, Bearbeiten… oder Löschen.
- Im Projektbaum: Rechtsklick auf die Datei oder den Ordner, Starter „…“ bearbeiten… und Starter „…“ löschen. Hat ein Ordner mehrere eigene Starter, stehen sie unter Starter bearbeiten und Starter löschen.
Läuft der Starter noch, fragt der Editor: „Beim Löschen wird der laufende Prozess gestoppt. Seine Ausgabe bleibt unter „Probleme & Ausgabe“ stehen.“ Bestätige mit Stoppen und löschen.
Einen erkannten Starter kannst du nicht bearbeiten, aber mit Als eigenen Starter kopieren… als eigenen übernehmen und dann ändern.
Datei ausführen
Rechtsklick auf eine Datei und Datei ausführen, ▶ im Projektbaum oder ⌃⇧R für die Datei im aktiven Tab. Der Editor nimmt das Programm aus der Shebang-Zeile, sonst aus der Endung: bash für .sh, php für .php, node für .js, python3 für .py, dazu Ruby, Perl, Lua, Go, Swift, Kotlin-Skripte, R, Julia, PowerShell, Dart, Elixir, AppleScript und weitere. Die Datei läuft vom Projektordner aus, mit ihrem Pfad relativ dazu.
Drei Arten öffnet der Editor, statt sie auszuführen:
.sqlöffnet eine SQL-Konsole im Fenster Datenbank, mit der Datenbank der Site, sonst mit einer laufenden lokalen Verbindung..httpöffnet den API-Client von WebDonkey. Dafür muss WebDonkey laufen..htmlöffnet die Seite in der Site des Projekts, sonst direkt im Browser.
Was im Hintergrund passiert
Eigene und ausgeblendete Starter speichert der Editor im Projekt unter .webdonkey-editor/starters.json. Der Ordner bekommt eine eigene .gitignore, damit er nicht im Repository landet. Eigene Starter gelten nur für dieses Projekt.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| „Gib dem Starter einen Namen.“ / „Trag den Befehl ein, der laufen soll.“ | Feld Name bzw. Befehl ausfüllen |
| „In den Argumenten ist ein Anführungszeichen nicht geschlossen.“ | Anführungszeichen prüfen |
| „Variablennamen dürfen nur Buchstaben, Ziffern und _ enthalten.“ | Namen links vom = korrigieren |
| „Ordner und Dateien müssen im Projekt liegen.“ | Einen Ordner innerhalb des Projekts wählen |
| „Ein Starter kann nicht sich selbst vorher starten.“ | Unter Vorher starten einen anderen Starter oder Nichts wählen |
| „Für diese Art Datei ist kein Programm bekannt.“ | Eine Shebang-Zeile ergänzen oder einen eigenen Starter mit Befehl anlegen |
| „Den Arbeitsordner gibt es nicht.“ / „Die .env-Datei ließ sich nicht lesen.“ | Pfad im Dialog korrigieren |
| „Keine Datenbank-Verbindung verfügbar. Starte zuerst eine in WebDonkey.“ | Eine Datenbank in WebDonkey starten oder eine eigene Verbindung anlegen |
Siehe auch
Vertrauen Free
Skripte aus einem Projekt können auf deinem Mac alles, was du auch kannst. Deshalb fragt der Editor vor dem ersten Start in einem Projekt nach und zeigt dir den genauen Befehl. Erst wenn du dem Projekt vertraust, laufen seine Starter.
So findest du es
- Der Dialog erscheint beim ersten Start eines Starters in einem Projekt, auch beim ersten Aufklappen von
bin/consoleoderartisan. - Zurücknehmen: das Schild-Symbol oben im Starter-Fenster oder der Befehl Den Startern dieses Projekts nicht mehr vertrauen in der Befehlspalette.
- Abschalten: Einstellungen › Starter › Vor dem ersten Start in einem Projekt fragen.
Der Dialog
„Skripte dieses Projekts ausführen?“ zeigt:
- den genauen Befehl, der laufen würde,
- den Ordner, in dem er läuft („In …“),
- den Hinweis, dass das Projekt danach als vertraut gilt.
Du hast zwei Wege:
- Vertrauen und starten (beim Starten) bzw. Vertrauen und laden (beim Aufklappen der Konsolenbefehle): Das Projekt gilt ab jetzt als vertraut, der Befehl läuft.
- Abbrechen: Es läuft nichts, das Projekt bleibt unvertraut.
Führe Skripte nur aus, wenn du weißt, woher das Projekt kommt.
Vertrauen zurücknehmen
- Öffne das Starter-Fenster.
- Klicke oben das Schild-Symbol (Vertraut, Klick nimmt es zurück). Es erscheint nur, solange das Projekt vertraut ist.
- Der Editor meldet „Diesem Projekt wird nicht mehr vertraut. Beim nächsten Start fragt der Editor wieder.“
Dasselbe tut Den Startern dieses Projekts nicht mehr vertrauen in der Befehlspalette.
Ohne Rückfrage
Schaltest du Vor dem ersten Start in einem Projekt fragen aus, vertraut der Editor jedem Projekt beim ersten Start stillschweigend. Das ist bequemer, aber dann startet ein Klick auf ▶ auch Skripte aus Projekten, die du nicht kennst.
Was im Hintergrund passiert
Die Liste der vertrauten Projekte liegt auf deinem Mac, je Projektordner. Ein Ordner, auf den ein Symlink zeigt, gilt als dasselbe Projekt. Das Vertrauen gilt für alle Starter des Projekts, auch für eigene und für Datei ausführen.
Siehe auch
Kürzel und Leiste Free
Mit ⌃R startest du den letzten Starter noch einmal, mit ⌃⇧R führst du die aktuelle Datei aus. Die Startleiste in der Titelleiste zeigt den gewählten Starter und steuert ihn. Unter Einstellungen › Starter legst du fest, was der Editor erkennt und wann er fragt.
Kürzel
| Taste | Befehl | Was passiert |
|---|---|---|
| ⌃R | Letzten Starter starten | startet den zuletzt gestarteten Starter, sonst den in der Startleiste gewählten |
| ⌃⇧R | Aktuelle Datei ausführen | führt die Datei im aktiven Tab aus, siehe Datei ausführen |
Steht der Cursor im Terminal, wirken ⌃R und ⌃⇧R nicht als Starter-Kürzel. ⌃R bleibt dort die Verlaufssuche der Shell. In der Befehlspalette stehen dazu Starter stoppen (solange der letzte Starter läuft), Neuer Starter…, Starter anzeigen und Den Startern dieses Projekts nicht mehr vertrauen.
Startleiste
Die Startleiste steht in der Titelleiste, sobald ein Projekt offen ist und es dort Starter gibt.
- Name mit Statuspunkt: Ein Klick öffnet das Menü. Oben stehen die Haupt-Starter, darunter die übrigen. Ein Klick wählt einen Starter für die Leiste. Am Ende des Menüs stehen Aktuelle Datei ausführen, Neuer Starter… und Starter anzeigen.
- ▶ (Starten) bzw. ↻ (Neu starten), solange er läuft.
- ■ (Stoppen), solange er läuft.
- Im Browser öffnen, sobald der Starter eine Adresse gemeldet hat.
Ohne eigene Wahl zeigt die Leiste den Haupt-Starter des Projektordners, sonst den ersten Starter.
Einstellungen
Unter Einstellungen › Starter:
| Einstellung | Was sie tut | Standard |
|---|---|---|
| Starter erkennen | Liest beim Öffnen eines Projekts package.json, composer.json, Makefile und Co. Von selbst startet nichts. |
an |
| ▶ im Projektbaum | Zeigt beim Überfahren einer ausführbaren Datei oder eines Ordners mit Startern einen Start-Knopf | an |
| Vor dem ersten Start in einem Projekt fragen | Zeigt einmal den genauen Befehl, bevor Skripte eines Projekts laufen dürfen, siehe Vertrauen | an |
| Quellen | ein Schalter je Quelle, siehe Erkannte Starter | alle an |
Den ganzen Starter schaltest du unter Funktionen mit Starter aus: kein Fenster, kein ▶ im Baum, keine Erkennung, keine Kürzel.
Das ▶ im Projektbaum
Fährst du über eine Datei, die der Editor ausführen kann, oder über einen Ordner mit Startern, erscheint ein ▶. Ein Klick führt die Datei aus oder startet den einzigen Starter. Gibt es mehrere, öffnet der Klick ein Menü, ein Rechtsklick öffnet es immer. Läuft ein Starter des Eintrags, zeigt das ▶ stattdessen einen grünen Punkt, nach einem Fehler einen roten.