butter/likebutter.app
7
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions
likebutter.app/po4a/likebutter.pot

3625 lines
96 KiB
Text
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2026-04-24 16:24+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: Yaml Front Matter Hash Value: description
#: docs/index.mdx:1
#, no-wrap
msgid "Sharing offline has never been easier!"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/index.mdx:1 docs/build-a-box/raspberry-pi/index.mdx:1
#: docs/content-packs/index.mdx:1 docs/content-packs/apps/index.mdx:1
#: docs/faq/index.mdx:1 docs/services/index.mdx:1
#, no-wrap
msgid "1"
msgstr ""
#. type: Title ###
#: docs/index.mdx:6 docs/content-packs/index.mdx:29
#, markdown-text, no-wrap
msgid "Get Started"
msgstr ""
#. type: Plain text
#: docs/index.mdx:9
#, markdown-text
msgid ""
"Butter Box is a lightweight, portable device that functions like a hard "
"drive with its own hotspot. Anyone nearby can connect to it and view or "
"download its contents—no internet required."
msgstr ""
#. type: Plain text
#: docs/index.mdx:11
#, markdown-text
msgid ""
"Whether you have a Butter Box in your hands or you need to build one, you're "
"in the right spot. Choose an option below."
msgstr ""
#. type: Title ##
#: docs/index.mdx:12
#, markdown-text, no-wrap
msgid "[I Have A Box](quick-start.mdx) ...or... [I Need A Box](build-a-box/)"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/security.mdx:1
#, no-wrap
msgid "How to Make a Butter Box Tamper Resistant"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/security.mdx:1
#, no-wrap
msgid "7"
msgstr ""
#. type: Title #
#: docs/security.mdx:6
#, markdown-text, no-wrap
msgid "Security"
msgstr ""
#. type: Plain text
#: docs/security.mdx:9
#, markdown-text
msgid ""
"This guide was designed for deployments in hostile, semi-hostile, or "
"low-trust environments, where devices may be inspected, confiscated, "
"modified, or misused. It aims to provide practical recommendations to make "
"the Butter Box more physically and digitally tamper-resistant."
msgstr ""
#. type: Plain text
#: docs/security.mdx:11
#, markdown-text
msgid ""
"Following the recommendations in this guide will help reduce risk, not "
"guarantee absolute security. Butter Box is assumed to be a field-deployable, "
"low-cost, offline system, so these recommendations prioritize realistic, "
"maintainable protections."
msgstr ""
#. type: Plain text
#: docs/security.mdx:13
#, markdown-text, no-wrap
msgid "**Threat Model Assumptions**\n"
msgstr ""
#. type: Plain text
#: docs/security.mdx:15
#, markdown-text
msgid ""
"Before applying controls, clearly define your deployment context. This guide "
"assumes one or more of the following risks:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Physical access by unauthorized users"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Device confiscation or inspection by authorities"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Curious or malicious local users"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Content manipulation or replacement"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Network misuse or impersonation"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:22
#, markdown-text
msgid "Credential reuse or default configuration abuse"
msgstr ""
#. type: Plain text
#: docs/security.mdx:24
#, markdown-text
msgid ""
"Remember that controls should adapt to the local risk level, over-hardening "
"can reduce usability and trust."
msgstr ""
#. type: Title ###
#: docs/security.mdx:27
#, markdown-text, no-wrap
msgid "Section 1: Physical Tamper Resistance"
msgstr ""
#. type: Title ####
#: docs/security.mdx:29
#, markdown-text, no-wrap
msgid "Enclosure and Hardware Protection"
msgstr ""
#. type: Plain text
#: docs/security.mdx:32
#, markdown-text
msgid ""
"Physical access to the Butter Box allows SD card cloning, firmware "
"replacement, malware injection and broadcasting of malicious "
"information. PCB are also delicate and should have additional protection to "
"keep them safe from everyday handling and weather exposure."
msgstr ""
#. type: Plain text
#: docs/security.mdx:34 docs/security.mdx:48 docs/security.mdx:70
#: docs/security.mdx:83 docs/security.mdx:121 docs/security.mdx:130
#, markdown-text
msgid "Recommendations:"
msgstr ""
#. type: Bullet: '1. '
#: docs/security.mdx:38
#, markdown-text
msgid "Use a sealed or semi-sealed enclosure (screws instead of snap-fit)"
msgstr ""
#. type: Bullet: '2. '
#: docs/security.mdx:38
#, markdown-text
msgid "Prefer tamper-evident screws (Torx, security hex)"
msgstr ""
#. type: Bullet: '3. '
#: docs/security.mdx:38
#, markdown-text
msgid "Apply tamper-evident stickers over enclosure seams and SD card slots"
msgstr ""
#. type: Plain text
#: docs/security.mdx:42
#, markdown-text, no-wrap
msgid ""
"| 1) Sealed enclosures | 2) Screws "
"|\n"
"| --------------------------------- | "
"--------------------------------------- |\n"
"| ![](/img/docs/unknown.jpeg) | ![](</img/docs/unknown (1).jpeg>) |\n"
msgstr ""
#. type: Title ####
#: docs/security.mdx:43
#, markdown-text, no-wrap
msgid "![](</img/docs/void-tamper-evident seal.png>)"
msgstr ""
#. type: Title ####
#: docs/security.mdx:45
#, markdown-text, no-wrap
msgid "SD Card & Storage Protection"
msgstr ""
#. type: Bullet: '1. '
#: docs/security.mdx:53
#, markdown-text
msgid "Use high-quality SD cards to reduce corruption"
msgstr ""
#. type: Bullet: '2. '
#: docs/security.mdx:53
#, markdown-text
msgid "Encrypt sensitive partitions (where feasible)"
msgstr ""
#. type: Bullet: '3. '
#: docs/security.mdx:53
#, markdown-text
msgid "Keep content and OS separated (firmware vs content packs)"
msgstr ""
#. type: Bullet: '4. '
#: docs/security.mdx:53
#, markdown-text
msgid "Avoid labeling SD cards with sensitive identifiers"
msgstr ""
#. type: Plain text
#: docs/security.mdx:55
#, markdown-text
msgid "Optional (higher risk contexts):"
msgstr ""
#. type: Bullet: '1. '
#: docs/security.mdx:58
#, markdown-text
msgid ""
"Epoxy Resin. Electronico potting solutions ​​protect Printed Circuit Boards "
"from extreme temperatures, moisture, vibration, and other environmental "
"threats."
msgstr ""
#. type: Bullet: '2. '
#: docs/security.mdx:58
#, markdown-text
msgid "Physically block SD card removal"
msgstr ""
#. type: Plain text
#: docs/security.mdx:64
#, markdown-text, no-wrap
msgid ""
"| Epoxy Resin | Epoxy Resin "
"|\n"
"| --------------------------------------- | "
"--------------------------------------- |\n"
"| ![](</img/docs/unknown (3).jpeg>) | ![](</img/docs/unknown (4).jpeg>) |\n"
msgstr ""
#. type: Title ####
#: docs/security.mdx:65
#, markdown-text, no-wrap
msgid "![](</img/docs/unknown (5).jpeg>)"
msgstr ""
#. type: Title ####
#: docs/security.mdx:67
#, markdown-text, no-wrap
msgid "Power & Port Management"
msgstr ""
#. type: Bullet: '1. '
#: docs/security.mdx:75
#, markdown-text
msgid ""
"Disable or physically block unused ports (USB, HDMI). Inexpensive physical "
"port blockers can be used to reduce the risk of tampering with the Butter "
"Box by preventing unauthorized access to exposed interfaces. These blockers "
"limit the ability of bad actors to inject malicious code, connect "
"unauthorized peripherals, or broadcast unwanted content. Ports are sealed "
"with plastic blockers that can only be removed using a dedicated key "
"included in the deployment kit."
msgstr ""
#. type: Bullet: '2. '
#: docs/security.mdx:75
#, markdown-text
msgid ""
"Avoid exposing Ethernet ports unless required. Ethernet ports should remain "
"disabled or physically blocked unless they are explicitly required for the "
"deployment. When Ethernet access is necessary, its use should be clearly "
"documented and limited to trusted operators."
msgstr ""
#. type: Bullet: '3. '
#: docs/security.mdx:75
#, markdown-text
msgid "Use short internal cables to reduce easy probing"
msgstr ""
#. type: Bullet: '4. '
#: docs/security.mdx:75
#, markdown-text
msgid "Label power banks generically (avoid project names)"
msgstr ""
#. type: Plain text
#: docs/security.mdx:79
#, markdown-text, no-wrap
msgid ""
"| USB & HDMI | Ethernet Ports "
"|\n"
"| --------------------------------------- | "
"--------------------------------------- |\n"
"| ![](</img/docs/unknown (6).jpeg>) | ![](</img/docs/unknown (7).jpeg>) |\n"
msgstr ""
#. type: Title ####
#: docs/security.mdx:80
#, markdown-text, no-wrap
msgid "Environmental & Operational Practices"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:88
#, markdown-text
msgid "Store boxes in controlled locations when not in use"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:88
#, markdown-text
msgid "Rotate devices periodically in long deployments"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:88
#, markdown-text
msgid "Assume devices may be copied or lost"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:88
#, markdown-text
msgid ""
"Treat Butter Boxes as semi-disposable infrastructure, not personal "
"devices.<br/>"
msgstr ""
#. type: Title ###
#: docs/security.mdx:89
#, markdown-text, no-wrap
msgid "Section 2: Digital Tamper Resistance"
msgstr ""
#. type: Title ####
#: docs/security.mdx:91
#, markdown-text, no-wrap
msgid "Credential Hygiene (Critical)"
msgstr ""
#. type: Plain text
#: docs/security.mdx:94
#, markdown-text
msgid "Mandatory actions:"
msgstr ""
#. type: Plain text
#: docs/security.mdx:96
#, markdown-text
msgid "SSH"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:100
#, markdown-text
msgid "By default, the pi user has the password butterbox-admin."
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:100
#, markdown-text
msgid "Change this password by sshing into the pi and running passwd."
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:100
#, markdown-text
msgid ""
"If you'd prefer to use an SSH key, be sure to disable password access once "
"you enable key-based access."
msgstr ""
#. type: Plain text
#: docs/security.mdx:102
#, markdown-text
msgid "RaspAP"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:106
#, markdown-text
msgid ""
"The access point has an administrative interface that can be used to change "
"its settings."
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:106
#, markdown-text
msgid "Defaults: user: admin, password: secret (ironically, this is not secret)."
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:106
#, markdown-text
msgid ""
"Change this by logging in at[ "
"http://butterbox.lan/admin](http://butterbox.lan/admin) (or[ "
"http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for "
"a Spanish language box) and using the Web UI."
msgstr ""
#. type: Plain text
#: docs/security.mdx:108
#, markdown-text
msgid "Chat"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:111
#, markdown-text
msgid ""
"The local chat was created by an administrative user called "
"butterbox-admin. The password for this user is also butterbox-admin."
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:111
#, markdown-text
msgid ""
"Change this password by logging into the Butter Box, going to the public "
"chatroom, then visiting your user profile and updating the password. At your "
"discretion, you may also wish to change the name from butterbox-admin so "
"that other users will recognize you."
msgstr ""
#. type: Plain text
#: docs/security.mdx:113
#, markdown-text
msgid "Best practices:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:117
#, markdown-text
msgid "Use unique passwords per deployment"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:117
#, markdown-text
msgid "Store credentials offline in secure documentation"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:117
#, markdown-text
msgid "Never reuse credentials across regions"
msgstr ""
#. type: Title ####
#: docs/security.mdx:118
#, markdown-text, no-wrap
msgid "Service Hardening"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:126
#, markdown-text
msgid "Disable services not strictly required:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:126
#, markdown-text
msgid "SSH (or restrict to key-based auth)"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:126
#, markdown-text
msgid "Bluetooth"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:126
#, markdown-text
msgid "USB ports"
msgstr ""
#. type: Title ####
#: docs/security.mdx:127
#, markdown-text, no-wrap
msgid "Content Integrity & Authenticity"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:134
#, markdown-text
msgid "Keep firmware immutable during normal operation"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:134
#, markdown-text
msgid "Maintain a known-good baseline image"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:134
#, markdown-text
msgid "Re-flash devices periodically in long deployments"
msgstr ""
#. type: Plain text
#: docs/security.mdx:136
#, markdown-text
msgid "Operational control:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:139
#, markdown-text
msgid "Only trusted operators should install or update content"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:139
#, markdown-text
msgid "Document update sources and dates"
msgstr ""
#. type: Title ###
#: docs/security.mdx:142
#, markdown-text, no-wrap
msgid "Section 3: Misuse & Abuse Mitigation"
msgstr ""
#. type: Title ####
#: docs/security.mdx:144
#, markdown-text, no-wrap
msgid "Local Chat & Content Abuse"
msgstr ""
#. type: Plain text
#: docs/security.mdx:147
#, markdown-text
msgid "Risks:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:151
#, markdown-text
msgid "Harassment or hate speech"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:151
#, markdown-text
msgid "Impersonation"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:151
#, markdown-text
msgid "Disinformation spread"
msgstr ""
#. type: Plain text
#: docs/security.mdx:153
#, markdown-text
msgid "Mitigations:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:159
#, markdown-text
msgid "Clear usage guidelines displayed locally"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:159
#, markdown-text
msgid "Community moderation roles (if appropriate)"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:159
#, markdown-text
msgid "Ability to reset or wipe chat data quickly"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:159
#, markdown-text
msgid "Limit who can upload or replace content"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:159
#, markdown-text
msgid "Keep a read-only mode for most users"
msgstr ""
#. type: Title ###
#: docs/security.mdx:162
#, markdown-text, no-wrap
msgid "Section 4: Incident Response & Recovery"
msgstr ""
#. type: Plain text
#: docs/security.mdx:165
#, markdown-text
msgid "Prepare for compromise:"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:169
#, markdown-text
msgid "Assume some devices will be tampered with"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:169
#, markdown-text
msgid "Maintain a simple wipe and re-flash procedure"
msgstr ""
#. type: Bullet: '* '
#: docs/security.mdx:169
#, markdown-text
msgid "Track deployments"
msgstr ""
#. type: Plain text
#: docs/security.mdx:170 docs/faq/how-to-reformat-your-usb-drive.mdx:57
#, markdown-text, no-wrap
msgid "<br/>\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/case-studies.mdx:1
#, no-wrap
msgid "9"
msgstr ""
#. type: Title #
#: docs/case-studies.mdx:4
#, markdown-text, no-wrap
msgid "Use Cases"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:6
#, markdown-text, no-wrap
msgid "1. Digital Security training to distribute apps and materials"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:11
#, markdown-text, no-wrap
msgid ""
"> Leaders from Southern Africa countries travel to provide training, audits, "
"and consultations to organizations about digital security, physical safety, "
"risk assessments, and to equip journalists, activists and human rights "
"defenders with the tools and knowledge to do their job safer. In order to do "
"their work effectively, these leaders need to be able to curate specific "
"types of content to fit various use cases, in different contexts and "
"languages and different formats. In offline situations (load shedding, no "
"access to the internet or in times of internet shutdowns) the ability to "
"successfully deliver trainings and content becomes almost impossible. \\\n"
"> \\\n"
"> They shared more than a few times that if they did not have the Butter "
"Box, some sessions would have been canceled.\n"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:12
#, markdown-text, no-wrap
msgid "2. Sharing & Media Backup"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:15
#, markdown-text, no-wrap
msgid ""
"> Often M. wants to share music and movie files that they’ve downloaded on "
"their computer with their friends — but transferring with cables or "
"Bluetooth is a pain. So they've set up a Butter Box with their media "
"collection — music files, films and photos. They plugged it in near the "
"kitchen, and now anyone in their apartment can connect to the Butter Wi‑Fi "
"and browse a shared media library. No internet needed, and no more "
"file-by-file transfers.\n"
msgstr ""
#. type: Title ###
#: docs/case-studies.mdx:16
#, markdown-text, no-wrap
msgid "3. Temporary file storage"
msgstr ""
#. type: Plain text
#: docs/case-studies.mdx:18
#, markdown-text, no-wrap
msgid ""
"> On a remote site with no cell service, workers needed a way to temporarily "
"offload large files — like site photos or documents — from their "
"phones. Using Butter Box’s local encrypted message board, they sent files to "
"themselves or coworkers for safekeeping. Files stayed on the device until "
"retrieved later, even without power or signal.\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/quick-start.mdx:1 docs/build-a-box/pc-laptop.mdx:1
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:1
#: docs/content-packs/maps.mdx:1 docs/content-packs/apps/f-droid-repo.mdx:1
#: docs/faq/how-to-reformat-your-usb-drive.mdx:1
#: docs/services/file-sharing.mdx:1
#, no-wrap
msgid "2"
msgstr ""
#. type: Title #
#: docs/quick-start.mdx:4
#, markdown-text, no-wrap
msgid "Quick Start"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:7
#, markdown-text
msgid ""
"If you have a Butter Box with the latest version of the Butter software "
"loaded on the SD card, take these quick steps to get set up."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:8
#, markdown-text, no-wrap
msgid "Check supplies"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:11
#, markdown-text
msgid "Make sure you have the supplies for a basic box:"
msgstr ""
#. type: Bullet: '* '
#: docs/quick-start.mdx:17
#, markdown-text
msgid "[ ] Power source"
msgstr ""
#. type: Bullet: '* '
#: docs/quick-start.mdx:17
#, markdown-text
msgid "[ ] USB drive"
msgstr ""
#. type: Bullet: '* '
#: docs/quick-start.mdx:17
#, markdown-text
msgid "[ ] USB Adapters (as needed)"
msgstr ""
#. type: Bullet: '* '
#: docs/quick-start.mdx:17
#, markdown-text
msgid "[ ] Butter Box Device (with micro SD card inserted)"
msgstr ""
#. type: Bullet: '* '
#: docs/quick-start.mdx:17
#, markdown-text
msgid "[ ] Case"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:19
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/signal-2025-08-21-140334_003.jpeg\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:20
#, markdown-text, no-wrap
msgid "Make sure the micro SD card is inserted into the device"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:23
#, markdown-text
msgid "The micro SD card should have the latest version of Butter OS running on it."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:24
#, markdown-text, no-wrap
msgid "Plug it in to power on"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:27
#, markdown-text
msgid ""
"Connect the power supply to the first micro USB port and correct wall "
"outlet."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:29
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/1.png\" alt=\"\" "
"width=\"375\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:31
#, markdown-text
msgid ""
"You will know the box is working if ‘butterbox’ wifi appears in the wifi "
"list on your phone or computer. If it doesn’t, unplug the box and plug it "
"back in."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:35
#, markdown-text
msgid ""
"_If using a solar battery or other means of power, use one with the correct "
"specs to ensure adequate power and avoid damage to the unit. For a Pi Zero 2 "
"W use Micro USB power supply with at least 2.0A._"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:37
#, markdown-text
msgid "[Link to Power Supply Options](build-a-box/power-supply)"
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:40
#, markdown-text, no-wrap
msgid "Insert USB drive"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:43
#, markdown-text
msgid ""
"Connect the USB adapter to the open port. Then plug in the USB drive. Learn "
"more about loading the USB drive with treasures in the [File "
"Sharing](services/file-sharing) section."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:45
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/2.png\" alt=\"\" "
"width=\"375\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:46
#, markdown-text, no-wrap
msgid "Access the Butter Box Portal"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:49
#, markdown-text
msgid ""
"Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the "
"box. This connects you to **http://butterbox.local** in a browser."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:51
#, markdown-text
msgid "[https://youtu.be/KB5O9MSoaAg](https://youtu.be/KB5O9MSoaAg)"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:53
#, markdown-text, no-wrap
msgid ""
"<div align=\"center\"><figure><img src=\"/img/docs/qr code.png\" alt=\"\" "
"width=\"375\"/><figcaption></figcaption></figure></div>\n"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:55
#, markdown-text
msgid ""
"_If this page does not load, wait a few minutes to ensure "
"connectivity. Refresh the page. If you’re connecting from a smartphone, turn "
"off your mobile data or turn on airplane mode. Then try again._"
msgstr ""
#. type: Fenced div block (info)
#: docs/quick-start.mdx:56
#, no-wrap
msgid ""
"This is an HTTP page, not HTTPS, because it's served from a local device "
"with no internet connection. Your data never leaves the network, so it's "
"still private and secure.\n"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:61
#, markdown-text
msgid ""
"The Wi-Fi does not have a password by default. Though, you can easily add "
"one in the Admin Settings."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:62
#, markdown-text, no-wrap
msgid "Once connected, use Admin Settings to set up your box."
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:65
#, markdown-text
msgid ""
"The admin setup wizard is designed to give you choice over which services "
"are offered on the box and to increase its security. You will be prompted to "
"go to Admin Settings if this is the first time you've used the box."
msgstr ""
#. type: Title ###
#: docs/quick-start.mdx:66
#, markdown-text, no-wrap
msgid "Share access to the portal"
msgstr ""
#. type: Plain text
#: docs/quick-start.mdx:69
#, markdown-text
msgid ""
"Once you share with others, they will connect to it in the same way you just "
"did."
msgstr ""
#. type: Fenced div block (info)
#: docs/quick-start.mdx:70
#, no-wrap
msgid ""
"For a Pi Zero 2 W: Up to 5 people can connect to the box at any time. After "
"people connect and get what they need, encourage them to leave the box to "
"give others a turn.\\\n"
"The physical reach of the Box varies. But as a rule of thumb, people in the "
"same room as the box (or in talking distance) will be able to access it.\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/update-butter.mdx:1
#, no-wrap
msgid "6"
msgstr ""
#. type: Title #
#: docs/update-butter.mdx:4
#, markdown-text, no-wrap
msgid "Update Butter"
msgstr ""
#. type: Title ###
#: docs/update-butter.mdx:6
#, markdown-text, no-wrap
msgid "Check out new releases from the Butter Box team"
msgstr ""
#. type: Plain text
#: docs/update-butter.mdx:9 docs/build-a-box/raspberry-pi/install-butter.mdx:19
#, markdown-text
msgid "[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)"
msgstr ""
#. type: Fenced div block (info)
#: docs/update-butter.mdx:10
#, no-wrap
msgid "Always choose the Latest Version of the file\n"
msgstr ""
#. type: Title ###
#: docs/update-butter.mdx:14
#, markdown-text, no-wrap
msgid "Early Access Development Releases"
msgstr ""
#. type: Plain text
#: docs/update-butter.mdx:17
#, markdown-text
msgid ""
"WARNING: These are early releases posted for development testing and MUST "
"NOT be used in production deployments."
msgstr ""
#. type: Plain text
#: docs/update-butter.mdx:19
#, markdown-text
msgid ""
"[Download Early Access Development "
"Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)"
msgstr ""
#. type: Title ###
#: docs/update-butter.mdx:20
#, markdown-text, no-wrap
msgid "Update your Butter Box"
msgstr ""
#. type: Plain text
#: docs/update-butter.mdx:22
#, markdown-text
msgid ""
"Update your Butter Box using the same guide with the steps you take when you "
"are setting a Butter Box up for the first time. You can find it here: "
"[Raspberry Pi Install](build-a-box/raspberry-pi/install-butter)"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/build-a-box/index.mdx:1
#, no-wrap
msgid "DIY instructions"
msgstr ""
#. type: Title #
#: docs/build-a-box/index.mdx:5
#, markdown-text, no-wrap
msgid "Build A Box"
msgstr ""
#. type: Plain text
#: docs/build-a-box/index.mdx:8
#, markdown-text
msgid ""
"Don’t have a Butter Box yet? You can easily build your own. Choose your "
"setup to get started."
msgstr ""
#. type: Title ##
#: docs/build-a-box/index.mdx:9
#, markdown-text, no-wrap
msgid "Butter Box Setups"
msgstr ""
#. type: Plain text
#: docs/build-a-box/index.mdx:12
#, markdown-text
msgid ""
"Butter Box software currently runs on Raspberry Pi devices: Pi Zero 2 and Pi "
"4. You can use either one. See comparison chart below for details."
msgstr ""
#. type: Plain text
#: docs/build-a-box/index.mdx:18
#, markdown-text, no-wrap
msgid ""
"| Device "
"| Capacity | "
"Supplies |\n"
"| "
"-------------------------------------------------------------------------------------------------------------------------------- "
"| ----------------------------------------------------------------- | "
"------------------------------------------------- |\n"
"| <p><strong>Basic</strong> </p><p>Raspberry Pi Zero Pi 2<br/><br/><a "
"href=\"raspberry-pi/basic-box-supplies\">Get Started</a></p> | Up to 10 "
"people, About 10 meters apart | [Supply "
"List](raspberry-pi/basic-box-supplies) |\n"
"| <p><strong>Extended</strong> </p><p>Raspberry Pi 4 + Router<br/><br/><a "
"href=\"raspberry-pi/extend-your-box\">Get Started</a></p> | Up to 20 people, "
"About 30 meters apart when paired with a router | [Supply "
"List](raspberry-pi/extend-your-box) |\n"
"| PC/Laptop (amd64) "
"| _Coming soon_ | "
"_Coming soon_ |\n"
msgstr ""
#. type: Plain text
#: docs/build-a-box/index.mdx:20
#, markdown-text
msgid ""
"We also make and ship Butter Boxes to partners worldwide. If you serve a "
"community that could benefit, we’d love to hear from you."
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/build-a-box/pc-laptop.mdx:1
#, no-wrap
msgid "How to turn an old PC into golden deliciuos butter!"
msgstr ""
#. type: Title #
#: docs/build-a-box/pc-laptop.mdx:6
#, markdown-text, no-wrap
msgid "PC/Laptop Support (BETA!)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:9
#, markdown-text
msgid ""
"An important new development for the ButterBox project is the ability to "
"turn any Intel or AMD 64-bit PC into a ButterBox. In many places in the "
"world, getting access to an official RaspberryPi is difficult and "
"expensive. However, no matter where you are in the world, there seem to be "
"plenty of \"old\", unloved, discarded PC towers and laptops."
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:11
#, markdown-text
msgid ""
"This page will help you bring new life to that old tech, by turning it into "
"the best kind of buttery local microserver, that even has a built-in "
"battery, screen and keyboard!"
msgstr ""
#. type: Title ##
#: docs/build-a-box/pc-laptop.mdx:12
#, markdown-text, no-wrap
msgid "Download the Image"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:15
#, markdown-text
msgid ""
"Access to new images of ButterBox built for Intel/AMD64 devices are now "
"available IN EARLY BETA through our [development image distribution "
"site](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list). "
"Download the latest image that beings with \"amd64_butter_main_\"."
msgstr ""
#. type: Title ##
#: docs/build-a-box/pc-laptop.mdx:16
#, markdown-text, no-wrap
msgid "How to Flash"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:19
#, markdown-text
msgid ""
"This image can be flashed to a bootable USB drives, using "
"[balenaEtcher](https://etcher.balena.io/)."
msgstr ""
#. type: Bullet: '1. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid "Install balenaEtcher"
msgstr ""
#. type: Bullet: '2. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid ""
"Download the AMD64 image and unpack it (remove .tar and .gz with \"unzip\" "
"tool)"
msgstr ""
#. type: Bullet: '3. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid "Select the image file in balenaEtcher"
msgstr ""
#. type: Bullet: '4. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid "Plugin the USB flash drive"
msgstr ""
#. type: Bullet: '5. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid "Select the drive in balenaEtcher"
msgstr ""
#. type: Bullet: '6. '
#: docs/build-a-box/pc-laptop.mdx:26
#, markdown-text
msgid "Flash!"
msgstr ""
#. type: Title ##
#: docs/build-a-box/pc-laptop.mdx:27
#, markdown-text, no-wrap
msgid "How to Boot Up"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:30
#, markdown-text
msgid ""
"Once the USB drive is flashed, you can now use it to boot up ButterBox on "
"your old PC."
msgstr ""
#. type: Bullet: '1. '
#: docs/build-a-box/pc-laptop.mdx:36
#, markdown-text
msgid ""
"Boot your old PC into the \"BIOS\" screen. Make sure it is configured to "
"allow for booting from the USB drive, before it boots the internal hard "
"drive."
msgstr ""
#. type: Bullet: '2. '
#: docs/build-a-box/pc-laptop.mdx:36
#, markdown-text
msgid "Shutdown the PC."
msgstr ""
#. type: Bullet: '3. '
#: docs/build-a-box/pc-laptop.mdx:36
#, markdown-text
msgid "Plug in the USB drive to the PC"
msgstr ""
#. type: Bullet: '4. '
#: docs/build-a-box/pc-laptop.mdx:36
#, markdown-text
msgid "Start the PC, and make sure it boots from the USB drive."
msgstr ""
#. type: Bullet: '5. '
#: docs/build-a-box/pc-laptop.mdx:36
#, markdown-text
msgid "Wait for the login terminal to appear!"
msgstr ""
#. type: Title ##
#: docs/build-a-box/pc-laptop.mdx:37
#, markdown-text, no-wrap
msgid "How to Access"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:40
#, markdown-text
msgid ""
"Once the ButterBox PC is booted up, and plugged into a local router, it "
"should be ready to access!"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:42
#, markdown-text
msgid ""
"Connect your personal device to the same network, and try to access "
"[http://butterbox.local](http://butterbox.local)"
msgstr ""
#. type: Title ##
#: docs/build-a-box/pc-laptop.mdx:43
#, markdown-text, no-wrap
msgid "Differences from RaspberryPi edition"
msgstr ""
#. type: Plain text
#: docs/build-a-box/pc-laptop.mdx:46
#, markdown-text
msgid ""
"There are some important differences between ButterBox on PC versus on "
"RaspberryPi"
msgstr ""
#. type: Bullet: '- '
#: docs/build-a-box/pc-laptop.mdx:49
#, markdown-text
msgid ""
"There is no built-in wifi hotspot. You must plug it into a dedicated wifi "
"router or network."
msgstr ""
#. type: Bullet: '- '
#: docs/build-a-box/pc-laptop.mdx:49
#, markdown-text
msgid ""
"You can easily access the terminal \"root\" user to update and configured "
"(with great power, comes great responsibility!)"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/build-a-box/power-supply.mdx:1
#: docs/build-a-box/raspberry-pi/power-supply.mdx:1
#, no-wrap
msgid "Different ways to power your Butter Box"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/build-a-box/power-supply.mdx:1
#: docs/build-a-box/raspberry-pi/install-butter.mdx:1
#: docs/services/local-chat.mdx:1
#, no-wrap
msgid "3"
msgstr ""
#. type: Title #
#: docs/build-a-box/power-supply.mdx:6
#: docs/build-a-box/raspberry-pi/power-supply.mdx:5
#, markdown-text, no-wrap
msgid "Power Supply"
msgstr ""
#. type: Plain text
#: docs/build-a-box/power-supply.mdx:9
#: docs/build-a-box/raspberry-pi/power-supply.mdx:8
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/power-supply.mdx:15
#: docs/build-a-box/raspberry-pi/power-supply.mdx:14
#, markdown-text
msgid ""
"**Wall Outlet:** The official and recommended power supply for Raspberry Pi "
"computers (depends of the Raspberry Pi model that you are using)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/power-supply.mdx:15
#: docs/build-a-box/raspberry-pi/power-supply.mdx:14
#, markdown-text
msgid ""
"**Pre-charged Battery Pack (Power Bank):** This is the most common option "
"for field use."
msgstr ""
#. type: Bullet: ' * '
#: docs/build-a-box/power-supply.mdx:15
#: docs/build-a-box/raspberry-pi/power-supply.mdx:14
#, markdown-text
msgid ""
"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)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/power-supply.mdx:15
#: docs/build-a-box/raspberry-pi/power-supply.mdx:14
#, markdown-text
msgid ""
"**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."
msgstr ""
#. type: Bullet: ' * '
#: docs/build-a-box/power-supply.mdx:15
#: docs/build-a-box/raspberry-pi/power-supply.mdx:14
#, markdown-text
msgid ""
"Solar panel kits: "
"[https://voltaicsystems.com/solar-panel-kits/](https://voltaicsystems.com/solar-panel-kits/)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/power-supply.mdx:16
#: docs/build-a-box/raspberry-pi/power-supply.mdx:15
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/Screenshot 2025-07-31 at 10.55.41 PM.png\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Title #
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:4
#, markdown-text, no-wrap
msgid "Basic Box Supplies"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:7
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:9
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:11
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ##
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:12
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:12
#, markdown-text, no-wrap
msgid "Supplies"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20
#, markdown-text
msgid ""
"[ ] 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)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20
#, markdown-text
msgid ""
"[ ] Power outlet and power cord that accompanies the Raspberry Pi Zero 2W or "
"an [alternative power supply](../power-supply)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid ""
"[ ] 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."
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20
#, markdown-text
msgid "[ ] USB drive (min 32 GB)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:20
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid "[ ] Adapters (as needed)"
msgstr ""
#. type: Bullet: ' * '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:23
#, markdown-text
msgid "[ ] Micro USB/Male to USB A/Female"
msgstr ""
#. type: Bullet: ' * '
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:23
#, markdown-text
msgid "[ ] A dongle to connect the micro SD card to your laptop (if needed)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:27
#, markdown-text, no-wrap
msgid "**Once you have your supplies, continue in the Install Butter section.**\n"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:29
#, markdown-text
msgid "[install-butter.md](install-butter)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/basic-box-supplies.mdx:31
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/20250815_142828.jpg\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:1
#, no-wrap
msgid "How To Add a Router To Your Box Setup"
msgstr ""
#. type: Yaml Front Matter Hash Value: sidebar_position
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:1
#: docs/services/secure-messenger.mdx:1
#, no-wrap
msgid "4"
msgstr ""
#. type: Title #
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:6
#, markdown-text, no-wrap
msgid "Extend Your Box"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:9
#, markdown-text
msgid ""
"An extended Butter Box pairs the Raspberry Pi with a standalone Wi-Fi "
"router, giving stronger signal and more simultaneous connections."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:11
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid "[ ] Raspberry Pi 4, 5 or Raspberry Pi Zero 2W"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid ""
"[ ] 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)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid ""
"[ ] Power outlet and power cords that accompany the Raspberry Pi and the "
"Router or an [alternative power supply](../power-supply)"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:20
#, markdown-text
msgid "[ ] USB Drive (min 32 GB)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:22
#, markdown-text
msgid "_No internet connection is required._"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:24
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/20250815_142438.jpg\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Title ##
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:27
#, markdown-text, no-wrap
msgid "Steps"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:30
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:31
#, markdown-text, no-wrap
msgid "Connect the Butter Box to its power supply. "
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:34
#, markdown-text
msgid "Connect the Butter Box to power."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:35
#, markdown-text, no-wrap
msgid "Connect Router"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:38
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:39
#, markdown-text, no-wrap
msgid "Test Your Connection"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:42
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:43
#, markdown-text, no-wrap
msgid "Disable Butter Box Wi-Fi Access Point"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:46
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:47
#, markdown-text, no-wrap
msgid "Invite Users to Join the Router Wi-Fi"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/extend-your-box.mdx:49
#, markdown-text
msgid ""
"Users will now join the Wi-Fi network of the router when they want to "
"connect to the Butter Box."
msgstr ""
#. type: Title #
#: docs/build-a-box/raspberry-pi/index.mdx:4
#, markdown-text, no-wrap
msgid "Raspberry Pi"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/build-a-box/raspberry-pi/install-butter.mdx:1
#, no-wrap
msgid "Install Butter Operating System (OS) on an SD card for Raspberry Pi"
msgstr ""
#. type: Title #
#: docs/build-a-box/raspberry-pi/install-butter.mdx:6
#, markdown-text, no-wrap
msgid "Install Butter"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:9
#, markdown-text
msgid "You will need:"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/install-butter.mdx:13
#, markdown-text
msgid "Desktop computer"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/install-butter.mdx:13
#, markdown-text
msgid "Internet Connection"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/install-butter.mdx:13
#, markdown-text
msgid "Butter Box"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:14
#, markdown-text, no-wrap
msgid "Download the Butter OS for Raspberry Pi "
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:17
#: docs/build-a-box/raspberry-pi/install-butter.mdx:85
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Fenced div block (info)
#: docs/build-a-box/raspberry-pi/install-butter.mdx:20
#, no-wrap
msgid "Always choose the Latest Version of the file. \n"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:24
#, markdown-text, no-wrap
msgid "Plug the micro SD card into your computer"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:27
#, markdown-text
msgid ""
"To plug the micro SD card into your computer, you may need an adapter to do "
"this:"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:29
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Fenced div block (info)
#: docs/build-a-box/raspberry-pi/install-butter.mdx:30
#, no-wrap
msgid "You don't need to connect the box to the computer.\n"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:34
#, markdown-text, no-wrap
msgid "Run Raspberry Pi Imager "
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:37
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:39
#, markdown-text
msgid ""
"If you don't have Raspberry Pi Imager, you can download it here: "
"[https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:40
#, markdown-text, no-wrap
msgid "Choose device > **Raspberry Pi Zero 2 W**"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:43
#, markdown-text
msgid ""
"Once the Raspberry Pi Image starts, you will be prompt to select your "
"Raspberry Pi device."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:45
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:46
#, markdown-text, no-wrap
msgid "Choose Operating System > Use Custom"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/install-butter.mdx:49
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:51
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:52
#, markdown-text, no-wrap
msgid "Choose Storage > Select Micro SD Card"
msgstr ""
#. type: Bullet: '* '
#: docs/build-a-box/raspberry-pi/install-butter.mdx:55
#, markdown-text
msgid "From the **Storage** tab, select the **Micro SD Card.**"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:57
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:59
#, markdown-text
msgid "Your screen will look similar to this after all selections:"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:61
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:63
#, markdown-text
msgid ""
"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”_."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:65
#, markdown-text
msgid ""
"After that select _\"write\"_ and begin writing process to the Micro SD "
"card."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:66
#, markdown-text, no-wrap
msgid ""
"Remove From Computer and Insert Micro SD Card into the Raspberry Pi (Butter "
"Box)"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:69
#, markdown-text
msgid ""
"Once you're done, remove the Micro SD card. Insert the Micro SD card into "
"the Raspberry Pi (Butter Box) not powered on."
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:70
#, markdown-text, no-wrap
msgid "Go to Quick Start"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:73
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:75
#, markdown-text, no-wrap
msgid ""
"**If you are building an extended box, continue in the next section: Extend "
"Your Box.**\n"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:77
#, markdown-text
msgid "[extend-your-box.md](extend-your-box)"
msgstr ""
#. type: Title ###
#: docs/build-a-box/raspberry-pi/install-butter.mdx:80
#, markdown-text, no-wrap
msgid "Troubleshooting"
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:83
#, markdown-text
msgid ""
"If you see an error stating that the input file is not a valid disk image, "
"check the file you downloaded."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:87
#, markdown-text
msgid "Also confirm that you have **unzipped the file** before using it."
msgstr ""
#. type: Plain text
#: docs/build-a-box/raspberry-pi/install-butter.mdx:88
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/Screenshot 2026-02-24 at 1.28.37 PM.png\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/content-packs/index.mdx:1
#, no-wrap
msgid "Curated pluggable content"
msgstr ""
#. type: Title #
#: docs/content-packs/index.mdx:6
#, markdown-text, no-wrap
msgid "Content Packs"
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:9
#, markdown-text
msgid ""
"You can create your own content pack! It simply needs to be set up as a "
"**static website with local links**. This website will run from the box "
"itself, so all of the images and files required for the website need to be "
"contained within one main folder."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:11
#, markdown-text
msgid ""
"Once you have your static website ready, you will put all of the required "
"files for it in one folder, and place this folder in the **root directory** "
"of your USB drive. This website will be rendered in the browser people use "
"to access the Butter Box portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:13
#, markdown-text
msgid "Tips for creating a content pack with a static website:"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Contents.** Everything for the static website must be stored on a USB "
"drive that plugs into the Butter Box. It should not link to resources on the "
"global internet."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Size.** The size of your content pack is limited by the amount of space "
"available on your USB drive. Though, keep in mind that if multiple people "
"are downloading or watching really large files from the box, there may be "
"some latency."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Pages.** Links between pages should point to other saved pages in the same "
"folder, not to the internet. You must use relative paths "
"(e.g. about/index.html) instead of absolute web URLs."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Media.** Pictures, videos, and sounds cannot be linked to from somewhere "
"online. The files need to be in your website folder and stored on the USB "
"drive."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Libraries.** The website cannot use javascript libraries that rely on an "
"internet connection."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:20
#, markdown-text
msgid ""
"**Styles.** Special fonts and icons (like those from Google Fonts) also need "
"to be packed into the folder, not fetched from the web."
msgstr ""
#. type: Title ###
#: docs/content-packs/index.mdx:21
#, markdown-text, no-wrap
msgid "Try It"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/index.mdx:24
#, markdown-text
msgid ""
"The zip file below contains a sample static website. To get a feel for how "
"static websites work with butter—Download it. Unzip it. Then, add this set "
"of files to your USB drive."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:26
#, markdown-text
msgid "[Sample Static Website.zip](/img/docs/Sample%20Static%20Website.zip)"
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:28
#, markdown-text
msgid "You can also check out our [New Content Pack News](/blog/tags/contentpack)."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:32
#, markdown-text
msgid ""
"The best way to get started with creating your own content pack is to have "
"an idea about the experience and type of information you want to provide, "
"and then to design and build a local static website for it."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:34
#, markdown-text
msgid ""
"It can be very simple like an audio player for music. Or, a simple list of "
"the five top VPN apps that you recommend. Or it can be more complex like a "
"library or knowledge base of cultural artifacts."
msgstr ""
#. type: Title ###
#: docs/content-packs/index.mdx:37
#, markdown-text, no-wrap
msgid "Add website files to a USB drive"
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:40
#, markdown-text
msgid ""
"Place a folder with your website files in the **root directory** of a USB "
"drive. Be sure that your website folder contains your **index.html.** The "
"name of this folder will be displayed on the Butter Box portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:42
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/Screenshot 2025-08-16 at 9.46.16 PM.png\" "
"alt=\"\"/><figcaption><p>USB directory when viewed in Finder on "
"desktop</p></figcaption></figure>\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/index.mdx:43 docs/services/file-sharing.mdx:27
#, markdown-text, no-wrap
msgid "Connect to your Butter Box to view"
msgstr ""
#. type: Plain text
#: docs/content-packs/index.mdx:46
#, markdown-text
msgid ""
"Insert the USB drive into your Butter Box. When you open the Butter Box "
"portal, tap **Files**. Navigate to the website folder. Tap to view."
msgstr ""
#. type: Title #
#: docs/content-packs/maps.mdx:4
#, markdown-text, no-wrap
msgid "Maps"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:7
#, markdown-text
msgid ""
"You can make offline maps available from your Butter Box. These maps are "
"powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android."
msgstr ""
#. type: Fenced div block (warning)
#: docs/content-packs/maps.mdx:8
#, no-wrap
msgid ""
"**Important:** Offline map downloads work **only on Android devices**. iOS "
"is not supported.\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/maps.mdx:12
#, markdown-text, no-wrap
msgid "✅ Steps to Enable Maps"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:15
#, markdown-text, no-wrap
msgid "**1. Download the map files you need**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:18
#, markdown-text
msgid ""
"Visit: [OsmAnd Local Indexes "
"List](https://osmand.net/list?sortby=size\\&asc=false)"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:18
#, markdown-text
msgid "Choose and download the regions you want available offline."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:20
#, markdown-text, no-wrap
msgid "**2. Organize your files**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:23
#, markdown-text
msgid "On your USB drive, create a folder named `osm-map-files` ."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:23
#, markdown-text
msgid "Put the **OsmAnd APK** and all your **map files** into this folder."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:25
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png\" "
"alt=\"\"/><figcaption><p>USB directory when viewed in Finder on "
"desktop</p></figcaption></figure>\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:27
#, markdown-text, no-wrap
msgid "**3. Add to your Butter Box**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:30
#, markdown-text
msgid "Insert the USB drive into your Butter Box."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/maps.mdx:30
#, markdown-text
msgid ""
"The **Offline Maps** tile will automatically appear in your Butter Box "
"portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:32
#, markdown-text
msgid ""
"👉 That’s it — anyone using an **Android device** can now download OsmAnd and "
"the offline maps you’ve provided directly from your Butter Box."
msgstr ""
#. type: Plain text
#: docs/content-packs/maps.mdx:33
#, markdown-text
msgid ""
"Note: The OSM map apk is available on the Butter Box software image. Updates "
"to the OsmAnd app will be available with new releases of the Butter Box "
"software. If you want to know what the latest available version of OsmAnd "
"app is, visit [OsmAnd Free Releases — "
"Android](https://osmand.net/docs/versions/free-versions)."
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/content-packs/apps/f-droid-repo.mdx:1
#, no-wrap
msgid "How to Create Your Own F-Droid Repo to Share as a Content Pack"
msgstr ""
#. type: Title #
#: docs/content-packs/apps/f-droid-repo.mdx:6
#, markdown-text, no-wrap
msgid "F-Droid Repo"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:9
#, markdown-text
msgid ""
"You can build your own curated F-Droid repo using your computer's "
"terminal. Once set up, users can connect their F-Droid app to your Butter "
"Box and start downloading apps."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:12
#, markdown-text, no-wrap
msgid "Step 1: Install F-Droid Server Tools"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:15
#, markdown-text
msgid ""
"Before you begin, you need to install a tool called **fdroidserver**. This "
"helps you create and manage your app store."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:17
#, markdown-text, no-wrap
msgid "**On Mac (using Homebrew):**\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:18
#, no-wrap
msgid " brew install fdroidserver \n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:23
#, markdown-text, no-wrap
msgid "**On Linux (Debian/Ubuntu):**\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:24
#, no-wrap
msgid " sudo apt install fdroidserver \n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:28
#, markdown-text, no-wrap
msgid "Step 2: Check that it's installed correctly"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:31
#, markdown-text
msgid "After installation, run this command:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:32
#, no-wrap
msgid " fdroid version\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:37
#, markdown-text
msgid ""
"If everything is working, you will see a version number printed on the "
"screen."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:38
#, markdown-text, no-wrap
msgid "Step 3: Create Your Repo Folder"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:41
#, markdown-text
msgid ""
"You need to create the folder where you will save the repo files in your "
"computer, choose a name that aligns with the project or purpose of the apps "
"in it, and replace my-fdroid-repo for that name in the command."
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:42
#, no-wrap
msgid "mkdir -p ~/my-fdroid-repo\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:46
#, no-wrap
msgid "cd ~/my-fdroid-repo\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:50
#, markdown-text, no-wrap
msgid "Step 4: Initialize the repo"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:52
#, no-wrap
msgid "fdroid init\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:57
#, markdown-text
msgid "This creates the following directories in your repo file:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:58
#, no-wrap
msgid "Config.yml \n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:62
#, no-wrap
msgid "repo/\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:66
#, no-wrap
msgid "metadata/\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:70
#, markdown-text, no-wrap
msgid "Step 5: Add your APKs"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:73
#, markdown-text
msgid ""
"Copy your signed APKs into the repo/ folder. Ensure you only use apps from "
"trusted sources like the official F-Droid library or verified developers."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:75
#, markdown-text, no-wrap
msgid ""
"**Security Note:** Avoid downloading APKs from \"mirror\" sites or unknown "
"sources, as they can contain malware or trackers that compromise your users' "
"privacy.\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:76
#, no-wrap
msgid "cp /path/to/your/*.apk repo/\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:81
#, markdown-text
msgid "Example:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:82
#, no-wrap
msgid "cp ~/Downloads/myapp.apk repo/\n"
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:86
#, markdown-text, no-wrap
msgid "Step 6: Generate (and Update) the Repository Index"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:89
#, markdown-text
msgid ""
"Every time you add a new APK or a new version of an app to your repo/ "
"folder, you must run the following command to \"publish\" those changes:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:90
#, no-wrap
msgid "fdroid update --create-metadata\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:95
#, markdown-text
msgid "What this command does:"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
#, markdown-text
msgid "**Scans APKs:** It reads the new files in your repo/ folder."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
#, markdown-text
msgid ""
"**Generates Metadata:** It creates YAML files containing the app's name, "
"version, and permissions."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
#, markdown-text
msgid ""
"**Creates index.v1.jar:** This is the \"catalog\" file that the F-Droid app "
"downloads to see what is available."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:100
#, markdown-text
msgid ""
"**Signs the Repository:** It uses your secret key to sign the index, proving "
"to the Android app that the files haven't been tampered with."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/f-droid-repo.mdx:101
#, markdown-text, no-wrap
msgid "Step 7: Test your Repo locally"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:104
#, markdown-text
msgid ""
"To test your repo locally and ensure everything works before you share it on "
"the Butter Box, you can serve its content locally and add it to F-Droid "
"using a URL."
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:105
#, no-wrap
msgid "cd repo\n"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:109
#, no-wrap
msgid "python3 -m http.server 8000\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:114
#, markdown-text, no-wrap
msgid ""
"Once your repo is live, open the F-Droid app on your device and navigate to "
"**Settings > Repositories > \"+\"**. Select **\"Enter repository URL "
"manually\"** to add your new source.\n"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:116
#, markdown-text
msgid ""
"Adding the repo manually allows you to verify the user experience by "
"checking:"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
#, markdown-text
msgid "**App Visibility:** Are all your apps appearing in the list?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
#, markdown-text
msgid "**Visual Assets:** Are icons and screenshots displaying correctly?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
#, markdown-text
msgid ""
"**Categorization:** Are apps appearing in the correct sections (e.g., "
"Internet, Security)?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
#, markdown-text
msgid ""
"**Functionality:** Do the downloads and installations complete without "
"errors?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/f-droid-repo.mdx:122
#, markdown-text
msgid ""
"**Metadata:** Does the version number and description match your `repo/` "
"files?"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:126
#, markdown-text
msgid "Your repo will be available at:"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:128
#, markdown-text
msgid "`http://YOUR-IP:8000/repo`"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/f-droid-repo.mdx:132
#, markdown-text, no-wrap
msgid "**Find your IP:**\n"
msgstr ""
#. type: Title ####
#: docs/content-packs/apps/f-droid-repo.mdx:133
#, markdown-text, no-wrap
msgid "macOS:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:135
#, no-wrap
msgid "ipconfig getifaddr en0\n"
msgstr ""
#. type: Title ####
#: docs/content-packs/apps/f-droid-repo.mdx:139
#, markdown-text, no-wrap
msgid "Linux:"
msgstr ""
#. type: Fenced code block
#: docs/content-packs/apps/f-droid-repo.mdx:141
#, no-wrap
msgid "hostname -I\n"
msgstr ""
#. type: Title #
#: docs/content-packs/apps/index.mdx:4
#, markdown-text, no-wrap
msgid "Apps"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:7
#, markdown-text
msgid ""
"You can share apps as a content pack, via a static website. If you give a "
"folder the name `appstore` and place it in the root directory of the USB "
"drive, the **Apps** tile will appear in the Butter Box portal."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:9
#, markdown-text, no-wrap
msgid "**Things To Know**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:14
#, markdown-text
msgid ""
"If you are sharing apps from Butter Box, you will need to download the app "
"files you want to share. Apps are updated frequently. Be sure to manually "
"update all of the app files frequently to ensure you are providing the "
"highest security for the people who connect to the box."
msgstr ""
#. type: Bullet: ' * '
#: docs/content-packs/apps/index.mdx:14
#, markdown-text
msgid ""
"You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe and "
"trusted source."
msgstr ""
#. type: Bullet: ' * '
#: docs/content-packs/apps/index.mdx:14
#, markdown-text
msgid ""
"Butter won’t automatically verify the source, so it's up to you to confirm "
"it's clean and legal to share."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:14
#, markdown-text
msgid ""
"How to get apk files: There are mobile apps you can use to get access to apk "
"files on an Android phone. Alternatively, you can download app files "
"directly from the developer's website."
msgstr ""
#. type: Title ###
#: docs/content-packs/apps/index.mdx:15
#, markdown-text, no-wrap
msgid "Go Further: Butter Box Supports Sharing Via F-Droid"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:18
#, markdown-text
msgid ""
"Additionally, Butter Box supports app distribution via F-Droid. In your "
"content pack, you can include the F-Droid `.apk` and a QR code for your "
"repo. Anyone with access to the Box can then download the F-Droid app while "
"offline, and add the repo."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:20
#, markdown-text
msgid ""
"As long as they are connected to the Butter Box, they can download any of "
"the apps within your repo."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:22
#, markdown-text
msgid ""
"If they are connected to the internet later, they can receive app updates "
"from any apps in your repo that are also included in the official F-Droid "
"repo. If you update the apps in your repo, they will also have access to "
"those."
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:24
#, markdown-text
msgid "What is a F-Ddroid Repo?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
#, markdown-text
msgid "A hosted library of apps\\ Why use it?"
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
#, markdown-text
msgid ""
"It offers a secure process for sharing apps. The F-Droid team builds apps in "
"the official F-Droid repo from the source code themselves. This ensures that "
"the app you download exactly matches the code the developer published."
msgstr ""
#. type: Bullet: '* '
#: docs/content-packs/apps/index.mdx:29
#, markdown-text
msgid ""
"Users installing from F-Droid have access to app updates remotely (away from "
"the Butter Box)"
msgstr ""
#. type: Plain text
#: docs/content-packs/apps/index.mdx:30
#, markdown-text
msgid ""
"Technical skills are required to create your own F-Droid repo. Refer to the "
"[F-Droid Repo](f-droid-repo) Section for instructions."
msgstr ""
#. type: Title #
#: docs/faq/how-to-reformat-your-usb-drive.mdx:4
#, markdown-text, no-wrap
msgid "How to Reformat Your USB Drive"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:7
#, markdown-text
msgid ""
"After connecting your USB drive to the Raspberry Pi you will see the "
"“Explore USB” title displayed on the portal. If you’ve tried refreshing your "
"portal page and still do not see the “Explore USB” tile then you may need to "
"erase your USB stick and reformat it."
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:9
#, markdown-text, no-wrap
msgid "![](/img/docs/unknown.png)<br/>\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:13
#, markdown-text, no-wrap
msgid ""
"When you format a USB drive, all files and folders on the drive are removed "
"and replaced with a new file system. This can help repair any issues with "
"the flash drive itself or make it compatible with new files you want to "
"transfer. Be sure to back up your files before formatting your "
"drive. <br/>\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:15
#, markdown-text, no-wrap
msgid "**Check the Format of the USB**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
#, markdown-text
msgid "On your desktop or laptop, plug in your USB"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Right, or double-click on the USB"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
#, markdown-text
msgid "Click on “Get info” and verify the Format"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:20
#, markdown-text
msgid "Your USB needs to be formatted to ExFat or Fat32, MS-DOS (FAT)."
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:24
#, markdown-text, no-wrap
msgid "**Reformatting Steps on MacOS:**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "Connect the USB drive to a USB port on your computer."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Click on “Erase Disk…”"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "You can rename your USB at this time"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Select the correct format, either ExFat or ExFat32 or MS-DOS (FAT)"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Then tap “Erase”"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid ""
"A message may appear warning you that all content will be deleted. Select "
"“Erase”"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid ""
"This may take a few minutes. The USB will disappear and reappear on your "
"homescreen"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Verify the drive is correctly formatted"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:36
#, markdown-text
msgid "Click on “Get info” and verify the Format<br/>"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:38
#, markdown-text, no-wrap
msgid "**Reformatting Steps on Windows:**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "Open the File Explorer and select \"This PC\" from the menu."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid ""
"You can find this option in the left panel, next to a monitor "
"icon.[\\[2\\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)"
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "On Windows 7, click Computer on the right side of the Start window."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid ""
"Right-click the flash drive's icon. It's beneath the \"Devices and drives\" "
"heading in the middle of the page. This will bring up a drop-down menu."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "Choose \"Format\". This will open the formatting window."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "Click on \"File System\" and choose the MS-DOS, FAT32, or exFAT format."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid ""
"[FAT32](https://www.wikihow.com/Format-FAT32) - The most widely compatible "
"format. Works with most computers and gaming consoles."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid ""
"exFAT - Similar to FAT32, but designed for external hard drives (e.g., flash "
"drives) and quicker use. It's a universal format that is most common across "
"Windows, Linux, and Mac."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid "Select \"Start\" and click \"OK\" to finish formatting your flash drive."
msgstr ""
#. type: Bullet: '* '
#: docs/faq/how-to-reformat-your-usb-drive.mdx:50
#, markdown-text
msgid ""
"A final prompt will appear, Click “OK”. Your flash drive has successfully "
"been formatted.<br/>"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:52
#, markdown-text, no-wrap
msgid ""
"![](</img/docs/unknown (1).png>)![](</img/docs/unknown "
"(2).png>)![](</img/docs/unknown (3).png>)\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:54
#, markdown-text, no-wrap
msgid "![](</img/docs/unknown (4).png>)\n"
msgstr ""
#. type: Plain text
#: docs/faq/how-to-reformat-your-usb-drive.mdx:56
#, markdown-text, no-wrap
msgid "![](</img/docs/unknown (5).png>)\n"
msgstr ""
#. type: Title #
#: docs/faq/index.mdx:4
#, markdown-text, no-wrap
msgid "FAQ"
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:6
#, markdown-text, no-wrap
msgid "Does the Butter Box give me the internet?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:9
#, markdown-text
msgid ""
"Not quite. The Butter Box doesn’t provide internet access. Instead, it "
"creates its own local Wi-Fi network that lets you access apps, content "
"(previously set up), and message board features offline . Everything is "
"stored and shared locally — no internet or data connection needed."
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:12
#, markdown-text, no-wrap
msgid "How do you power a Butter Box?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:15
#, markdown-text
msgid ""
"The Butter Box is super flexible! You can power it using a USB power bank, a "
"wall adapter, or even a small solar panel. As long as it provides power to "
"the Raspberry Pi, you’re good to go. Go to the [Power "
"Supply](../build-a-box/power-supply) section to learn more."
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:18
#, markdown-text, no-wrap
msgid "If I’m powering the Butter Box with a solar panel, do I need a power bank?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:21
#, markdown-text
msgid ""
"A power bank isn’t strictly required, but it’s highly recommended. Solar "
"panels can be inconsistent — clouds, shade, or changing sunlight can "
"interrupt power. A power bank helps smooth that out by storing energy and "
"keeping the Butter Box running steadily, even when sunlight dips. Check it "
"out this use case to know more: (insert use case URL)"
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:24
#, markdown-text, no-wrap
msgid ""
"What are the security features of the Butter Box? Can I put a password on "
"it?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:27
#, markdown-text
msgid ""
"Currently, the Butter Box broadcasts an open Wi-Fi network — that means no "
"password is required to connect. This makes it easy for people nearby to "
"join, especially in offline or community settings."
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:29
#, markdown-text
msgid ""
"However, users must either enter the Butter Box’s local IP address manually, "
"or scan a QR code that takes them directly to the content. Since it’s all "
"offline, there’s no exposure to the internet or external threats."
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:31
#, markdown-text
msgid ""
"You can configure the Raspberry Pi to require a Wi-Fi password in the admin "
"settings. Refer to the [Security](../security) section for more security "
"features."
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:34
#, markdown-text, no-wrap
msgid "How much storage does a Butter Box have?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:37
#, markdown-text
msgid ""
"The Butter Box storage capacity is defined by the microSD card you install — "
"it doesn’t have fixed built-in memory. You can choose anything from a 16 GB "
"card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to "
"that). We recommend 256 GB."
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:43
#, markdown-text, no-wrap
msgid ""
"| Use Case | Suggested micro SD Size |\n"
"| ------------------------------------- | -------------------------- |\n"
"| Basic setup (apps + message board) | 16 GB – 32 GB |\n"
"| Additional content or media storage | 64 GB – 128 GB |\n"
"| Handling large content packs or files | 256 GB or more, up to 1 TB |\n"
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:46
#, markdown-text, no-wrap
msgid "Can I customize it?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:49
#, markdown-text
msgid ""
"Absolutely! You can add, for example, your own content - dropping in PDFs, "
"videos, images, and HTML pages to build a local library, or add your own "
"apps - including Android APKs (even if they’re not on F-Droid)."
msgstr ""
#. type: Title ###
#: docs/faq/index.mdx:52
#, markdown-text, no-wrap
msgid ""
"My USB drive is plugged into the Butter Box, but the content is not "
"displayed on the portal. Why?"
msgstr ""
#. type: Plain text
#: docs/faq/index.mdx:54
#, markdown-text
msgid ""
"Yout USB drive is probably in the wrong format. Your USB needs to be "
"formatted to ExFat, Fat32, MS-DOS (FAT). Refer to [Reformatting Your "
"USB](how-to-reformat-your-usb-drive) for help."
msgstr ""
#. type: Title #
#: docs/services/file-sharing.mdx:4
#, markdown-text, no-wrap
msgid "File Sharing"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:7
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/media-type-explore.png\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Title ##
#: docs/services/file-sharing.mdx:8
#, markdown-text, no-wrap
msgid "Share Media, Files and Digital Books"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:11
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:13
#, markdown-text
msgid ""
"If you’d 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."
msgstr ""
#. type: Title ###
#: docs/services/file-sharing.mdx:16
#, markdown-text, no-wrap
msgid "Add files to your USB Drive"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:19
#, markdown-text
msgid ""
"Place individual files directly in the **main directory** (root) of your USB "
"drive. Or, create folders to organize your files (eg. \"Books\", \"Music\", "
"\"Reports)"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:21
#, markdown-text, no-wrap
msgid ""
"<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>\n"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:23
#, markdown-text, no-wrap
msgid "**Things to Know**\n"
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:26
#, markdown-text
msgid ""
"The **folder names you use** on your USB drive will be shown in the Butter "
"Box portal."
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:26
#, markdown-text
msgid ""
"Organizing content into folders makes it easier for others to browse and "
"download."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:30
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:32
#, markdown-text, no-wrap
msgid ""
"<div><figure><img src=\"/img/docs/Screenshot_20260414-122810 (1).png\" "
"alt=\"\"/><figcaption></figcaption></figure> <figure><img "
"src=\"/img/docs/Screenshot_20260414-122821 (1).png\" "
"alt=\"\"/><figcaption></figcaption></figure></div>\n"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:36
#, markdown-text, no-wrap
msgid "**Troubleshooting**\n"
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:38
#, markdown-text
msgid "If you don’t see the **Files** tile, try the following actions:"
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:42
#, markdown-text
msgid "Remove the USB drive from the Butter Box. Then re-insert the USB drive."
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:42
#, markdown-text
msgid "Turn on/off airplane mode. Reconnect Butter Box wifi."
msgstr ""
#. type: Bullet: '* '
#: docs/services/file-sharing.mdx:42
#, markdown-text
msgid "Refresh the browser page."
msgstr ""
#. type: Plain text
#: docs/services/file-sharing.mdx:44
#, markdown-text
msgid ""
"If you are still having trouble you may need to [Reformat Your USB "
"Drive](../faq/how-to-reformat-your-usb-drive)."
msgstr ""
#. type: Title #
#: docs/services/index.mdx:4
#, markdown-text, no-wrap
msgid "Features"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/services/local-chat.mdx:1
#, no-wrap
msgid "A place for anyone connected to the box to share"
msgstr ""
#. type: Title #
#: docs/services/local-chat.mdx:6
#, markdown-text, no-wrap
msgid "Local Chat"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:9
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:11
#, markdown-text
msgid "First, let's look at what you can and can't do with this local chat."
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:13
#, markdown-text, no-wrap
msgid "✅ **You Can**<br/>\n"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:16
#, markdown-text
msgid ""
"Host videos up to 5 GB PDFs, images, record, audio messages, share "
"pre-recorded audio messages or music"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:16
#, markdown-text
msgid ""
"Download the full chat or any individual piece of content or media that "
"people have shared"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:18
#, markdown-text, no-wrap
msgid "❌ **You Cannot**<br/>\n"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:22
#, markdown-text
msgid "Use the chat to talk with people who are not connected to the Butter Box"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:22
#, markdown-text
msgid "Get notifications when there are new posts or messages"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:22
#, markdown-text
msgid "See the messages unless you are connected to the Butter Box"
msgstr ""
#. type: Title ##
#: docs/services/local-chat.mdx:25
#, markdown-text, no-wrap
msgid "Moderation"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:28
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:29
#, markdown-text, no-wrap
msgid "Become the Admin"
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:31
#, markdown-text, no-wrap
msgid "Logout as Guest"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:34
#, markdown-text
msgid ""
"When you open the local chat, you are assigned a guest identity. First "
"logout of the account that was created for you."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:35
#, markdown-text, no-wrap
msgid "Login as Admin"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:38
#, markdown-text
msgid ""
"Login to the `butterbox-admin` account. Username and password are both "
"`butterbox-admin`."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:39
#, markdown-text, no-wrap
msgid "Change Admin Password"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:42
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:43
#, markdown-text, no-wrap
msgid "Moderation Features"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:46
#, markdown-text
msgid "Once you are an admin, you have access to the following features:"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid "**Set a message timer**"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid "**Delete messages**"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid "**Promote members to moderator or admin**"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid "**Kick members out.**"
msgstr ""
#. type: Bullet: ' * '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid ""
"Keep in mind that someone can simply rejoin as a new guest if they reconnect "
"to the box"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid "**Delete the room.**"
msgstr ""
#. type: Bullet: ' * '
#: docs/services/local-chat.mdx:54
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Title ##
#: docs/services/local-chat.mdx:57
#, markdown-text, no-wrap
msgid "Say Even More—Direct Messages and Private Rooms"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:60
#, markdown-text
msgid ""
"In addition to the local chat, you can create any number of private rooms "
"from the same interface."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:61
#, markdown-text, no-wrap
msgid "Things To Know"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:67
#, markdown-text
msgid "Each room will have it's own QR code."
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:67
#, markdown-text
msgid "Private rooms are not discoverable from the Butter Box portal."
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:67
#, markdown-text
msgid ""
"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.**"
msgstr ""
#. type: Bullet: '* '
#: docs/services/local-chat.mdx:67
#, markdown-text
msgid ""
"Every private chat that you are part of, will be easy for **you** to "
"find. They will all show up in your room list."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:68
#, markdown-text, no-wrap
msgid "Instructions"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:71
#, markdown-text
msgid ""
"You can create a private room from two different places in the message board "
"interface."
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:72
#, markdown-text, no-wrap
msgid "Open from Avatar Modal"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:75
#, markdown-text
msgid "Tap on your avatar in the top bar. Select **new room.**"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:78
#, markdown-text, no-wrap
msgid ""
"| <img src=\"/img/docs/image.png\" alt=\"\" data-size=\"original\"/> | |\n"
"| -------------------------------------------------------------------- | - "
"|\n"
msgstr ""
#. type: Title ###
#: docs/services/local-chat.mdx:81
#, markdown-text, no-wrap
msgid "Open from Room List"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:84
#, markdown-text
msgid ""
"Your room list is accessible from your profile page. Once here, select **new "
"room.**"
msgstr ""
#. type: Plain text
#: docs/services/local-chat.mdx:86
#, markdown-text, no-wrap
msgid ""
"<figure><img src=\"/img/docs/Screenshot 2026-01-20 at 1.42.17 PM.png\" "
"alt=\"\"/><figcaption></figcaption></figure>\n"
msgstr ""
#. type: Yaml Front Matter Hash Value: description
#: docs/services/secure-messenger.mdx:1
#, no-wrap
msgid "Using Delta Chat with a Butter Box"
msgstr ""
#. type: Title #
#: docs/services/secure-messenger.mdx:6
#, markdown-text, no-wrap
msgid "Private Messenger"
msgstr ""
#. type: Plain text
#: docs/services/secure-messenger.mdx:9
#, markdown-text
msgid ""
"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."
msgstr ""
#. type: Plain text
#: docs/services/secure-messenger.mdx:11
#, markdown-text
msgid ""
"Think of the Butter Box like a local post office. Whenever you connect to "
"the Box’s network, your Delta Chat app can send outgoing messages and sync "
"to receive any new ones waiting for you."
msgstr ""
Reference in a new issue View git blame Copy permalink