Installation

Rayforge est disponible pour Linux, Windows et macOS. Choisissez votre plateforme ci-dessous et suivez les instructions d'installation.

Sélectionnez votre système d'exploitation :

Choisissez la méthode d'installation :

Paquet Snap

Le paquet Snap fonctionne sur la plupart des distributions Linux et inclut toutes les dépendances dans un environnement sandbox.

Installer Rayforge

sudo snap install rayforge

Ajouter l'utilisateur au groupe dialout

Permissions requises

Sur les distributions basées sur Debian, votre utilisateur doit être dans le groupe dialout même lors de l'utilisation de Snap, pour éviter les messages AppArmor DENIED.

sudo usermod -a -G dialout $USER

Important : Déconnectez-vous et reconnectez-vous pour que ce changement prenne effet.

Accorder les permissions (Important !)

Pour l'accès au port série USB :

# 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

Pour l'accès à la caméra :

sudo snap connect rayforge:camera

Vérifier les permissions

snap connections rayforge

Recherchez serial-port dans la liste. Si "connected" s'affiche, vous êtes prêt.

Vérifier l'installation

✓

Lancer Rayforge

Lancez Rayforge depuis votre menu d'applications ou terminal. Vous devriez voir la fenêtre principale avec le canevas et la barre d'outils.

✓

Vérifier la version

Vérifiez Aide - À propos pour confirmer la version installée.

✓

Connecter votre machine

Connectez votre contrôleur laser via USB et vérifiez que le port série apparaît dans les paramètres de machine de Rayforge.

astuce

Sur Linux, les contrôleurs laser apparaissent généralement comme /dev/ttyUSB0 ou /dev/ttyACM0.

Dépannage

Problèmes de permissions ?

Si votre appareil n'est pas détecté, consultez le guide des permissions Snap. Guide des permissions Snap

Le port série ne fonctionne toujours pas ?

Rebrancher l'appareil USB : Déconnectez votre contrôleur laser, attendez 5 secondes, puis rebranchez-le.
Redémarrer Rayforge : Fermez complètement et relancez.
Vérifiez que l'appareil existe :
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Réinstaller si nécessaire :

sudo snap remove rayforge
sudo snap install rayforge
sudo snap connect rayforge:serial-port

Besoin d'aide ?

Pour plus d'aide, signalez un problème sur GitHub ou rejoignez notre Discord. GitHub | Discord

Prochaines Étapes

Maintenant que Rayforge est installé, passez à la Configuration Initiale pour configurer votre machine.