Welcome to mirror list, hosted at ThFree Co, Russian Federation.

index.html - github.com/guysoft/OctoPi.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: fe594b733e801db6fdb849d1c25a799e03ad96b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
---
layout: default
title: OctoPi
---

<div class="jumbotron">
    <div class="container">
        <div class="row">
            <div class="offset2 span5 text">
                <div class="hero-content">
                    <h1>OctoPi</h1>
                    <p>The ready-to-go Raspberry Pi image with OctoPrint</p>
                    <div class="shameless-self-promotion">
                        Created &amp; maintained by Guy Sheffer and the community
                    </div>
                </div>
            </div>
            <div class="span3 logo">
                <img src="{{ site.baseurl }}/assets/img/logo.png">
            </div>
        </div>
    </div>
</div>


<div class="container">
    <div class="content row-fluid">
        <div class="offset2 span8">
            <h2>What is OctoPi?</h2>

            <p>
                OctoPi is a <a href="http://www.raspberrypi.org/">Raspberry Pi</a>
                distribution for 3D printers. Out of the box it includes:
            </p>

            <ul>
                <li>
                    the <a href="http://octoprint.org">OctoPrint</a> host software including all
                    its dependencies and preconfigured with webcam and slicing support,
                </li>
                <li>
                    <a href="https://github.com/jacksonliam/mjpg-streamer">mjpg-streamer</a> for
                    live viewing of prints and timelapse video creation with support
                    for USB webcams and the Raspberry Pi camera and
                </li>
                <li>
                    <a href="https://github.com/Ultimaker/CuraEngine">CuraEngine 15.04</a> for direct slicing on your
                    Raspberry Pi.
                </li>
            </ul>

            <h2>Where can I get OctoPi?</h2>

            <p>
                You can download the latest stable build via this button:
            </p>

            <p>
                <a class="btn btn-primary btn-large" href="https://octopi.octoprint.org/latest"><i class="icon-download-alt icon-large"></i>&nbsp;&nbsp;Download&nbsp;OctoPi&nbsp;0.16.0</a>
            </p>

            <p>
                <small>MD5sum of the .zip: <code>52c855c9bcc88fd3bf81bbe8e58a2e4c</code></small>
            </p>

            <p>
                Compatible with Raspberry Pi 3B+, 3A+, A, B, A+, B+, B2, <strong>3</strong><sup><a href="#footnote-1-text" class="footnote" id="footnote-1">1)</a></sup>, Zero and Zero W<sup><a href="#footnote-2-text" class="footnote" id="footnote-2">2)</a></sup>
            </p>

            <p>
                Additional mirrors can be found here:
            </p>

            <ul>
                <li><a href="https://gnethomelinux.com/OctoPi/nightly/">Mirror #1</a> (also includes nightly builds)</li>
            </ul>

            <h2>How do I set it up?</h2>

            <ol>
                <li>
                    Download the image via the button above.
                </li>
                <li>
                    Unzip the zipped image and install the contained <code>.img</code> file to an sd card
                    <a href="https://www.raspberrypi.org/documentation/installation/installing-images/README.md">like any other Raspberry Pi image</a>
                </li>
                <li>
                    Configure your WiFi by editing <code>octopi-network.txt</code>
                    on the root of the flashed card when using it like a thumb drive
                </li>
                <li>
                    Boot the Pi from the card
                </li>
                <li>
                    Log into your Pi via SSH (it is located at <code>octopi.local</code>
                    <a href="https://learn.adafruit.com/bonjour-zeroconf-networking-for-windows-and-linux/overview">if your computer supports bonjour</a>
                    or the IP address assigned by your router), default username
                    is "pi", default password is "raspberry". <strong>Change the
                    password</strong> using the <code>passwd</code> command. You do not need
                    to expand the filesystem, current versions of OctoPi do this automatically.
                </li>
            </ol>

            <p>
                OctoPrint is located at <a href="http://octopi.local">http://octopi.local</a>
                and also at <a href="https://octopi.local">https://octopi.local</a>.
                Since the SSL certificate is self signed (and generated upon first boot),
                you will get a certificate warning at the latter location.
            </p>

            <p>
                If a USB webcam or the Raspberry Pi camera is detected, MJPG-streamer
                will be started automatically as webcam server. OctoPrint on
                OctoPi ships with correctly configured stream and snapshot URLs
                pointing at it. If necessary, you can reach it under
                <code>http://octopi.local/webcam/?action=stream</code> and SSL
                respectively, or directly on its configured port 8080:
                <code>http://octopi.local:8080/?action=stream</code>.
            </p>

            <p>
                CuraEngine 15.04 is installed and OctoPrint ships pre-configured with
                the correct path to utilize it for on-board-slicing. Just import
                a Cura Slicing Profile in OctoPrint's settings and start slicing
                directly on your Pi.
            </p>

            <h2>Are there further resources to get going?</h2>

            <p>
                Yes!
            </p>

            <ul>
                <li>
                    <i class="icon-youtube-sign"></i> <a href="https://www.youtube.com/watch?v=MwsxO3ksxm4">Getting started with OctoPrint on the Raspberry Pi 2! [2016 edition]</a>
                    by <a href="https://www.youtube.com/channel/UCb8Rde3uRL1ohROUVg46h1A">Thomas Sanladerer</a>
                </li>
                <li>
                    <i class="icon-file-text"></i> <a href="https://www.raspberrypi.org/magpi/issues/36/">The MagPi issue #36</a> contains a "Getting Started" guide on pages 50-51. You can find
                    an excerpt <a href="/assets/download/MagPi36_OctoPrint.pdf">here</a> (MagPi License: <a href="https://creativecommons.org/licenses/by-nc-sa/3.0/">CC BY-NC-SA</a>).
                </li>
            </ul>

            <h2>I want to build my own version of OctoPi</h2>

            <p>
                No problem, OctoPi is Open Source licensed under GPLv3.
                You can find the scripts used to build the image
                <a href="https://github.com/guysoft/OctoPi">in the official Github repository</a>.
            </p>

            <hr>

            <div class="footnotes">
                <div class="footnote-text">
                    <a href="#footnote-1" id="footnote-1-text">1)</a> Recommended model.
                </div>
                <div class="footnote-text">
                    <a href="#footnote-2" id="footnote-2-text">2)</a> Not recommended if you plan to use a webcam for a live view - the wifi interface currently <a href="https://github.com/guysoft/OctoPi/issues/318#issuecomment-284762963" target="_blank">causes significant CPU load</a> on bandwidth utilization, negatively affecting running print jobs.
                </div>
            </div>
        </div>
    </div>
</div>