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
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.
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 rayforgesudo snap install rayforgesudo snap connect rayforge:serial-port
Besoin d'aide ?
Pour plus d'aide, signalez un problème sur GitHub ou rejoignez notre Discord. GitHub | Discussions | Discord
Configuration Système Requise
| Ressource | Installé | Recommandé |
|---|---|---|
| Espace disque | < 1 Go | Variable selon le projet |
| Mémoire RAM | 1 Go | Variable selon le projet |
Les besoins réels en disque et en mémoire dépendent de la complexité du projet. Les projets simples peuvent nécessiter peu de ressources au-delà de l'installation, tandis que les projets complexes peuvent facilement consommer 10 Go de RAM ou plus et nécessiter un espace disque supplémentaire important.
Processeur requis sous Linux (x86-64-v2)
Les paquets Linux embarquent leur propre NumPy, qui nécessite le niveau de jeu d'instructions x86-64-v2 (SSE4.2 et POPCNT). Cela concerne les paquets Snap, Flatpak et AppImage ainsi que les installations via pip depuis PyPI. Sur les processeurs x86-64 plus anciens (Intel Core 2 ou antérieur, AMD Phenom ou antérieur), Rayforge ne démarre pas, généralement sans message d'erreur. Les processeurs Intel à partir de Nehalem (2008) et AMD à partir de Bulldozer (2011) prennent en charge x86-64-v2.
Pour vérifier que votre processeur remplit cette condition, exécutez :
grep -m1 flags /proc/cpuinfo | grep -o -w -E 'sse4_2|popcnt' | sort -u
Si la commande n'affiche pas les deux indicateurs, installez plutôt Rayforge depuis le PPA Ubuntu ou depuis le dépôt de paquets de votre distribution. Ces versions utilisent le NumPy fourni par votre distribution et fonctionnent donc sur les processeurs plus anciens.
Prochaines Étapes
Maintenant que Rayforge est installé, passez à la Configuration Initiale pour configurer votre machine.