# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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) | ![]() |\n" msgstr "" #. type: Title #### #: docs/security.mdx:43 #, markdown-text, no-wrap msgid "![]()" 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" "| ![]() | ![]() |\n" msgstr "" #. type: Title #### #: docs/security.mdx:65 #, markdown-text, no-wrap msgid "![]()" 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" "| ![]() | ![]() |\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.
" 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 "
\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 "" "
\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 "" "
\"\"
\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 "" "
\"\"
\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 "" "
\"\"
\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" "|

Basic

Raspberry Pi Zero Pi 2

Get Started

| Up to 10 " "people, About 10 meters apart | [Supply " "List](raspberry-pi/basic-box-supplies) |\n" "|

Extended

Raspberry Pi 4 + Router

Get Started

| 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 "" "
\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 "" "
\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 "" "
\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 "" "
\"\"

Example adapter (USB-C to Micro " "SD)

\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 "" "

Select Raspberry Pi Zero 2 W (or the device you " "have if it's not the standard box from Butter " "HQ)

\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 "" "

Select Use Custom. You will upload the custom .img " "file that you downloaded from Dropbox.

\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 "" "

Select the Micro SD " "Card.

\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 "" "

Final screen after " "selections.

\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 "" "
\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 "" "

USB directory when viewed in Finder on " "desktop

\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 "" "

USB directory when viewed in Finder on " "desktop

\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)
\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.
\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
" 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.
" msgstr "" #. type: Plain text #: docs/faq/how-to-reformat-your-usb-drive.mdx:52 #, markdown-text, no-wrap msgid "" "![]()![]()![]()\n" msgstr "" #. type: Plain text #: docs/faq/how-to-reformat-your-usb-drive.mdx:54 #, markdown-text, no-wrap msgid "![]()\n" msgstr "" #. type: Plain text #: docs/faq/how-to-reformat-your-usb-drive.mdx:56 #, markdown-text, no-wrap msgid "![]()\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 "" "
\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 "" "

USB directory when viewed in Finder on " "desktop

\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 "" "
\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**
\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**
\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 "" "| \"\" | |\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 "" "
\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 ""