i18n: update i18n files from po4a run
Some checks failed
ci / build_and_publish (push) Failing after 47s

This commit is contained in:
Chris Milne 2026-05-01 14:18:30 +01:00
parent d6d8be1eca
commit 1c2899a9d2
70 changed files with 3238 additions and 879 deletions

View file

@ -0,0 +1,59 @@
---
sidebar_position: 2
---
# File Sharing
<figure><img src="/img/docs/media-type-explore.png" alt=""/><figcaption></figcaption></figure>
## Share Media, Files and Digital Books
You can use your Butter Box to share media, files, and digital books. To
display additional content in your portal, connect a USB drive containing
the information you want to share.
If youd like more control over how your content is displayed, you can build
a **static website** and share it through the Butter Box. Learn more in the
[Content Packs](../content-packs/) section.
### Add files to your USB Drive
Place individual files directly in the **main directory** (root) of your USB
drive. Or, create folders to organize your files (eg. "Books", "Music",
"Reports)
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.50.15 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
**Things to Know**
* The **folder names you use** on your USB drive will be shown in the Butter
Box portal.
* Organizing content into folders makes it easier for others to browse and
download.
### Connect to your Butter Box to view
Insert the USB drive into your Butter Box. After connecting your USB drive
to the Raspberry Pi you will see the **Files** tile displayed when you open
the Butter Box portal.
<div><figure><img src="/img/docs/Screenshot_20260414-122810.png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821.png" alt=""/><figcaption></figcaption></figure></div>
**Troubleshooting**
If you dont see the **Files** tile, try the following actions:
* Remove the USB drive from the Butter Box. Then re-insert the USB drive.
* Turn on/off airplane mode. Reconnect Butter Box wifi.
* Refresh the browser page.
If you are still having trouble you may need to [Reformat Your USB
Drive](../faq/how-to-reformat-your-usb-drive).

View file

@ -0,0 +1,5 @@
---
sidebar_position: 1
---
# Features

View file

@ -0,0 +1,110 @@
---
description: 'A place for anyone connected to the box to share'
sidebar_position: 3
---
# Local Chat
There is one local chat on your Butter Box that is open to anyone who is
able to join the box. If they can open the portal, they can open the chat
and say or post anything they want. Depending on your use case, moderation
capabilities may be important.
First, let's look at what you can and can't do with this local chat.
✅ **You Can**<br/>
* Host videos up to 5 GB PDFs, images, record, audio messages, share
pre-recorded audio messages or music
* Download the full chat or any individual piece of content or media that
people have shared
❌ **You Cannot**<br/>
* Use the chat to talk with people who are not connected to the Butter Box
* Get notifications when there are new posts or messages
* See the messages unless you are connected to the Butter Box
## Moderation
A Butter Box offers moderation features for the local chat. In order to
access these features, you need to login as the admin of the room.
### Become the Admin
### Logout as Guest
When you open the local chat, you are assigned a guest identity. First
logout of the account that was created for you.
### Login as Admin
Login to the `butterbox-admin` account. Username and password are both
`butterbox-admin`.
### Change Admin Password
Visit your user profile to change the password. At your discretion, you may
also wish to change your display name so that other users will recognize
you.
### Moderation Features
Once you are an admin, you have access to the following features:
* **Set a message timer**
* **Delete messages**
* **Promote members to moderator or admin**
* **Kick members out.**
* Keep in mind that someone can simply rejoin as a new guest if they
reconnect to the box
* **Delete the room.**
* Warning: If you delete the room, you will no longer have a local chat on
your Butter Box. To get one back, you will have to flash a new image of
the Butter Box software to your SD card.
## Say Even More—Direct Messages and Private Rooms
In addition to the local chat, you can create any number of private rooms
from the same interface.
### Things To Know
* Each room will have it's own QR code.
* Private rooms are not discoverable from the Butter Box portal.
* If you create a private room, you have to share the QR code physically to
whomever you want to join **who is also connected to the box.**
* Every private chat that you are part of, will be easy for **you** to
find. They will all show up in your room list.
### Instructions
You can create a private room from two different places in the message board
interface.
### Open from Avatar Modal
Tap on your avatar in the top bar. Select **new room.**
| <img src="/img/docs/image.png" alt="" data-size="original"/> | |
| -------------------------------------------------------------------- | - |
### Open from Room List
Your room list is accessible from your profile page. Once here, select **new
room.**
<figure><img src="/img/docs/Screenshot 2026-01-20 at 1.42.17PM.png" alt=""/><figcaption></figcaption></figure>

View file

@ -0,0 +1,17 @@
---
description: 'Using Delta Chat with a Butter Box'
sidebar_position: 4
---
# Private Messenger
With the Private Messenger service, you can exchange secure messages with
people you know. [Delta Chat](https://delta.chat/) is a messaging app that
uses email protocols to exchange messages. When used through a Butter Box,
people who create accounts on the same Butter Box can send messages to each
other without the internet.
Think of the Butter Box like a local post office. Whenever you connect to
the Boxs network, your Delta Chat app can send outgoing messages and sync
to receive any new ones waiting for you.