Installation
Rayforge ist für Linux, Windows und macOS verfügbar. Wähle deine Plattform unten und folge den Installationsanweisungen.
Wähle dein Betriebssystem:
Wähle die Installationsmethode:
Snap-Paket
Das Snap-Paket funktioniert auf den meisten Linux-Distributionen und enthält alle Abhängigkeiten in einer Sandbox-Umgebung.
Rayforge installieren
sudo snap install rayforge
Benutzer zur Dialout-Gruppe hinzufügen
sudo usermod -a -G dialout $USER
Wichtig: Melde dich ab und wieder an, damit diese Änderung wirksam wird.
Berechtigungen erteilen (Wichtig!)
Für USB-Seriell-Zugriff:
# Enable experimental hotplug support (one-time setup)
sudo snap set system experimental.hotplug=true
# Connect your laser via USB, then grant access
sudo snap connect rayforge:serial-port
Für Kamerazugriff:
sudo snap connect rayforge:camera
Berechtigungen überprüfen
snap connections rayforge
Suche nach serial-port in der Liste. Wenn "connected" angezeigt wird, bist du bereit.
Installation überprüfen
Rayforge starten
Starte Rayforge aus deinem Anwendungsmenü oder Terminal. Du solltest das Hauptfenster mit der Arbeitsfläche und der Symbolleiste sehen.
Version überprüfen
Prüfe Hilfe - Über, um die installierte Version zu bestätigen.
Deine Maschine verbinden
Verbinde deinen Laser-Controller über USB und überprüfe, ob der Seriell-Port in den Maschineneinstellungen von Rayforge angezeigt wird.
Fehlerbehebung
Berechtigungsprobleme?
Wenn Ihr Gerät nicht erkannt wird, siehe den Snap-Berechtigungsleitfaden. Snap-Berechtigungsanleitung
Seriell-Port funktioniert immer noch nicht?
- USB-Gerät neu anschließen: Trenne deinen Laser-Controller, warte 5 Sekunden und schließe ihn wieder an.
- Rayforge neu starten: Schließe vollständig und starte neu.
- Überprüfe, ob das Gerät existiert:ls -l /dev/ttyUSB* /dev/ttyACM*
- Falls erforderlich neu installieren:sudo snap remove rayforgesudo snap install rayforgesudo snap connect rayforge:serial-port
Hilfe benötigt?
Für weitere Hilfe melde ein Problem auf GitHub oder trete unserem Discord bei. GitHub | Discussions | Discord
Systemanforderungen
| Ressource | Installiert | Empfohlen |
|---|---|---|
| Speicherplatz | < 1 GB | Je nach Projekt |
| Arbeitsspeicher | 1 GB | Je nach Projekt |
Der tatsächliche Speicherplatz- und Arbeitsspeicherbedarf hängt von der Projektkomplexität ab. Einfache Projekte benötigen kaum mehr als die Installationsgröße, während komplexe Projekte leicht 10 GB RAM oder mehr verbrauchen und erheblichen zusätzlichen Speicherplatz erfordern können.
Linux-CPU-Anforderung (x86-64-v2)
Die Linux-Pakete bringen ihr eigenes NumPy mit, das die Befehlssatzebene x86-64-v2 voraussetzt (SSE4.2 und POPCNT). Das gilt für die Snap-, Flatpak- und AppImage-Pakete ebenso wie für pip-Installationen von PyPI. Auf älteren x86-64-CPUs (Intel Core 2 oder älter, AMD Phenom oder älter) startet Rayforge nicht, meist ohne Fehlermeldung. Intel-CPUs ab Nehalem (2008) und AMD-CPUs ab Bulldozer (2011) unterstützen x86-64-v2.
Ob deine CPU diese Anforderung erfüllt, kannst du so prüfen:
grep -m1 flags /proc/cpuinfo | grep -o -w -E 'sse4_2|popcnt' | sort -u
Gibt der Befehl nicht beide Flags aus, installiere Rayforge stattdessen aus dem Ubuntu-PPA oder aus dem Paketarchiv deiner Distribution. Diese Varianten nutzen das mit der Distribution mitgelieferte NumPy und laufen auch auf älteren CPUs.
Nächste Schritte
Nachdem Rayforge installiert ist, fahre mit Ersteinrichtung fort, um deine Maschine zu konfigurieren.