foosel / OctoPrint: OctoPrint est l'interface Web attrayante de votre imprimante 3D! – Serveur d’impression

OctoPrint fournit une interface Web rapide pour contrôler les imprimantes 3D grand public. C'est du logiciel libre
et publié sous la licence GNU Affero General Public License V3.

Son site Web peut être trouvé à octoprint.org.

Le forum de la communauté est disponible sur community.octoprint.org.

Le canal IRC officiel est #octoprint sur freenode. Ses journaux peuvent être trouvés ici.

La FAQ peut être consultée en suivant faq.octoprint.org.

La documentation se trouve sur docs.octoprint.org.

Le répertoire officiel des plugins est accessible à l'adresse plugins.octoprint.org.

Le développement d'OctoPrint ne serait pas possible sans le soutien financier de sa communauté.
Si vous appréciez OctoPrint, envisagez de devenir un partisan régulier!

Vous consultez actuellement le référentiel de code source d'OctoPrint. Si vous l'avez déjà installé
(par exemple, en utilisant OctoPi, la distribution ciblée de Raspberry Pi) et uniquement
veux savoir comment l'utiliser, la documentation et le wiki public
pourrait être plus intéressant pour vous. Vous pouvez également vous inscrire pour vous inscrire
le forum de la communauté à community.octoprint.org où d’autres utilisateurs actifs pourraient être
capable de vous aider avec toutes les questions que vous pourriez avoir.

Contribuant

Les contributions de toutes sortes sont les bienvenues, non seulement sous forme de code, mais aussi en ce qui concerne
documentation officielle ou wiki public, aide au débogage
dans le traqueur de bugs, support des autres utilisateurs sur
le forum de la communauté à community.octoprint.org
et aussi financièrement.

Si vous pensez que quelque chose ne va pas avec OctoPrint ou sa documentation, veuillez aider.
en aucune façon pour le rendre meilleur au lieu de simplement s'en plaindre – ceci est un projet Open Source
après tout 🙂

Pour plus d'informations sur la procédure à suivre pour soumettre des rapports de bogues ou des demandes d'extraction, consultez la section relative au projet
Directives de contribution.

Installation

Instructions d'installation pour l'installation à partir de la source pour différentes opérations
les systèmes peuvent être trouvés sur le wiki.

Si vous voulez exécuter OctoPrint sur un Raspberry Pi, jetez un coup d’œil à OctoPi
qui est une image de carte SD personnalisée qui comprend OctoPrint plus dépendances.

Les étapes génériques qui devraient être effectuées indépendamment du système d'exploitation
et l'environnement d'exécution sont les suivants (comme régulier
utilisateur, s'il vous plaît gardez vos mains de du sudo commande ici!) – cela suppose
Python 2.7, pip et virtualenv sont déjà configurés sur votre système:

1. Commander OctoPrint: clone git https://github.com/foosel/OctoPrint.git
2. Accédez au dossier OctoPrint: cd OctoPrint
3. Créez un environnement virtuel appartenant à l'utilisateur: virtualenv venv si la version par défaut de votre système est Python
   Python 2.7, sinon vous devez spécifier explicitement la version, par exemple. virtualenv --python = python2.7 venv.
4. Installer OctoPrint dans cet environnement virtuel: ./venv/bin/pip install.

Vous pouvez ensuite démarrer le serveur OctoPrint via / chemin / vers / OctoPrint / venv / bin / octoprint, voir Utilisation
pour plus de détails.

Après l'installation, assurez-vous de suivre l'assistant de première exécution et de configurer
contrôle d'accès si nécessaire.

Les dépendances

OctoPrint dépend de quelques modules python pour faire son travail. Ceux-ci sont automatiquement installés lors de l'installation
OctoPrint via pépin:

pip installer.

Vous devez le faire à chaque fois après l'extraction du référentiel, car les dépendances ont peut-être changé.

OctoPrint ne prend actuellement en charge que Python 2.7.

Usage

Lancer le pip installer via

pip installer.

installe le octoprint script dans le dossier des scripts de votre installation Python
(qui, selon que vous avez installé OctoPrint de manière globale ou dans un env virtuel, sera dans votre CHEMIN ou pas). le
Les exemples d'utilisation suivants supposent que le octoprint le script est sur votre CHEMIN.

Vous pouvez démarrer le serveur via

octoprint servir

Par défaut, il se connecte à toutes les interfaces du port 5000 (vous devez donc pointer votre navigateur sur http://127.0.0.1:5000
fera le tour). Si vous voulez changer cela, utilisez les paramètres de ligne de commande supplémentaires hôte et Port,
qui acceptent l’hôte IP auquel se lier et le numéro de port numérique, respectivement. Si par exemple vous voulez le serveur
d’écouter uniquement sur l’interface locale sur le port 8080, la ligne de commande serait

octoprint serve --host = 127.0.0.1 --port = 8080

Alternativement, l'hôte et le port sur lesquels se lier peuvent être définis via le fichier config.

Si vous voulez exécuter OctoPrint en tant que démon (supporté uniquement sous Linux), utilisez

démon octoprint start  [--pid PIDFILE]

Si vous ne fournissez pas d’emplacement pidfile personnalisé via --pid PIDFILE, il sera créé à /tmp/octoprint.pid.

Vous pouvez également spécifier le fichier de configuration ou le répertoire de base (pour baser la les téléchargements, laps de temps et les journaux Dossiers),
par exemple.:

octoprint serve --config /path/to/another/config.yaml --basedir / path / to / my / basedir

Pour démarrer OctoPrint en mode sans échec – ce qui désactive tous les plug-ins tiers qui ne sont pas fournis avec OctoPrint – utilisez
le --sûr drapeau:

octoprint servir --safe

Voir octoprint --help pour plus d'informations sur les paramètres de ligne de commande disponibles.

OctoPrint est également livré avec un courir script dans son répertoire source. Vous pouvez l'invoquer pour démarrer le serveur. Il
prend les mêmes arguments en ligne de commande que le octoprint scénario.

Configuration

Si non spécifié via la ligne de commande, le fichier de configuration config.yaml OctoPrint est attendu dans le dossier des paramètres,
qui est situé à ~ / .octoprint sur Linux, à % APPDATA% / OctoPrint sur Windows et
à ~ / Bibliothèque / Application Support / OctoPrint sur MacOS.

Vous trouverez un aperçu complet de tous les paramètres de configuration disponibles.
dans les docs.
Veuillez noter que les paramètres de configuration les plus couramment utilisés peuvent également être facilement configurés.
être édité à partir de la boîte de dialogue des paramètres d'OctoPrint.

Remerciement spécial

Les services de test inter-navigateur sont gracieusement fournis par BrowserStack.

Le profilage est effectué à l'aide de PyVmMonitor.

Le suivi des erreurs est alimenté et sponsorisé par Sentry.