i18n: update i18n files from po4a run
(cherry picked from commit 1c2899a9d2)
This commit is contained in:
parent
d233928bae
commit
c3404a015f
69 changed files with 3228 additions and 868 deletions
|
|
@ -0,0 +1,49 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# Basic Box Supplies
|
||||
|
||||
A basic Butter Box setup is a Raspberry Pi Zero 2 W with a microSD card
|
||||
running the Butter software, a USB stick, powered by a USB source like a
|
||||
power cord, power bank or solar panel.
|
||||
|
||||
In most setups like this, a Butter Box can comfortably handle **4–10
|
||||
connected devices at once** without slowing down. It’s possible to have
|
||||
more, but performance may drop if everyone is downloading large files or
|
||||
videos at the same time.
|
||||
|
||||
The reach for it is about **5–10 meters** indoors, depending on the
|
||||
Raspberry Pi model and depending on walls and interference. Outdoors, in
|
||||
open space, it can sometimes reach farther. Think of it like the range of a
|
||||
home Wi-Fi router — enough to cover a classroom, a coffee shop, meeting
|
||||
space, or small outdoor gathering.
|
||||
|
||||
## Supplies
|
||||
|
||||
* [ ] Raspberry Pi Zero 2W (64 Bit)
|
||||
[https://www.adafruit.com/product/5291](https://www.adafruit.com/product/5291);
|
||||
Or you can buy a kit here: [\
|
||||
https://www.canakit.com/raspberry-pi-zero-2-w.html](https://www.canakit.com/raspberry-pi-zero-2-w.html)
|
||||
* [ ] Power outlet and power cord that accompanies the Raspberry Pi Zero 2W
|
||||
or an [alternative power supply](../power-supply)
|
||||
* [ ] Micro SD Card: Images with the Butter software are usually under 16 GB
|
||||
(we suggest 256 GB). Media that people upload to the chat ends up on the
|
||||
card; it never gets cleared.
|
||||
* [ ] USB drive (min 32 GB)
|
||||
* [ ] Adapters (as needed)
|
||||
|
||||
* [ ] Micro USB/Male to USB A/Female
|
||||
* [ ] A dongle to connect the micro SD card to your laptop (if needed)
|
||||
|
||||
|
||||
|
||||
**Once you have your supplies, continue in the Install Butter section.**
|
||||
|
||||
[install-butter.md](install-butter)
|
||||
|
||||
<figure><img src="/img/docs/20250815_142828.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,69 @@
|
|||
---
|
||||
description: 'How To Add a Router To Your Box Setup'
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Extend Your Box
|
||||
|
||||
An extended Butter Box pairs the Raspberry Pi with a standalone Wi-Fi
|
||||
router, giving stronger signal and more simultaneous connections.
|
||||
|
||||
With the router, the network can reach 10-30 m (32-98 feet),and can
|
||||
comfortably support 10–20 connected devices at the same time. This setup is
|
||||
ideal for a medium group of people in a medium room, like classrooms,
|
||||
events, or community spaces.
|
||||
|
||||
## Supplies
|
||||
|
||||
* [ ] Raspberry Pi 4, 5 or Raspberry Pi Zero 2W
|
||||
* [ ] Router ([Opal (GL-SFT1200) Wireless Travel
|
||||
Router](https://store-us.gl-inet.com/products/united-states-opal-gl-sft1200-gigabit-wireless-router-dual-band-openwrt-ipv6-tor)
|
||||
or equivilent)
|
||||
* [ ] Power outlet and power cords that accompany the Raspberry Pi and the
|
||||
Router or an [alternative power supply](../power-supply)
|
||||
* [ ] Micro SD Card: Images with the Butter software are usually under 16 GB
|
||||
(we suggest 256 GB). Media that people upload to the chat ends up on the
|
||||
card; it never gets cleared.
|
||||
* [ ] USB Drive (min 32 GB)
|
||||
* [ ] Adapters (as needed)
|
||||
|
||||
_No internet connection is required._
|
||||
|
||||
<figure><img src="/img/docs/20250815_142438.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
## Steps
|
||||
|
||||
To extend your box, you simply connect a GLi-Net router to the Butter Box
|
||||
with an ethernet cable. Instead of accessing the box from the portal Wi-Fi
|
||||
hotspot (eg. 'butter box' or whichever name you set in the admin settings),
|
||||
users will join the Wi-Fi network of the router.
|
||||
|
||||
### Connect the Butter Box to its power supply.
|
||||
|
||||
Connect the Butter Box to power.
|
||||
|
||||
### Connect Router
|
||||
|
||||
Connect the router to power. Then use the ethernet cable to connect to the
|
||||
Butter Box. Make sure to plug the Ethernet cable into the LAN port on your
|
||||
router.
|
||||
|
||||
### Test Your Connection
|
||||
|
||||
Join the router Wi-Fi. If you have not setup or used this router before,
|
||||
enter the default password found in the user guide included in the
|
||||
package. After 30 seconds, open http://butterbox.local in a browser.
|
||||
|
||||
### Disable Butter Box Wi-Fi Access Point
|
||||
|
||||
Open the admin settings from the Butter Box portal. Navigate to **Secure
|
||||
Portal**. Turn off the Wi-Fi access point. This will hide the Wi-Fi network
|
||||
that broadcasts from the raspberry pi, so that users don’t get confused
|
||||
about which network to join.
|
||||
|
||||
### Invite Users to Join the Router Wi-Fi
|
||||
|
||||
Users will now join the Wi-Fi network of the router when they want to
|
||||
connect to the Butter Box.
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Raspberry Pi
|
||||
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
---
|
||||
description: 'Install Butter Operating System (OS) on an SD card for Raspberry Pi'
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Install Butter
|
||||
|
||||
You will need:
|
||||
|
||||
* Desktop computer
|
||||
* Internet Connection
|
||||
* Butter Box
|
||||
|
||||
### Download the Butter OS for Raspberry Pi
|
||||
|
||||
Make sure the file size matches the size listed on the website. Sometimes
|
||||
browsers do not complete the download, which can result in a corrupted file.
|
||||
|
||||
[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)
|
||||
|
||||
:::info
|
||||
Always choose the Latest Version of the file.
|
||||
:::
|
||||
|
||||
### Plug the micro SD card into your computer
|
||||
|
||||
To plug the micro SD card into your computer, you may need an adapter to do
|
||||
this:
|
||||
|
||||
<div align="center"><figure><img src="/img/docs/image_1.png" alt="" width="375"/><figcaption><p>Example adapter (USB-C to Micro SD)</p></figcaption></figure></div>
|
||||
|
||||
:::info
|
||||
You don't need to connect the box to the computer.
|
||||
:::
|
||||
|
||||
### Run Raspberry Pi Imager
|
||||
|
||||
Once you have your micro SD card plugged into your computer that has an
|
||||
internet connection, run Raspberry Pi Imager from a desktop computer. It
|
||||
will walk you through the steps to install the Butter operating system on
|
||||
the micro SD card.
|
||||
|
||||
If you don't have Raspberry Pi Imager, you can download it here:
|
||||
[https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
|
||||
|
||||
### Choose device > **Raspberry Pi Zero 2 W**
|
||||
|
||||
Once the Raspberry Pi Image starts, you will be prompt to select your
|
||||
Raspberry Pi device.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.56.27 AM.png" alt=""/><figcaption><p>Select Raspberry Pi Zero 2 W (or the device you have if it's not the standard box from Butter HQ)</p></figcaption></figure>
|
||||
|
||||
### Choose Operating System > Use Custom
|
||||
|
||||
* On the OS tab, select **Use custom** and upload the custom Butter OS .img
|
||||
file. Confirm that you have **unzipped the file** before using it.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.57.31 AM.png" alt=""/><figcaption><p>Select Use Custom. You will upload the custom .img file that you downloaded from Dropbox.</p></figcaption></figure>
|
||||
|
||||
### Choose Storage > Select Micro SD Card
|
||||
|
||||
* From the **Storage** tab, select the **Micro SD Card.**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.37 PM.png" alt=""/><figcaption><p>Select the Micro SD Card.</p></figcaption></figure>
|
||||
|
||||
Your screen will look similar to this after all selections:
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.43 PM.png" alt=""/><figcaption><p>Final screen after selections.</p></figcaption></figure>
|
||||
|
||||
You may be prompt with _"Doing this will erase all data from selected
|
||||
external storage"_ and “_do you want to apply settings”_, click then on _“no
|
||||
clear settings”_.
|
||||
|
||||
After that select _"write"_ and begin writing process to the Micro SD card.
|
||||
|
||||
### Remove From Computer and Insert Micro SD Card into the Raspberry Pi (Butter Box)
|
||||
|
||||
Once you're done, remove the Micro SD card. Insert the Micro SD card into
|
||||
the Raspberry Pi (Butter Box) not powered on.
|
||||
|
||||
### Go to Quick Start
|
||||
|
||||
Plug the Raspberry Pi (Butter Box) into power. Wait a few moments and
|
||||
connect to the Butter Box Portal. Go to the [Quick Start](../../quick-start)
|
||||
section for more details.
|
||||
|
||||
**If you are building an extended box, continue in the next section: Extend Your Box.**
|
||||
|
||||
[extend-your-box.md](extend-your-box)
|
||||
|
||||
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
If you see an error stating that the input file is not a valid disk image,
|
||||
check the file you downloaded.
|
||||
|
||||
Make sure the file size matches the size listed on the website. Sometimes
|
||||
browsers do not complete the download, which can result in a corrupted file.
|
||||
|
||||
Also confirm that you have **unzipped the file** before using it.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.28.37 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
description: 'Different ways to power your Butter Box'
|
||||
---
|
||||
|
||||
# Power Supply
|
||||
|
||||
If you want Butter to work completely off-grid and without electricity, it
|
||||
can! Butter Boxes can be powered by a wall outlet, pre-charged battery pack
|
||||
or solar powered battery pack.
|
||||
|
||||
* **Wall Outlet:** The official and recommended power supply for Raspberry
|
||||
Pi computers (depends of the Raspberry Pi model that you are using)
|
||||
* **Pre-charged Battery Pack (Power Bank):** This is the most common option
|
||||
for field use.
|
||||
* Anker portable charger [power
|
||||
bank](https://www.amazon.com/Anker-Portable-PowerCore-High-Speed-Charging/dp/B09VXF29RM/ref=sr_1_6?crid=30EJM6E540GE6\&dib=eyJ2IjoiMSJ9.cMM86su3KXjp8lN7z7mvmL1HERSowjwoegVu1E_8xhH-Pl38rDD2hEv21fVqk-w2eogpdZGsfiLn_V8ij-PvaRw3RDBdv9-NTKTFqGOUj6IZJKMdbeUjGkgBFVFdZvyOkBFF6kau0uJIE-rRQyseWiNNPxZwan-29xuz2_f643gTOfOzERBuVK2cDdpm91rPdVsRl3dKy6iR1K7qkYW5YGTtYpaZWriYGWOovD2CcVA.SogXwrCYRlPyAkf0wzwye8_-ZdVw-Fi0EcM5vcr7ESk\&dib_tag=se\&keywords=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhite\&qid=1756265405\&sprefix=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhit%2Caps%2C154\&sr=8-6\&th=1)
|
||||
* **Solar Panel (with Power Bank):** Use a small solar panel to recharge
|
||||
your power bank. This is a good option to keep the box running
|
||||
continuously in off-grid locations. Using direct solar panel without a
|
||||
battery is possible, but unstable if the sun dips in/out.
|
||||
* Solar panel kits:
|
||||
[https://voltaicsystems.com/solar-panel-kits/](https://voltaicsystems.com/solar-panel-kits/)
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
Loading…
Add table
Add a link
Reference in a new issue